From a80ec7bd980b9d93e0e762070b07124d444332b3 Mon Sep 17 00:00:00 2001 From: Vanessa Yuen <6842965+vanessayuenn@users.noreply.github.com> Date: Tue, 5 Jan 2021 20:37:31 +0100 Subject: [PATCH] Crowdin translations (#17143) * New Crowdin translations by Github Action * Revert broken translated files to english * fix dates * fix translation :sob: Co-authored-by: Crowdin Bot --- .../creating-a-composite-run-steps-action.md | 44 +- .../metadata-syntax-for-github-actions.md | 30 +- .../guides/about-continuous-integration.md | 2 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../de-DE/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/de-DE/content/actions/index.md | 12 +- .../finding-and-customizing-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 6 +- .../actions/reference/encrypted-secrets.md | 49 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 18 +- .../de-DE/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 63 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- .../keyboard-shortcuts.md | 2 + .../developers/apps/authorizing-oauth-apps.md | 4 +- ...ating-a-github-app-using-url-parameters.md | 44 +- ...nces-between-github-apps-and-oauth-apps.md | 2 +- ...g-and-authorizing-users-for-github-apps.md | 2 +- .../suspending-a-github-app-installation.md | 2 - .../apps/using-content-attachments.md | 2 +- .../creating-apps-for-github-marketplace.md | 1 - ...icing-plans-for-github-marketplace-apps.md | 2 +- .../receiving-payment-for-app-purchases.md | 12 +- .../requirements-for-listing-an-app.md | 2 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/issue-event-types.md | 2 +- .../securing-your-webhooks.md | 2 +- .../webhook-events-and-payloads.md | 6 +- .../leave-feedback-with-pull-requests.md | 2 +- .../apply-for-a-student-developer-pack.md | 2 +- .../about-protected-branches.md | 8 +- .../configuring-pull-request-merges.md | 2 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../setting-repository-visibility.md | 2 +- .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 4 +- .../testing-your-ssh-connection.md | 2 +- .../automatically-merging-a-pull-request.md | 38 + .../creating-a-pull-request-from-a-fork.md | 2 +- .../index.md | 1 + .../merging-a-pull-request.md | 6 +- .../configuring-code-scanning.md | 2 +- ...-codeql-code-scanning-in-your-ci-system.md | 4 +- .../managing-your-subscriptions.md | 2 +- .../watching-and-unwatching-repositories.md | 2 +- .../searching-code.md | 7 +- .../permission-levels-for-an-organization.md | 5 +- ...y-permission-levels-for-an-organization.md | 3 +- ...ail-notifications-to-an-approved-domain.md | 10 +- .../verifying-your-organizations-domain.md | 32 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + ...on-levels-for-a-user-account-repository.md | 34 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 22 +- .../github-subprocessors-and-cookies.md | 73 +- ...delines-for-legal-requests-of-user-data.md | 2 - ...loring-the-dependencies-of-a-repository.md | 30 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 8 +- .../graphql/overview/resource-limitations.md | 8 +- .../de-DE/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 1 + .../content/graphql/reference/scalars.md | 1 + .../de-DE/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../installing-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/de-DE/content/packages/index.md | 16 +- .../de-DE/content/rest/overview/libraries.md | 1 + .../overview/resources-in-the-rest-api.md | 23 +- .../rest/reference/enterprise-admin.md | 2 +- .../permissions-required-for-github-apps.md | 6 +- .../de-DE/data/release-notes/2-20/23.yml | 13 + .../de-DE/data/release-notes/2-21/14.yml | 13 + .../de-DE/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../actions/creating-actions/about-actions.md | 2 +- .../creating-a-composite-run-steps-action.md | 86 +- .../metadata-syntax-for-github-actions.md | 16 +- .../guides/about-continuous-integration.md | 2 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../ja-JP/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/ja-JP/content/actions/index.md | 12 +- .../finding-and-customizing-actions.md | 2 +- .../introduction-to-github-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...grating-from-circleci-to-github-actions.md | 2 +- ...ting-from-gitlab-cicd-to-github-actions.md | 2 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 2 - .../actions/reference/encrypted-secrets.md | 44 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 20 +- .../ja-JP/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 63 +- .../configuration/command-line-utilities.md | 2 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- .../keyboard-shortcuts.md | 2 + .../developers/apps/authorizing-oauth-apps.md | 6 +- ...ating-a-github-app-using-url-parameters.md | 44 +- .../creating-ci-tests-with-the-checks-api.md | 6 +- ...nces-between-github-apps-and-oauth-apps.md | 102 +- .../apps/editing-a-github-apps-permissions.md | 16 +- ...g-and-authorizing-users-for-github-apps.md | 1162 ++++++++--------- ...ment-environment-to-create-a-github-app.md | 108 +- .../suspending-a-github-app-installation.md | 16 +- .../transferring-ownership-of-a-github-app.md | 12 +- .../transferring-ownership-of-an-oauth-app.md | 10 +- ...leshooting-authorization-request-errors.md | 20 +- ...g-oauth-app-access-token-request-errors.md | 22 +- .../apps/using-content-attachments.md | 90 +- .../apps/using-the-github-api-in-your-app.md | 160 +-- .../about-github-marketplace.md | 38 +- .../about-verified-creators.md | 38 +- .../github-marketplace/billing-customers.md | 12 +- .../creating-apps-for-github-marketplace.md | 1 - ...omer-experience-best-practices-for-apps.md | 20 +- .../drafting-a-listing-for-your-app.md | 4 +- .../handling-new-purchases-and-free-trials.md | 2 +- ...icing-plans-for-github-marketplace-apps.md | 26 +- .../receiving-payment-for-app-purchases.md | 12 +- .../requirements-for-listing-an-app.md | 50 +- .../security-best-practices-for-apps.md | 38 +- .../setting-pricing-plans-for-your-listing.md | 40 +- ...submitting-your-listing-for-publication.md | 26 +- .../github-marketplace/testing-your-app.md | 4 +- .../ja-JP/content/developers/index.md | 4 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/issue-event-types.md | 2 +- .../securing-your-webhooks.md | 2 +- .../webhook-events-and-payloads.md | 26 +- .../about-discussions.md | 44 +- ...ting-with-maintainers-using-discussions.md | 38 +- .../index.md | 6 +- .../participating-in-a-discussion.md | 22 +- ...s-for-community-conversations-on-github.md | 36 +- ...iscussions-across-multiple-repositories.md | 12 +- ...-higher-permissions-to-top-contributors.md | 24 +- .../ja-JP/content/discussions/guides/index.md | 8 +- .../ja-JP/content/discussions/index.md | 10 +- .../index.md | 6 +- ...ries-for-discussions-in-your-repository.md | 54 +- ...managing-discussions-in-your-repository.md | 78 +- .../moderating-discussions.md | 36 +- .../ja-JP/content/discussions/quickstart.md | 46 +- ...g-makecode-arcade-with-github-classroom.md | 24 +- ...bout-using-replit-with-github-classroom.md | 26 +- .../basics-of-setting-up-github-classroom.md | 36 +- ...lt-settings-for-assignment-repositories.md | 4 +- ...ate-github-classroom-with-an-online-ide.md | 2 +- .../leave-feedback-with-pull-requests.md | 2 +- .../apply-for-a-student-developer-pack.md | 2 +- .../about-dependabot-version-updates.md | 12 +- ...fications-for-pushes-to-your-repository.md | 2 +- .../about-protected-branches.md | 6 +- .../about-releases.md | 8 +- .../configuring-pull-request-merges.md | 2 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../managing-releases-in-a-repository.md | 2 +- .../setting-repository-visibility.md | 2 +- ...sh-key-for-use-with-saml-single-sign-on.md | 2 +- .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 4 +- .../testing-your-ssh-connection.md | 2 +- .../about-pull-request-reviews.md | 2 +- .../automatically-merging-a-pull-request.md | 38 + .../creating-a-pull-request-from-a-fork.md | 2 +- ...eleting-branches-within-your-repository.md | 4 +- .../filtering-files-in-a-pull-request.md | 4 +- ...rporating-feedback-in-your-pull-request.md | 2 +- .../index.md | 1 + .../merging-a-pull-request.md | 14 +- ...g-an-upstream-repository-into-your-fork.md | 2 +- .../requesting-a-pull-request-review.md | 2 +- .../resolving-a-merge-conflict-on-github.md | 14 +- ...ng-dependency-changes-in-a-pull-request.md | 68 +- ...wing-proposed-changes-in-a-pull-request.md | 10 +- .../syncing-a-fork.md | 6 +- ...sitory-is-deleted-or-changes-visibility.md | 10 +- .../configuring-code-scanning.md | 2 +- ...-codeql-code-scanning-in-your-ci-system.md | 4 +- .../keyboard-shortcuts.md | 2 +- .../signing-up-for-a-new-github-account.md | 2 +- .../about-managing-vulnerable-dependencies.md | 2 +- ...configuring-dependabot-security-updates.md | 2 +- ...nerable-dependencies-in-your-repository.md | 2 +- .../configuring-notifications.md | 160 +-- .../managing-notifications-from-your-inbox.md | 72 +- .../managing-your-subscriptions.md | 2 +- .../viewing-your-subscriptions.md | 54 +- .../watching-and-unwatching-repositories.md | 2 +- .../searching-code.md | 3 +- .../permission-levels-for-an-organization.md | 1 + ...y-permission-levels-for-an-organization.md | 3 +- ...ail-notifications-to-an-approved-domain.md | 10 +- .../verifying-your-organizations-domain.md | 28 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + ...on-levels-for-a-user-account-repository.md | 34 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 54 +- .../github-subprocessors-and-cookies.md | 73 +- ...delines-for-legal-requests-of-user-data.md | 2 - ...loring-the-dependencies-of-a-repository.md | 30 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 6 +- translations/ja-JP/content/graphql/README.md | 10 +- .../guides/managing-enterprise-accounts.md | 2 +- .../guides/migrating-from-rest-to-graphql.md | 14 +- .../graphql/guides/using-global-node-ids.md | 8 +- .../graphql/overview/resource-limitations.md | 16 +- .../ja-JP/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 3 +- .../content/graphql/reference/scalars.md | 1 + .../ja-JP/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../about-github-insights.md | 2 +- ...n-github-insights-and-github-enterprise.md | 4 +- ...n-github-insights-and-github-enterprise.md | 6 +- .../installing-github-insights.md | 4 +- .../managing-contributors-and-teams.md | 2 +- ...managing-permissions-in-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/ja-JP/content/packages/index.md | 16 +- .../publishing-a-package.md | 2 +- translations/ja-JP/content/rest/README.md | 10 +- .../rest/guides/basics-of-authentication.md | 20 +- .../guides/best-practices-for-integrators.md | 6 +- .../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 | 8 +- .../rest/guides/rendering-data-as-graphs.md | 6 +- .../rest/guides/working-with-comments.md | 6 +- .../ja-JP/content/rest/overview/libraries.md | 35 +- .../content/rest/overview/media-types.md | 8 +- .../rest/overview/openapi-description.md | 26 +- .../overview/other-authentication-methods.md | 18 +- .../overview/resources-in-the-rest-api.md | 63 +- .../content/rest/overview/troubleshooting.md | 22 +- .../ja-JP/content/rest/reference/actions.md | 4 +- .../ja-JP/content/rest/reference/activity.md | 2 +- .../ja-JP/content/rest/reference/apps.md | 4 +- .../content/rest/reference/code-scanning.md | 2 +- .../rest/reference/enterprise-admin.md | 24 +- .../ja-JP/content/rest/reference/gists.md | 2 +- .../content/rest/reference/interactions.md | 26 +- .../ja-JP/content/rest/reference/licenses.md | 4 +- .../ja-JP/content/rest/reference/orgs.md | 2 +- .../permissions-required-for-github-apps.md | 8 +- .../ja-JP/content/rest/reference/pulls.md | 2 +- .../ja-JP/content/rest/reference/repos.md | 8 +- .../ja-JP/content/rest/reference/search.md | 8 +- .../content/rest/reference/secret-scanning.md | 2 +- .../ja-JP/content/rest/reference/teams.md | 2 +- .../ja-JP/content/rest/reference/users.md | 2 +- .../ja-JP/data/release-notes/2-20/23.yml | 13 + .../ja-JP/data/release-notes/2-21/14.yml | 13 + .../ja-JP/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../discussions/click-discussion-in-list.md | 2 +- .../discussions/edit-category-details.md | 2 +- .../marking-a-comment-as-an-answer.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../metadata-syntax-for-github-actions.md | 16 +- .../guides/about-continuous-integration.md | 2 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../ko-KR/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/ko-KR/content/actions/index.md | 12 +- .../finding-and-customizing-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 2 - .../actions/reference/encrypted-secrets.md | 43 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 16 +- .../ko-KR/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 63 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- .../keyboard-shortcuts.md | 2 + .../developers/apps/authorizing-oauth-apps.md | 4 +- ...ating-a-github-app-using-url-parameters.md | 44 +- ...nces-between-github-apps-and-oauth-apps.md | 2 +- ...g-and-authorizing-users-for-github-apps.md | 2 +- .../suspending-a-github-app-installation.md | 2 - .../apps/using-content-attachments.md | 2 +- .../creating-apps-for-github-marketplace.md | 1 - ...icing-plans-for-github-marketplace-apps.md | 2 +- .../receiving-payment-for-app-purchases.md | 12 +- .../requirements-for-listing-an-app.md | 2 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/issue-event-types.md | 2 +- .../securing-your-webhooks.md | 2 +- .../webhook-events-and-payloads.md | 6 +- .../leave-feedback-with-pull-requests.md | 2 +- .../apply-for-a-student-developer-pack.md | 2 +- .../about-protected-branches.md | 4 + .../configuring-pull-request-merges.md | 2 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../setting-repository-visibility.md | 2 +- .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 2 +- .../testing-your-ssh-connection.md | 2 +- .../automatically-merging-a-pull-request.md | 38 + .../creating-a-pull-request-from-a-fork.md | 2 +- .../index.md | 1 + .../merging-a-pull-request.md | 2 + .../configuring-code-scanning.md | 2 +- ...-codeql-code-scanning-in-your-ci-system.md | 4 +- .../managing-your-subscriptions.md | 2 +- .../watching-and-unwatching-repositories.md | 2 +- .../searching-code.md | 3 +- .../permission-levels-for-an-organization.md | 1 + ...y-permission-levels-for-an-organization.md | 3 +- ...ail-notifications-to-an-approved-domain.md | 10 +- .../verifying-your-organizations-domain.md | 28 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + ...on-levels-for-a-user-account-repository.md | 34 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 54 +- .../github-subprocessors-and-cookies.md | 73 +- ...delines-for-legal-requests-of-user-data.md | 2 - ...loring-the-dependencies-of-a-repository.md | 30 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 6 +- .../graphql/overview/resource-limitations.md | 8 +- .../ko-KR/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 1 + .../content/graphql/reference/scalars.md | 1 + .../ko-KR/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../installing-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/ko-KR/content/packages/index.md | 16 +- .../ko-KR/content/rest/overview/libraries.md | 1 + .../overview/resources-in-the-rest-api.md | 23 +- .../rest/reference/enterprise-admin.md | 2 +- .../permissions-required-for-github-apps.md | 6 +- .../ko-KR/data/release-notes/2-20/23.yml | 13 + .../ko-KR/data/release-notes/2-21/14.yml | 13 + .../ko-KR/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../creating-a-javascript-action.md | 2 +- .../metadata-syntax-for-github-actions.md | 16 +- .../guides/about-continuous-integration.md | 2 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../pt-BR/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/pt-BR/content/actions/index.md | 34 +- .../finding-and-customizing-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 2 - .../actions/reference/encrypted-secrets.md | 43 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 16 +- .../pt-BR/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 63 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- ...naging-organizations-in-your-enterprise.md | 2 +- .../keyboard-shortcuts.md | 58 +- .../developers/apps/authorizing-oauth-apps.md | 4 +- ...ating-a-github-app-using-url-parameters.md | 48 +- ...nces-between-github-apps-and-oauth-apps.md | 2 +- ...g-and-authorizing-users-for-github-apps.md | 2 +- .../developers/apps/scopes-for-oauth-apps.md | 127 +- .../suspending-a-github-app-installation.md | 2 - .../apps/using-content-attachments.md | 2 +- .../github-marketplace/billing-customers.md | 2 +- .../creating-apps-for-github-marketplace.md | 1 - ...icing-plans-for-github-marketplace-apps.md | 2 +- .../receiving-payment-for-app-purchases.md | 12 +- .../requirements-for-listing-an-app.md | 6 +- .../setting-pricing-plans-for-your-listing.md | 14 +- ...submitting-your-listing-for-publication.md | 10 +- .../github-marketplace/testing-your-app.md | 2 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/issue-event-types.md | 2 +- .../securing-your-webhooks.md | 2 +- .../webhook-events-and-payloads.md | 6 +- .../about-discussions.md | 32 +- ...ting-with-maintainers-using-discussions.md | 38 +- .../index.md | 6 +- .../participating-in-a-discussion.md | 22 +- ...s-for-community-conversations-on-github.md | 36 +- ...iscussions-across-multiple-repositories.md | 16 +- ...-higher-permissions-to-top-contributors.md | 24 +- .../pt-BR/content/discussions/guides/index.md | 8 +- .../pt-BR/content/discussions/index.md | 10 +- .../index.md | 6 +- ...ries-for-discussions-in-your-repository.md | 55 +- ...managing-discussions-in-your-repository.md | 78 +- .../moderating-discussions.md | 36 +- .../pt-BR/content/discussions/quickstart.md | 46 +- .../pt-BR/content/education/guides.md | 50 +- translations/pt-BR/content/education/index.md | 20 +- ...g-makecode-arcade-with-github-classroom.md | 24 +- ...bout-using-replit-with-github-classroom.md | 26 +- .../basics-of-setting-up-github-classroom.md | 36 +- ...lt-settings-for-assignment-repositories.md | 42 +- ...g-management-system-to-github-classroom.md | 204 +-- .../create-a-group-assignment.md | 100 +- ...n-assignment-from-a-template-repository.md | 14 +- .../create-an-individual-assignment.md | 80 +- .../get-started-with-github-classroom.md | 4 +- .../glossary.md | 26 +- .../index.md | 4 +- .../integrate-github-classroom-with-an-ide.md | 6 +- ...ate-github-classroom-with-an-online-ide.md | 38 +- .../learn-with-github-classroom.md | 4 +- .../leave-feedback-with-pull-requests.md | 22 +- .../manage-classrooms.md | 90 +- .../run-student-code-in-an-online-ide.md | 14 +- .../teach-with-github-classroom.md | 4 +- .../use-autograding.md | 88 +- .../view-autograding-results.md | 22 +- .../pt-BR/content/education/quickstart.md | 56 +- .../about-github-education-for-students.md | 4 +- .../about-github-education.md | 4 +- .../apply-for-a-student-developer-pack.md | 4 +- ...-for-an-educator-or-researcher-discount.md | 4 +- .../index.md | 6 +- ...-github-at-your-educational-institution.md | 2 +- .../use-github-for-your-schoolwork.md | 2 +- ...e-github-in-your-classroom-and-research.md | 2 +- ...n-for-a-student-developer-pack-approved.md | 4 +- ...ducator-or-researcher-discount-approved.md | 2 +- .../about-dependabot-version-updates.md | 2 +- .../about-protected-branches.md | 4 + .../about-secret-scanning.md | 2 +- ...guration-options-for-dependency-updates.md | 2 +- .../configuring-pull-request-merges.md | 2 +- ...g-your-repositorys-social-media-preview.md | 2 +- .../deleting-a-repository.md | 6 +- .../enabling-and-disabling-version-updates.md | 2 +- ...ing-github-discussions-for-a-repository.md | 14 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../managing-releases-in-a-repository.md | 2 +- .../managing-repository-settings.md | 2 +- .../setting-repository-visibility.md | 18 +- ...ng-a-new-ssh-key-to-your-github-account.md | 12 +- .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- .../creating-a-strong-password.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 8 +- ...moving-sensitive-data-from-a-repository.md | 2 +- .../reviewing-your-ssh-keys.md | 55 +- .../testing-your-ssh-connection.md | 2 +- .../about-issue-and-pull-request-templates.md | 2 +- .../about-wikis.md | 24 +- ...dding-support-resources-to-your-project.md | 2 +- ...-guidelines-for-repository-contributors.md | 2 +- .../about-branches.md | 4 +- .../automatically-merging-a-pull-request.md | 38 + .../creating-a-pull-request-from-a-fork.md | 2 +- ...eleting-branches-within-your-repository.md | 2 +- .../index.md | 1 + .../merging-a-pull-request.md | 2 + ...ng-dependency-changes-in-a-pull-request.md | 68 +- ...wing-proposed-changes-in-a-pull-request.md | 8 +- ...sitory-is-deleted-or-changes-visibility.md | 10 +- .../about-code-owners.md | 12 +- .../about-readmes.md | 4 +- .../about-repositories.md | 10 +- .../licensing-a-repository.md | 2 +- .../about-github-marketplace.md | 12 +- ...configuring-codespaces-for-your-project.md | 2 +- .../using-codespaces-in-visual-studio.md | 8 +- .../configuring-code-scanning.md | 18 +- ...-codeql-code-scanning-in-your-ci-system.md | 4 +- .../create-a-repo.md | 2 +- .../fork-a-repo.md | 2 +- .../signing-up-for-a-new-github-account.md | 2 +- .../about-managing-vulnerable-dependencies.md | 20 +- ...tifications-for-vulnerable-dependencies.md | 46 +- .../troubleshooting-dependabot-errors.md | 6 +- ...nerable-dependencies-in-your-repository.md | 2 +- .../about-notifications.md | 2 +- .../configuring-notifications.md | 26 +- .../managing-your-subscriptions.md | 4 +- .../viewing-your-subscriptions.md | 16 +- .../creating-an-issue.md | 2 +- .../managing-labels.md | 51 +- ...your-work-with-issues-and-pull-requests.md | 2 +- .../opening-an-issue-from-a-comment.md | 2 +- .../opening-an-issue-from-code.md | 2 +- ...sferring-an-issue-to-another-repository.md | 2 +- ...arch-to-filter-issues-and-pull-requests.md | 2 +- .../watching-and-unwatching-repositories.md | 2 +- .../about-searching-on-github.md | 6 +- .../searching-code.md | 5 +- .../searching-commits.md | 6 +- .../searching-discussions.md | 64 +- .../searching-for-repositories.md | 62 +- .../searching-issues-and-pull-requests.md | 44 +- .../searching-topics.md | 2 +- .../about-billing-for-github-actions.md | 4 +- .../about-billing-for-github-packages.md | 4 +- ...unted-subscriptions-for-github-accounts.md | 4 +- .../downgrading-a-sponsorship.md | 4 +- ...-your-spending-limit-for-github-actions.md | 6 +- ...your-spending-limit-for-github-packages.md | 6 +- .../upgrading-a-sponsorship.md | 2 +- .../deleting-an-organization-account.md | 2 +- ...cess-restrictions-for-your-organization.md | 2 +- ...n-for-repositories-in-your-organization.md | 18 +- ...analysis-settings-for-your-organization.md | 24 +- ...he-forking-policy-for-your-organization.md | 21 +- ...rom-accounts-your-organization-sponsors.md | 14 +- .../permission-levels-for-an-organization.md | 7 +- ...y-permission-levels-for-an-organization.md | 23 +- ...ail-notifications-to-an-approved-domain.md | 10 +- ...visibility-changes-in-your-organization.md | 2 +- .../verifying-your-organizations-domain.md | 28 +- .../about-enterprise-accounts.md | 2 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + .../about-your-profile.md | 28 +- .../personalizing-your-profile.md | 2 +- ...r-private-contributions-on-your-profile.md | 2 +- .../viewing-contributions-on-your-profile.md | 83 +- .../about-your-personal-dashboard.md | 44 +- ...rating-jira-with-your-personal-projects.md | 2 +- .../managing-your-theme-settings.md | 12 +- ...on-levels-for-a-user-account-repository.md | 60 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 54 +- .../github-subprocessors-and-cookies.md | 35 +- ...delines-for-legal-requests-of-user-data.md | 2 - .../about-github-sponsors.md | 2 +- ...uting-sponsorships-to-your-organization.md | 16 +- ...ks-for-events-in-your-sponsored-account.md | 6 +- .../contacting-your-sponsors.md | 4 +- ...our-profile-details-for-github-sponsors.md | 4 +- ...aging-your-payouts-from-github-sponsors.md | 2 +- .../managing-your-sponsorship-goal.md | 6 +- .../managing-your-sponsorship.md | 10 +- .../viewing-your-sponsors-and-sponsorships.md | 4 +- ...loring-the-dependencies-of-a-repository.md | 30 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 6 +- .../graphql/overview/resource-limitations.md | 8 +- .../pt-BR/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 1 + .../content/graphql/reference/scalars.md | 1 + .../pt-BR/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../installing-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/pt-BR/content/packages/index.md | 18 +- .../pt-BR/content/rest/overview/libraries.md | 1 + .../overview/resources-in-the-rest-api.md | 9 +- .../rest/reference/enterprise-admin.md | 2 +- .../permissions-required-for-github-apps.md | 6 +- .../pt-BR/data/release-notes/2-20/23.yml | 13 + .../pt-BR/data/release-notes/2-21/14.yml | 13 + .../pt-BR/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../assignments-classroom-prerequisite.md | 2 +- .../classroom/click-classroom-in-list.md | 2 +- ...e-information-about-assignment-creation.md | 2 +- .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../discussions/click-discussion-in-list.md | 2 +- .../discussions/edit-category-details.md | 2 +- .../marking-a-comment-as-an-answer.md | 2 +- .../reusables/education/apply-for-team.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../data/reusables/profile/profile-readme.md | 2 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../pt-BR/data/reusables/search/date_gt_lt.md | 2 +- .../metadata-syntax-for-github-actions.md | 16 +- .../guides/about-continuous-integration.md | 2 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../ru-RU/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/ru-RU/content/actions/index.md | 12 +- .../finding-and-customizing-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 2 - .../actions/reference/encrypted-secrets.md | 43 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 16 +- .../ru-RU/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 63 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- .../keyboard-shortcuts.md | 2 + .../developers/apps/authorizing-oauth-apps.md | 4 +- ...ating-a-github-app-using-url-parameters.md | 44 +- ...nces-between-github-apps-and-oauth-apps.md | 2 +- ...g-and-authorizing-users-for-github-apps.md | 2 +- .../suspending-a-github-app-installation.md | 2 - .../apps/using-content-attachments.md | 2 +- .../creating-apps-for-github-marketplace.md | 1 - ...icing-plans-for-github-marketplace-apps.md | 2 +- .../receiving-payment-for-app-purchases.md | 12 +- .../requirements-for-listing-an-app.md | 2 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/issue-event-types.md | 2 +- .../securing-your-webhooks.md | 2 +- .../webhook-events-and-payloads.md | 6 +- .../leave-feedback-with-pull-requests.md | 2 +- .../apply-for-a-student-developer-pack.md | 2 +- .../about-protected-branches.md | 4 + .../configuring-pull-request-merges.md | 2 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../setting-repository-visibility.md | 2 +- .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 2 +- .../testing-your-ssh-connection.md | 2 +- .../automatically-merging-a-pull-request.md | 38 + .../creating-a-pull-request-from-a-fork.md | 2 +- .../index.md | 1 + .../merging-a-pull-request.md | 2 + .../configuring-code-scanning.md | 2 +- ...-codeql-code-scanning-in-your-ci-system.md | 4 +- .../managing-your-subscriptions.md | 2 +- .../watching-and-unwatching-repositories.md | 2 +- .../searching-code.md | 3 +- .../permission-levels-for-an-organization.md | 1 + ...y-permission-levels-for-an-organization.md | 3 +- ...ail-notifications-to-an-approved-domain.md | 10 +- .../verifying-your-organizations-domain.md | 28 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + ...on-levels-for-a-user-account-repository.md | 34 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 54 +- .../github-subprocessors-and-cookies.md | 73 +- ...delines-for-legal-requests-of-user-data.md | 2 - ...loring-the-dependencies-of-a-repository.md | 30 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 6 +- .../graphql/overview/resource-limitations.md | 8 +- .../ru-RU/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 1 + .../content/graphql/reference/scalars.md | 1 + .../ru-RU/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../installing-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/ru-RU/content/packages/index.md | 16 +- .../ru-RU/content/rest/overview/libraries.md | 1 + .../overview/resources-in-the-rest-api.md | 23 +- .../rest/reference/enterprise-admin.md | 2 +- .../permissions-required-for-github-apps.md | 6 +- .../ru-RU/data/release-notes/2-20/23.yml | 13 + .../ru-RU/data/release-notes/2-21/14.yml | 13 + .../ru-RU/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../creating-a-javascript-action.md | 2 +- .../metadata-syntax-for-github-actions.md | 16 +- .../guides/building-and-testing-nodejs.md | 4 +- .../guides/building-and-testing-powershell.md | 2 +- .../guides/building-and-testing-python.md | 2 +- ...ing-to-amazon-elastic-container-service.md | 148 +++ .../guides/deploying-to-azure-app-service.md | 115 ++ .../deploying-to-google-kubernetes-engine.md | 177 +++ .../zh-CN/content/actions/guides/index.md | 8 + .../guides/publishing-docker-images.md | 4 +- .../guides/publishing-nodejs-packages.md | 2 +- ...-hosted-runner-application-as-a-service.md | 1 + ...and-troubleshooting-self-hosted-runners.md | 1 + translations/zh-CN/content/actions/index.md | 12 +- .../finding-and-customizing-actions.md | 2 +- .../managing-complex-workflows.md | 8 +- ...igrating-from-jenkins-to-github-actions.md | 2 +- ...rating-from-travis-ci-to-github-actions.md | 2 +- .../security-hardening-for-github-actions.md | 12 +- .../enabling-debug-logging.md | 3 + .../actions/managing-workflow-runs/index.md | 3 +- .../reviewing-deployments.md | 25 + .../reference/authentication-in-a-workflow.md | 2 - .../actions/reference/encrypted-secrets.md | 142 +- .../reference/environment-variables.md | 6 +- .../content/actions/reference/environments.md | 69 + .../events-that-trigger-workflows.md | 16 +- .../zh-CN/content/actions/reference/index.md | 10 +- .../workflow-commands-for-github-actions.md | 6 +- .../workflow-syntax-for-github-actions.md | 71 +- .../configuring-email-for-notifications.md | 1 + .../about-github-enterprise-support.md | 2 +- .../about-support-for-advanced-security.md | 4 +- .../overview/about-enterprise-accounts.md | 6 +- .../keyboard-shortcuts.md | 2 + .../apps/authenticating-with-github-apps.md | 2 +- .../developers/apps/authorizing-oauth-apps.md | 4 +- ...ating-a-github-app-using-url-parameters.md | 50 +- .../developers/apps/deleting-a-github-app.md | 10 +- .../developers/apps/deleting-an-oauth-app.md | 8 +- .../apps/editing-a-github-apps-permissions.md | 16 +- .../apps/getting-started-with-apps.md | 4 +- .../zh-CN/content/developers/apps/guides.md | 2 +- ...g-and-authorizing-users-for-github-apps.md | 2 +- .../zh-CN/content/developers/apps/index.md | 2 +- .../making-a-github-app-public-or-private.md | 22 +- .../developers/apps/managing-github-apps.md | 4 +- .../developers/apps/managing-oauth-apps.md | 4 +- .../developers/apps/modifying-a-github-app.md | 6 +- .../developers/apps/modifying-an-oauth-app.md | 6 +- .../setting-permissions-for-github-apps.md | 8 +- .../suspending-a-github-app-installation.md | 16 +- .../transferring-ownership-of-a-github-app.md | 12 +- .../transferring-ownership-of-an-oauth-app.md | 12 +- ...leshooting-authorization-request-errors.md | 20 +- ...g-oauth-app-access-token-request-errors.md | 22 +- .../apps/using-content-attachments.md | 2 +- .../about-github-marketplace.md | 38 +- .../about-verified-creators.md | 36 +- .../creating-apps-for-github-marketplace.md | 3 +- ...omer-experience-best-practices-for-apps.md | 20 +- .../listing-an-app-on-github-marketplace.md | 4 +- ...icing-plans-for-github-marketplace-apps.md | 2 +- .../receiving-payment-for-app-purchases.md | 16 +- .../requirements-for-listing-an-app.md | 2 +- ...ndpoints-for-the-github-marketplace-api.md | 20 +- .../selling-your-app-on-github-marketplace.md | 4 +- ...submitting-your-listing-for-publication.md | 4 +- ...-the-github-marketplace-api-in-your-app.md | 4 +- .../zh-CN/content/developers/index.md | 4 +- .../developers/overview/about-githubs-apis.md | 14 +- .../content/developers/overview/index.md | 1 + .../overview/managing-deploy-keys.md | 2 + .../overview/viewing-deployment-history.md | 20 + .../webhooks-and-events/creating-webhooks.md | 10 +- .../developers/webhooks-and-events/events.md | 2 +- .../webhooks-and-events/github-event-types.md | 108 +- .../developers/webhooks-and-events/index.md | 4 +- .../webhooks-and-events/issue-event-types.md | 564 ++++---- .../securing-your-webhooks.md | 40 +- .../webhooks-and-events/testing-webhooks.md | 22 +- .../webhook-events-and-payloads.md | 104 +- .../webhooks-and-events/webhooks.md | 2 +- .../about-discussions.md | 44 +- ...ting-with-maintainers-using-discussions.md | 38 +- .../index.md | 6 +- .../participating-in-a-discussion.md | 22 +- ...s-for-community-conversations-on-github.md | 36 +- ...iscussions-across-multiple-repositories.md | 12 +- ...-higher-permissions-to-top-contributors.md | 24 +- .../zh-CN/content/discussions/guides/index.md | 8 +- .../zh-CN/content/discussions/index.md | 10 +- .../index.md | 6 +- ...ries-for-discussions-in-your-repository.md | 54 +- ...managing-discussions-in-your-repository.md | 78 +- .../moderating-discussions.md | 36 +- .../zh-CN/content/discussions/quickstart.md | 46 +- .../zh-CN/content/education/guides.md | 50 +- translations/zh-CN/content/education/index.md | 14 +- ...g-makecode-arcade-with-github-classroom.md | 24 +- ...bout-using-replit-with-github-classroom.md | 26 +- .../basics-of-setting-up-github-classroom.md | 38 +- ...lt-settings-for-assignment-repositories.md | 42 +- ...g-management-system-to-github-classroom.md | 166 +-- .../create-a-group-assignment.md | 100 +- ...n-assignment-from-a-template-repository.md | 14 +- .../create-an-individual-assignment.md | 80 +- .../get-started-with-github-classroom.md | 4 +- .../glossary.md | 26 +- .../index.md | 4 +- .../integrate-github-classroom-with-an-ide.md | 6 +- ...ate-github-classroom-with-an-online-ide.md | 38 +- .../learn-with-github-classroom.md | 4 +- .../leave-feedback-with-pull-requests.md | 22 +- .../manage-classrooms.md | 90 +- .../run-student-code-in-an-online-ide.md | 14 +- .../teach-with-github-classroom.md | 4 +- .../use-autograding.md | 88 +- .../view-autograding-results.md | 22 +- .../zh-CN/content/education/quickstart.md | 56 +- .../about-github-education-for-students.md | 4 +- .../about-github-education.md | 4 +- .../apply-for-a-student-developer-pack.md | 4 +- ...-for-an-educator-or-researcher-discount.md | 4 +- .../index.md | 6 +- ...-github-at-your-educational-institution.md | 2 +- .../use-github-for-your-schoolwork.md | 2 +- ...e-github-in-your-classroom-and-research.md | 2 +- ...n-for-a-student-developer-pack-approved.md | 4 +- ...ducator-or-researcher-discount-approved.md | 2 +- .../about-protected-branches.md | 4 + .../configuring-pull-request-merges.md | 2 +- .../administering-a-repository/index.md | 1 + ...ge-for-pull-requests-in-your-repository.md | 16 + .../authorizing-oauth-apps.md | 2 +- ...onnecting-with-third-party-applications.md | 2 +- ...-ssh-key-and-adding-it-to-the-ssh-agent.md | 4 +- .../testing-your-ssh-connection.md | 2 +- .../automatically-merging-a-pull-request.md | 38 + .../index.md | 1 + .../merging-a-pull-request.md | 2 + .../configuring-code-scanning.md | 2 +- ...-codeql-code-scanning-in-your-ci-system.md | 14 +- .../about-managing-vulnerable-dependencies.md | 2 +- ...ilities-in-the-github-advisory-database.md | 2 +- ...configuring-dependabot-security-updates.md | 6 +- ...abilities-in-your-projects-dependencies.md | 2 +- ...he-detection-of-vulnerable-dependencies.md | 28 +- ...nerable-dependencies-in-your-repository.md | 4 +- .../about-notifications.md | 10 +- .../configuring-notifications.md | 52 +- .../managing-notifications-from-your-inbox.md | 38 +- .../managing-your-subscriptions.md | 6 +- .../viewing-your-subscriptions.md | 16 +- ...and-pull-requests-with-query-parameters.md | 18 +- .../about-automation-for-project-boards.md | 6 +- .../about-issues.md | 2 +- .../about-project-boards.md | 2 +- ...es-and-pull-requests-to-a-project-board.md | 2 +- ...and-pull-requests-to-other-github-users.md | 2 +- .../creating-a-project-board.md | 2 +- .../creating-an-issue.md | 2 +- .../disabling-issues.md | 4 +- ...attachments-on-issues-and-pull-requests.md | 4 +- .../filtering-cards-on-a-project-board.md | 6 +- ...g-issues-and-pull-requests-by-milestone.md | 2 +- .../linking-a-pull-request-to-an-issue.md | 2 +- .../opening-an-issue-from-a-comment.md | 2 +- .../opening-an-issue-from-code.md | 2 +- .../watching-and-unwatching-repositories.md | 2 +- .../searching-code.md | 3 +- .../permission-levels-for-an-organization.md | 1 + ...y-permission-levels-for-an-organization.md | 3 +- ...ail-notifications-to-an-approved-domain.md | 10 +- .../verifying-your-organizations-domain.md | 28 +- .../index.md | 2 + ...-enterprise-account-to-approved-domains.md | 26 + ...rifying-your-enterprise-accounts-domain.md | 42 + ...on-levels-for-a-user-account-repository.md | 34 +- ...d-data-protection-for-your-organization.md | 5 +- .../github-marketplace-developer-agreement.md | 6 +- .../site-policy/github-privacy-statement.md | 54 +- .../github-subprocessors-and-cookies.md | 127 +- ...delines-for-legal-requests-of-user-data.md | 2 - ...loring-the-dependencies-of-a-repository.md | 32 +- ...ustom-domain-for-your-github-pages-site.md | 7 +- ...hooting-custom-domains-and-github-pages.md | 6 +- .../graphql/overview/resource-limitations.md | 8 +- .../zh-CN/content/graphql/reference/enums.md | 1 + .../graphql/reference/input-objects.md | 1 + .../content/graphql/reference/interfaces.md | 1 + .../content/graphql/reference/mutations.md | 1 + .../content/graphql/reference/objects.md | 1 + .../content/graphql/reference/queries.md | 1 + .../content/graphql/reference/scalars.md | 1 + .../zh-CN/content/graphql/reference/unions.md | 1 + .../about-data-in-github-insights.md | 2 +- .../installing-github-insights.md | 2 +- ...guring-npm-for-use-with-github-packages.md | 11 + .../guides/deleting-a-container-image.md | 30 +- translations/zh-CN/content/packages/index.md | 16 +- .../zh-CN/content/rest/overview/libraries.md | 1 + .../overview/resources-in-the-rest-api.md | 21 +- .../rest/reference/enterprise-admin.md | 2 +- .../permissions-required-for-github-apps.md | 6 +- .../zh-CN/data/glossaries/external.yml | 2 +- translations/zh-CN/data/products.yml | 2 +- .../zh-CN/data/release-notes/2-20/0.yml | 60 +- .../zh-CN/data/release-notes/2-20/1.yml | 8 +- .../zh-CN/data/release-notes/2-20/2.yml | 30 +- .../zh-CN/data/release-notes/2-20/23.yml | 13 + .../zh-CN/data/release-notes/2-20/3.yml | 6 +- .../zh-CN/data/release-notes/2-20/4.yml | 6 +- .../zh-CN/data/release-notes/2-20/5.yml | 4 +- .../zh-CN/data/release-notes/2-20/6.yml | 4 +- .../zh-CN/data/release-notes/2-20/7.yml | 4 +- .../zh-CN/data/release-notes/2-20/8.yml | 4 +- .../zh-CN/data/release-notes/2-20/9.yml | 4 +- .../zh-CN/data/release-notes/2-21/0.yml | 4 +- .../zh-CN/data/release-notes/2-21/14.yml | 13 + .../zh-CN/data/release-notes/2-22/6.yml | 18 + .../reusables/actions/environments-beta.md | 9 + .../data/reusables/actions/forked-secrets.md | 1 + .../assignments-classroom-prerequisite.md | 2 +- .../classroom/click-classroom-in-list.md | 2 +- ...e-information-about-assignment-creation.md | 2 +- .../filter-issues-and-pull-requests-tip.md | 2 +- .../dependabot/supported-package-managers.md | 2 + .../pull_request_forked_repos_link.md | 2 +- .../discussions/click-discussion-in-list.md | 2 +- .../discussions/edit-category-details.md | 2 +- .../marking-a-comment-as-an-answer.md | 2 +- .../reusables/education/apply-for-team.md | 2 +- .../verified-domains-tab.md | 1 + .../verifying-domains-release-phase.md | 5 + .../gated-features/actions-shared.md | 1 + .../data/reusables/gated-features/actions.md | 2 +- .../reusables/gated-features/auto-merge.md | 1 + .../reusables/gated-features/environments.md | 1 + .../permissions-statement-environment.md | 1 + ...rmissions-statement-secrets-environment.md | 1 + .../github-actions/sidebar-environment.md | 1 + .../issue-event-common-properties.md | 20 +- .../notifications/outbound_email_tip.md | 4 +- .../organizations/add-dns-txt-record.md | 1 + .../reusables/organizations/add-domain.md | 1 + .../continue-verifying-domain.md | 2 + .../restrict-email-notifications.md | 1 + .../organizations/verified-domains-details.md | 1 + .../reusables/pages/wildcard-dns-warning.md | 5 + .../suspend-installation-beta.md | 6 +- .../pull_requests/auto-merge-release-phase.md | 5 + .../pull_requests/you-can-auto-merge.md | 3 + .../user-settings/modify_github_app.md | 2 +- .../user-settings/modify_oauth_app.md | 2 +- 1163 files changed, 12008 insertions(+), 6502 deletions(-) create mode 100644 translations/de-DE/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/de-DE/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/de-DE/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/de-DE/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/de-DE/content/actions/reference/environments.md create mode 100644 translations/de-DE/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/de-DE/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/de-DE/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/de-DE/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/de-DE/data/release-notes/2-20/23.yml create mode 100644 translations/de-DE/data/release-notes/2-21/14.yml create mode 100644 translations/de-DE/data/release-notes/2-22/6.yml create mode 100644 translations/de-DE/data/reusables/actions/environments-beta.md create mode 100644 translations/de-DE/data/reusables/actions/forked-secrets.md create mode 100644 translations/de-DE/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/de-DE/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/de-DE/data/reusables/gated-features/actions-shared.md create mode 100644 translations/de-DE/data/reusables/gated-features/auto-merge.md create mode 100644 translations/de-DE/data/reusables/gated-features/environments.md create mode 100644 translations/de-DE/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/de-DE/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/de-DE/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/de-DE/data/reusables/organizations/add-domain.md create mode 100644 translations/de-DE/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/de-DE/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/de-DE/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/de-DE/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/de-DE/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/de-DE/data/reusables/pull_requests/you-can-auto-merge.md create mode 100644 translations/ja-JP/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/ja-JP/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/ja-JP/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/ja-JP/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/ja-JP/content/actions/reference/environments.md create mode 100644 translations/ja-JP/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/ja-JP/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/ja-JP/data/release-notes/2-20/23.yml create mode 100644 translations/ja-JP/data/release-notes/2-21/14.yml create mode 100644 translations/ja-JP/data/release-notes/2-22/6.yml create mode 100644 translations/ja-JP/data/reusables/actions/environments-beta.md create mode 100644 translations/ja-JP/data/reusables/actions/forked-secrets.md create mode 100644 translations/ja-JP/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/ja-JP/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/ja-JP/data/reusables/gated-features/actions-shared.md create mode 100644 translations/ja-JP/data/reusables/gated-features/auto-merge.md create mode 100644 translations/ja-JP/data/reusables/gated-features/environments.md create mode 100644 translations/ja-JP/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/ja-JP/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/ja-JP/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/ja-JP/data/reusables/organizations/add-domain.md create mode 100644 translations/ja-JP/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/ja-JP/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/ja-JP/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/ja-JP/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/ja-JP/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/ja-JP/data/reusables/pull_requests/you-can-auto-merge.md create mode 100644 translations/ko-KR/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/ko-KR/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/ko-KR/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/ko-KR/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/ko-KR/content/actions/reference/environments.md create mode 100644 translations/ko-KR/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/ko-KR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/ko-KR/data/release-notes/2-20/23.yml create mode 100644 translations/ko-KR/data/release-notes/2-21/14.yml create mode 100644 translations/ko-KR/data/release-notes/2-22/6.yml create mode 100644 translations/ko-KR/data/reusables/actions/environments-beta.md create mode 100644 translations/ko-KR/data/reusables/actions/forked-secrets.md create mode 100644 translations/ko-KR/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/ko-KR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/ko-KR/data/reusables/gated-features/actions-shared.md create mode 100644 translations/ko-KR/data/reusables/gated-features/auto-merge.md create mode 100644 translations/ko-KR/data/reusables/gated-features/environments.md create mode 100644 translations/ko-KR/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/ko-KR/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/ko-KR/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/ko-KR/data/reusables/organizations/add-domain.md create mode 100644 translations/ko-KR/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/ko-KR/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/ko-KR/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/ko-KR/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/ko-KR/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/ko-KR/data/reusables/pull_requests/you-can-auto-merge.md create mode 100644 translations/pt-BR/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/pt-BR/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/pt-BR/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/pt-BR/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/pt-BR/content/actions/reference/environments.md create mode 100644 translations/pt-BR/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/pt-BR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/pt-BR/data/release-notes/2-20/23.yml create mode 100644 translations/pt-BR/data/release-notes/2-21/14.yml create mode 100644 translations/pt-BR/data/release-notes/2-22/6.yml create mode 100644 translations/pt-BR/data/reusables/actions/environments-beta.md create mode 100644 translations/pt-BR/data/reusables/actions/forked-secrets.md create mode 100644 translations/pt-BR/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/pt-BR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/pt-BR/data/reusables/gated-features/actions-shared.md create mode 100644 translations/pt-BR/data/reusables/gated-features/auto-merge.md create mode 100644 translations/pt-BR/data/reusables/gated-features/environments.md create mode 100644 translations/pt-BR/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/pt-BR/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/pt-BR/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/pt-BR/data/reusables/organizations/add-domain.md create mode 100644 translations/pt-BR/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/pt-BR/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/pt-BR/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/pt-BR/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/pt-BR/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/pt-BR/data/reusables/pull_requests/you-can-auto-merge.md create mode 100644 translations/ru-RU/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/ru-RU/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/ru-RU/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/ru-RU/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/ru-RU/content/actions/reference/environments.md create mode 100644 translations/ru-RU/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/ru-RU/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/ru-RU/data/release-notes/2-20/23.yml create mode 100644 translations/ru-RU/data/release-notes/2-21/14.yml create mode 100644 translations/ru-RU/data/release-notes/2-22/6.yml create mode 100644 translations/ru-RU/data/reusables/actions/environments-beta.md create mode 100644 translations/ru-RU/data/reusables/actions/forked-secrets.md create mode 100644 translations/ru-RU/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/ru-RU/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/ru-RU/data/reusables/gated-features/actions-shared.md create mode 100644 translations/ru-RU/data/reusables/gated-features/auto-merge.md create mode 100644 translations/ru-RU/data/reusables/gated-features/environments.md create mode 100644 translations/ru-RU/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/ru-RU/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/ru-RU/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/ru-RU/data/reusables/organizations/add-domain.md create mode 100644 translations/ru-RU/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/ru-RU/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/ru-RU/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/ru-RU/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/ru-RU/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/ru-RU/data/reusables/pull_requests/you-can-auto-merge.md create mode 100644 translations/zh-CN/content/actions/guides/deploying-to-amazon-elastic-container-service.md create mode 100644 translations/zh-CN/content/actions/guides/deploying-to-azure-app-service.md create mode 100644 translations/zh-CN/content/actions/guides/deploying-to-google-kubernetes-engine.md create mode 100644 translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md create mode 100644 translations/zh-CN/content/actions/reference/environments.md create mode 100644 translations/zh-CN/content/developers/overview/viewing-deployment-history.md create mode 100644 translations/zh-CN/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md create mode 100644 translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md create mode 100644 translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md create mode 100644 translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md create mode 100644 translations/zh-CN/data/release-notes/2-20/23.yml create mode 100644 translations/zh-CN/data/release-notes/2-21/14.yml create mode 100644 translations/zh-CN/data/release-notes/2-22/6.yml create mode 100644 translations/zh-CN/data/reusables/actions/environments-beta.md create mode 100644 translations/zh-CN/data/reusables/actions/forked-secrets.md create mode 100644 translations/zh-CN/data/reusables/enterprise-accounts/verified-domains-tab.md create mode 100644 translations/zh-CN/data/reusables/enterprise-accounts/verifying-domains-release-phase.md create mode 100644 translations/zh-CN/data/reusables/gated-features/actions-shared.md create mode 100644 translations/zh-CN/data/reusables/gated-features/auto-merge.md create mode 100644 translations/zh-CN/data/reusables/gated-features/environments.md create mode 100644 translations/zh-CN/data/reusables/github-actions/permissions-statement-environment.md create mode 100644 translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-environment.md create mode 100644 translations/zh-CN/data/reusables/github-actions/sidebar-environment.md create mode 100644 translations/zh-CN/data/reusables/organizations/add-dns-txt-record.md create mode 100644 translations/zh-CN/data/reusables/organizations/add-domain.md create mode 100644 translations/zh-CN/data/reusables/organizations/continue-verifying-domain.md create mode 100644 translations/zh-CN/data/reusables/organizations/restrict-email-notifications.md create mode 100644 translations/zh-CN/data/reusables/organizations/verified-domains-details.md create mode 100644 translations/zh-CN/data/reusables/pages/wildcard-dns-warning.md create mode 100644 translations/zh-CN/data/reusables/pull_requests/auto-merge-release-phase.md create mode 100644 translations/zh-CN/data/reusables/pull_requests/you-can-auto-merge.md 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 1f7b6e07160b..4ad7b6a49e7b 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 @@ -56,26 +56,26 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo {% raw %} **action.yml** ```yaml - Name: 'Hello World' - Beschreibung: 'Greet someone' + name: 'Hello World' + description: 'Greet someone' inputs: - who-to-greet: 'id of input + who-to-greet: # id of input description: 'Who to greet' required: true default: 'World' outputs: - zuzufällige Zahl: - Beschreibung: "Zufallszahl" - Wert:{{ steps.random-number-generator.outputs.random-id }} - läuft: - mit: "composite" - Schritten: - - laufen:{{ inputs.who-to-greet }}echo + random-number: + description: "Random number" + value: ${{ steps.random-number-generator.outputs.random-id }} + runs: + using: "composite" + steps: + - run: echo Hello ${{ inputs.who-to-greet }}. shell: bash - id: random-number-generator - run: echo "::set-output name=random-id::'(echo $RANDOM)" + run: echo "::set-output name=random-id::$(echo $RANDOM)" shell: bash - - run: '{{ github.action_path }}/goodbye.sh + - run: ${{ github.action_path }}/goodbye.sh shell: bash ``` {% endraw %} @@ -109,20 +109,20 @@ Copy the workflow code into a `.github/workflows/main.yml` file in another repos {% raw %} **.github/workflows/main.yml** ```yaml -zu: [push] +on: [push] -Jobs: +jobs: hello_world_job: - läuft auf: ubuntu-latest - Name: Ein Job, um Hallo zu sagen - Schritte: - - verwendet: aktionen/checkout@v2 + runs-on: ubuntu-latest + name: A job to say hello + steps: + - uses: actions/checkout@v2 - id: foo - verwendet: actions/hello-world-composite-run-steps-action@v1 - mit: + uses: actions/hello-world-composite-run-steps-action@v1 + with: who-to-greet: 'Mona the Octocat' - - run: echo random-{{ steps.foo.outputs.random-number }} - number + - run: echo random-number ${{ steps.foo.outputs.random-number }} + shell: bash ``` {% endraw %} 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 62834275fedd..2cc9deb2121b 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 @@ -117,6 +117,7 @@ läuft: {% endraw %} #### `outputs..value` + **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. 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)". @@ -204,9 +205,11 @@ In diesem Beispiel läuft `cleanup.js` nur auf Linux-basierten Runnern: **Erforderliche** Die Ausführungsschritte, die Sie in dieser Aktion ausführen möchten. -##### `runs.steps.run` +##### `runs.steps[*].run` **Erforderliche** Der Befehl, den Sie ausführen möchten. Dies kann inline oder ein Skript in Ihrem Aktions-Repository sein: + +{% raw %} ```yaml läuft: mit: "composite" @@ -214,8 +217,9 @@ läuft: - ausführen:{{ github.action_path }}/test/script.sh Shell: bash ``` +{% endraw %} -Alternativ können Sie `$GITHUB_ACTION_PATH`verwenden: +Alternatively, you can use `$GITHUB_ACTION_PATH`: ```yaml läuft: @@ -225,27 +229,27 @@ läuft: Shell: bash ``` -Weitere Informationen finden Sie unter "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". +For more information, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -##### `runs.steps.shell` +##### `runs.steps[*].shell` -**Erforderliche** Die Shell, in der Sie den Befehl ausführen möchten. Sie können eine der hier aufgeführten Shells [](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)verwenden. +**Required** The shell where you want to run the command. You can use any of the shells listed [here](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). -##### `runs.steps.name` +##### `runs.steps[*].name` -**Optionaler** Der Name des zusammengesetzten Ausführungsschritts. +**Optional** The name of the composite run step. -##### `runs.steps.id` +##### `runs.steps[*].id` -**Optionaler** Ein eindeutiger Bezeichner 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)". +**Optional** A unique identifier for the step. 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)". -##### `runs.steps.env` +##### `runs.steps[*].env` -**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. +**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` +##### `runs.steps[*].working-directory` -**Optionale** Gibt das Arbeitsverzeichnis an, in dem der Befehl ausgeführt wird. +**Optional** Specifies the working directory where the command is run. ### `runs` for Docker actions diff --git a/translations/de-DE/content/actions/guides/about-continuous-integration.md b/translations/de-DE/content/actions/guides/about-continuous-integration.md index 93a553fdf4e7..937a8a60fa56 100644 --- a/translations/de-DE/content/actions/guides/about-continuous-integration.md +++ b/translations/de-DE/content/actions/guides/about-continuous-integration.md @@ -25,7 +25,7 @@ Zum Erstellen und Testen des Codes ist ein Server erforderlich. Sie können Aktu ### 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)". +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. 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)." 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. 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 index c9258acfb2f5..b3830e286f02 100644 --- a/translations/de-DE/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/de-DE/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% 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)“. +To authenticate to your private registry, you'll need to store your npm authentication token as a secret. For example, create a repository secret called `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. +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. When using the `setup-node` action to create an *.npmrc* file, you must set the `NODE_AUTH_TOKEN` environment variable with the secret that contains your npm authentication token. 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). diff --git a/translations/de-DE/content/actions/guides/building-and-testing-powershell.md b/translations/de-DE/content/actions/guides/building-and-testing-powershell.md index 7adb13f39d2d..41224c77d2b3 100644 --- a/translations/de-DE/content/actions/guides/building-and-testing-powershell.md +++ b/translations/de-DE/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ The `always()` function configures the job to continue processing even if there ### Publishing to PowerShell Gallery -You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use repository secrets to store any tokens or credentials needed to publish your package. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". +You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use secrets to store any tokens or credentials needed to publish your package. Weitere Informationen findest Du unter "[Verschlüsselte Geheimnisse erstellen und verwenden](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". The following example creates a package and uses `Publish-Module` to publish it to the PowerShell Gallery: 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 index 6154cac5b245..116de816ed35 100644 --- a/translations/de-DE/content/actions/guides/building-and-testing-python.md +++ b/translations/de-DE/content/actions/guides/building-and-testing-python.md @@ -391,7 +391,7 @@ jobs: 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)". +You can store any access tokens or credentials needed to publish your package using 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 diff --git a/translations/de-DE/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/de-DE/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..dd137836d420 --- /dev/null +++ b/translations/de-DE/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: Deploying to Amazon Elastic Container Service +intro: You can deploy to Amazon Elastic Container Service (ECS) as part of your continuous deployment (CD) 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 %} + +### Einführung + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/), and deploy it to [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/). + +On every new release in your {% data variables.product.company_short %} repository, the {% data variables.product.prodname_actions %} workflow builds and pushes a new container image to Amazon ECR, and then deploys a new task definition to Amazon ECS. + +### Vorrausetzungen + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps for Amazon ECR and ECS: + +1. Create an Amazon ECR repository to store your images. + + For example, using [the AWS CLI](https://aws.amazon.com/cli/): + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Ensure that you use the same Amazon ECR repository name (represented here by `MY_ECR_REPOSITORY`) for the `ECR_REPOSITORY` variable in the workflow below. + + Ensure that you use the same AWS region value for the `AWS_REGION` (represented here by `MY_AWS_REGION`) variable in the workflow below. + +2. Create an Amazon ECS task definition, cluster, and service. + + For details, follow the [Getting started wizard on the Amazon ECS console](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), or the [Getting started guide](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) in the Amazon ECS documentation. + + Ensure that you note the names you set for the Amazon ECS service and cluster, and use them for the `ECS_SERVICE` and `ECS_CLUSTER` variables in the workflow below. + +3. Store your Amazon ECS task definition as a JSON file in your {% data variables.product.company_short %} repository. + + The format of the file should be the same as the output generated by: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Ensure that you set the `CONTAINER_NAME` variable in the workflow below as the container name in the `containerDefinitions` section of the task definition. + +4. Create {% data variables.product.prodname_actions %} secrets named `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to store the values for your Amazon IAM access key. + + For more information on creating secrets for {% data variables.product.prodname_actions %}, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + See the documentation for each action used below for the recommended IAM policies for the IAM user, and methods for handling the access key credentials. + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to Amazon ECR. It then updates the task definition with the new image ID, and deploys the task definition to Amazon ECS. + +Ensure that you provide your own values for all the variables in the `env` key of the workflow. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### Additional resources + +For more information on the services used in these examples, see the following documentation: + +* "[Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)" in the Amazon AWS documentation. +* Official AWS "[Configure AWS Credentials](https://github.com/aws-actions/configure-aws-credentials)" action. +* Official AWS [Amazon ECR "Login"](https://github.com/aws-actions/amazon-ecr-login) action. +* Official AWS [Amazon ECS "Render Task Definition"](https://github.com/aws-actions/amazon-ecs-render-task-definition) action. +* Official AWS [Amazon ECS "Deploy Task Definition"](https://github.com/aws-actions/amazon-ecs-deploy-task-definition) action. diff --git a/translations/de-DE/content/actions/guides/deploying-to-azure-app-service.md b/translations/de-DE/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..86dfb41e3ba3 --- /dev/null +++ b/translations/de-DE/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: Deploying to Azure App Service +intro: You can deploy to Azure App Service as part of your continuous deployment (CD) 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 %} + +### Einführung + +This guide explains how to use {% data variables.product.prodname_actions %} to build, test, and deploy an application to [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/). + +Azure App Service can run web apps in several languages, but this guide demonstrates deploying an existing Node.js project. + +### Vorrausetzungen + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps: + +1. Create an Azure App Service plan. + + For example, you can use the Azure CLI to create a new App Service plan: + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + In the command above, replace `MY_RESOURCE_GROUP` with your pre-existing Azure Resource Group, and `MY_APP_SERVICE_PLAN` with a new name for the App Service plan. + + See the Azure documentation for more information on using the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/): + + * For authentication, see "[Sign in with Azure CLI](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)". + * If you need to create a new resource group, see "[az group](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)." + +2. Create a web app. + + For example, you can use the Azure CLI to create an Azure App Service web app with a node runtime: + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + In the command above, replace the parameters with your own values, where `MY_WEBAPP_NAME` is a new name for the web app. + +3. Configure an Azure publish profile and create an `AZURE_WEBAPP_PUBLISH_PROFILE` secret. + + Generate your Azure deployment credentials using a publish profile. For more information, see "[Generate deployment credentials](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" in the Azure documentation. + + In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build, test, and deploy the Node.js project to Azure App Service. + +Ensure that you set `AZURE_WEBAPP_NAME` in the workflow `env` key to the name of the web app you created. + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### Additional resources + +The following resources may also be useful: + +* For the original starter workflow, see [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml) in the {% data variables.product.prodname_actions %} `starter-workflows` repository. +* The action used to deploy the web app is the official Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) action. +* The "[Create a Node.js web app in Azure](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)" quickstart in the Azure web app documentation demonstrates using VS Code with the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). diff --git a/translations/de-DE/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/de-DE/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..c2f08706568f --- /dev/null +++ b/translations/de-DE/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: Deploying to Google Kubernetes Engine +intro: You can deploy to Google Kubernetes Engine as part of your continuous deployment (CD) 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 %} + +### Einführung + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to Google Container Registry (GCR), and deploy it to Google Kubernetes Engine (GKE). + +GKE is a managed Kubernetes cluster service from Google Cloud that can host your containerized workloads in the cloud or in your own datacenter. For more information, see [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine). + +### Vorrausetzungen + +Before you proceed with creating the workflow, you will need to complete the following steps for your Kubernetes project. This guide assumes the root of your project already has a `Dockerfile` and a Kubernetes Deployment configuration file. For an example, see [google-github-actions](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke). + +#### Creating a GKE cluster + +To create the GKE cluster, you will first need to authenticate using the `gcloud` CLI. For more information on this step, see the following articles: +- [`gcloud auth login`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI and Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +Ein Beispiel: + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### Enabling the APIs + +Enable the Kubernetes Engine and Container Registry APIs. Ein Beispiel: + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### Configuring a service account and storing its credentials + +This procedure demonstrates how to create the service account for your GKE integration. It explains how to create the account, add roles to it, retrieve its keys, and store them as a base64-encoded [encrypted repository secret](/actions/reference/encrypted-secrets) named `GKE_SA_KEY`. + +1. Create a new service account: + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. Retrieve the email address of the service account you just created: + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. Add roles to the service account. Note: Apply more restrictive roles to suit your requirements. + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. Download the JSON keyfile for the service account: + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. Store the project ID as a secret named `GKE_PROJECT`: + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### (Optional) Configuring kustomize +Kustomize is an optional tool used for managing YAML specs. After creating a _kustomization_ file, the workflow below can be used to dynamically set fields of the image and pipe in the result to `kubectl`. For more information, see [kustomize usage](https://github.com/kubernetes-sigs/kustomize#usage). + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to GCR. It then uses the Kubernetes tools (such as `kubectl` and `kustomize`) to pull the image into the cluster deployment. + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### Additional resources + +For more information on the tools used in these examples, see the following documentation: + +* For the full starter workflow, see the ["Build and Deploy to GKE" workflow](https://github.com/actions/starter-workflows/blob/master/ci/google.yml). +* For more starter workflows and accompanying code, see Google's [{% data variables.product.prodname_actions %} example workflows](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/). +* The Kubernetes YAML customization engine: [Kustomize](https://kustomize.io/). +* "[Deploying a containerized web application](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)" in the Google Kubernetes Engine documentation. diff --git a/translations/de-DE/content/actions/guides/index.md b/translations/de-DE/content/actions/guides/index.md index 54857c133718..71541c512f14 100644 --- a/translations/de-DE/content/actions/guides/index.md +++ b/translations/de-DE/content/actions/guides/index.md @@ -36,6 +36,14 @@ You can use {% data variables.product.prodname_actions %} to create custom conti {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### Creating custom continuous deployment workflows + +You can use {% data variables.product.prodname_actions %} to create custom continuous deployment (CD) workflows that deploy projects to a number of cloud partner ecosystems. + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### 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 %}. diff --git a/translations/de-DE/content/actions/guides/publishing-docker-images.md b/translations/de-DE/content/actions/guides/publishing-docker-images.md index 16314b3d8eb3..9b4ec5ef26e0 100644 --- a/translations/de-DE/content/actions/guides/publishing-docker-images.md +++ b/translations/de-DE/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ In dieser Anleitung wir werden die Docker-Aktion `build-push-action` verwenden, 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. +Um zum „Docker Hub“ zu pushen, benötigst Du ein Benutzerkonto auf „Docker Hub“ und musst ein „Docker Hub“-Repository erstellt haben. For more information, see "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" in the Docker documentation. „Docker Hub“ benötigt für `build-push-action` die folgenden Optionen: -* `username` und `password`: Dies ist Dein Benutzername und Passwort auf „Docker Hub“. We recommend storing your Docker Hub username and password as encrypted secrets in your {% data variables.product.prodname_dotcom %} repository so they aren't exposed in your workflow file. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und verwenden](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)“. +* `username` und `password`: Dies ist Dein Benutzername und Passwort auf „Docker Hub“. We recommend storing your Docker Hub username and password as secrets so they aren't exposed in your workflow file. 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 %} diff --git a/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md b/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md index 944534e21d85..ace0c5b58821 100644 --- a/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/de-DE/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ Wenn Du Schritte in Deinen Workflow einfügst, um die `publishConfig`-Felder in 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)“. +To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret. For example, create a repository secret called `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. 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 145f8346ebc7..550739f07e0c 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 @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} 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 8796228a26c7..0da2809fc0c6 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 @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/de-DE/content/actions/index.md b/translations/de-DE/content/actions/index.md index c7f1b0afd594..a9c1273bc966 100644 --- a/translations/de-DE/content/actions/index.md +++ b/translations/de-DE/content/actions/index.md @@ -25,6 +25,10 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: + - + title: Workflow visualization + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ - title: Removing set-env and add-path commands on November 16 date: '2020-11-09' @@ -33,14 +37,6 @@ changelog: title: Ubuntu-latest workflows will use Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - - title: MacOS Big Sur Preview - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - - title: Self-Hosted Runner Group Access Changes - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU redirect_from: - /articles/automating-your-workflow-with-github-actions/ 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 index bc979216413d..cb3484592f44 100644 --- 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 @@ -76,7 +76,7 @@ Schritte: #### 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`: +Referring to a specific branch means that the action will always use 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: 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 index 2941fc8a7aa4..0107907fab74 100644 --- 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 @@ -1,7 +1,7 @@ --- 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.' +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,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} environments,{% endif %} and labels.' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Using environments + +You can configure environments with protection rules and secrets. Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." +{% endif %} + ### 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-jenkins-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md index 6b38d484b5e4..be29098f280b 100644 --- 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 @@ -57,7 +57,7 @@ Jenkins verwendet Anweisungen um _Deklarative Pipelines_ zu verwalten. Diese Anw | 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) | +| [`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) | diff --git a/translations/de-DE/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/de-DE/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index d53607e4118e..a026ce8b6ea0 100644 --- a/translations/de-DE/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/de-DE/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ When migrating from Travis CI, consider the following key features in {% data va #### Storing secrets -{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} also includes policies that allow you to limit access to secrets at the repository and organization level. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." +{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} organizations can limit which repositories can access organization secrets. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Environment protection rules can require manual approval for a workflow to access environment secrets. {% endif %}For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." #### Sharing files between jobs and workflows 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 index 924edb09b384..5981b685d154 100644 --- 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 @@ -19,7 +19,7 @@ This guide explains how to configure security hardening for certain {% data vari ### 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 %}. +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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environment{% else %} or repository{% endif %} 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. @@ -38,6 +38,10 @@ To help prevent accidental disclosure, {% data variables.product.product_name %} - **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. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Environments](/actions/reference/environments)." +{% endif %} ### Using third-party actions @@ -66,13 +70,13 @@ This means that a compromise of a single action within a workflow can be very si ### 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. +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` 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 a workflow, 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. +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. 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** +1. **The `GITHUB_TOKEN`** - 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** 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 index 587f33749464..ac93360e6819 100644 --- 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 @@ -13,6 +13,9 @@ versions: 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/de-DE/content/actions/managing-workflow-runs/index.md b/translations/de-DE/content/actions/managing-workflow-runs/index.md index e8456dae1d06..4d5e7554b128 100644 --- a/translations/de-DE/content/actions/managing-workflow-runs/index.md +++ b/translations/de-DE/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- 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.' +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}review deployments, {% endif %}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 @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/de-DE/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/de-DE/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..cbeb7fe2ce54 --- /dev/null +++ b/translations/de-DE/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: Reviewing deployments +intro: You can approve or reject jobs awaiting review. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About required reviews in workflows + +Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled. + +For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." + +### Approving or rejecting a job + +1. Navigate to the workflow run that requires review. For more information about navigating to a workflow run, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." +2. Click **Review deployments**. ![Review deployments](/assets/images/actions-review-deployments.png) +3. Select the job environment(s) to approve or reject. Optionally, leave a comment. ![Approve deployments](/assets/images/actions-approve-deployments.png) +4. Approve or reject: + - To approve the job, click **Approve and deploy**. Once a job is approved (and any other environment protection rules have passed), the job will proceed. At this point, the job can access any secrets stored in the environment. + - To reject the job, click **Reject**. If a job is rejected, the workflow will fail. 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 index 63560a39a7ed..edc2638abaee 100644 --- a/translations/de-DE/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/de-DE/content/actions/reference/authentication-in-a-workflow.md @@ -14,11 +14,9 @@ versions: {% 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. +{% data variables.product.prodname_dotcom %} erstellt automatisch ein `GITHUB_TOKEN`-Geheimnis für Deinen 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)." @@ -28,7 +26,7 @@ Das Token ist auch im `github.token`-Kontext verfügbar. Weitere Informationen f ### 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. +Um das `GITHUB_TOKEN`-Geheimnis zu verwenden, musst Du es in Deiner Workflow-Datei referenzieren. Hierbei müssen Sie das Token ggf. als Eingabe für eine Aktion übergeben, für die dieses Token erforderlich ist, oder authentifizierte {% data variables.product.prodname_dotcom %}-API-Aufrufe ausführen. {% data reusables.github-actions.actions-do-not-trigger-workflows %} diff --git a/translations/de-DE/content/actions/reference/encrypted-secrets.md b/translations/de-DE/content/actions/reference/encrypted-secrets.md index 295322e2cb48..bb68ecb9a3e4 100644 --- a/translations/de-DE/content/actions/reference/encrypted-secrets.md +++ b/translations/de-DE/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- title: Encrypted secrets -intro: Verschlüsselte Geheimnisse ermöglichen es Ihnen, vertrauliche Informationen in Ihrem Repository oder Ihrer Organisation zu speichern. +intro: Encrypted secrets allow you to store sensitive information in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environments{% else %} or repository{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,14 +12,19 @@ versions: --- {% data reusables.actions.enterprise-beta %} +{% data reusables.actions.environments-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. +Secrets are encrypted environment variables that you create in an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environment{% else %} or repository{% endif %}. The secrets that 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +For secrets stored at the environment level, you can enable required reviewers to control access to the secrets. A workflow job cannot access environment secrets until approval is granted by required approvers. +{% endif %} + #### Benennen Ihrer Geheimnisse Die folgenden Regeln gelten für geheime Namen: @@ -27,13 +32,16 @@ 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. +* Secret names are not case-sensitive. +* Geheime Namen müssen auf der Ebene eindeutig sein, auf der sie erstellt werden. For example, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}a secret created at the environment level must have a unique name in that environment, {% endif %}a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level. + + If a secret with the same name exists at multiple levels, the secret at the lower level takes precedence. For example, if an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Similarly, if an organization, repository, and environment all have a secret with the same name, the environment-level secret takes precedence.{% endif %} 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)“. +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 findest Du 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)“. @@ -43,6 +51,10 @@ Du kannst verschlüsselte Geheimnisse in einer Workflow-Datei verwenden und lese {% endwarning %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Organization and repository secrets are read when a workflow run is queued, and environment secrets are read when a job referencing the environment starts. +{% endif %} + Sie können Geheimnisse auch mit der REST-API verwalten. For more information, see "[Secrets](/rest/reference/actions#secrets)." #### Einschränken von Anmeldeinformationsberechtigungen @@ -56,12 +68,27 @@ Beim Generieren von Anmeldeinformationen wird empfohlen, möglichst geringe Bere {% 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. Click **New repository secret**. 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. +If your repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}has environment secrets or {% endif %}can access secrets from the parent organization, then those secrets are also listed on this page. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Creating encrypted secrets for an environment + +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click on the environment that you want to add a secret to. +1. Under **Environment secrets**, click **Add secret**. +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). +{% endif %} ### Erstellen verschlüsselter Geheimnisse für eine Organisation @@ -72,7 +99,7 @@ Beim Erstellen eines geheimen Schlüssels in einer Organisation können Sie eine {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.sidebar-secret %} -1. Klicken Sie auf **Neue geheime**. +1. Click **New organization secret**. 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. @@ -90,7 +117,7 @@ Sie können überprüfen, welche Zugriffsrichtlinien auf einen geheimen Schlüss ### 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. +{% data reusables.actions.forked-secrets %} 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)." @@ -150,13 +177,13 @@ steps: ### Einschränkungen für Geheimnisse -Dein Workflow kann bis zu 100 Geheimnisse haben. Die Namen von Geheimnis-Umgebungsvariablen müssen Repository-weit eindeutig sein. +You can store up to 1,000 secrets per organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 secrets per repository, and 100 secrets per environment{% else %} and 100 secrets per repository{% endif %}. A workflow may use up to 100 organization secrets and 100 repository secrets.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Additionally, a job referencing an environment may use up to 100 environment secrets.{% endif %} -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)“. +Geheimnisse sind auf 64 KB beschränkt. Um Geheimnisse zu verwenden, die größer als 64 KB sind, kannst Du verschlüsselte Geheimnisse in Deinem Repository speichern und die Passphrase zur Entschlüsselung als Geheimnis auf {% data variables.product.prodname_dotcom %} speichern. Du kannst beispielsweise `gpg` verwenden, um Deine Anmeldeinformationen lokal zu verschlüsseln, bevor Du die Datei in Ihrem Repository auf {% data variables.product.prodname_dotcom %} eincheckst. 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. +**Warnung**: Achte darauf, dass Deine Geheimnisse nicht gedruckt werden, wenn Deine Aktion ausgeführt wird. Wenn Du diesen Workaround verwendest, redigiert {% data variables.product.prodname_dotcom %} keine Geheimnisse, die in Protokollen gedruckt werden. {% endwarning %} diff --git a/translations/de-DE/content/actions/reference/environment-variables.md b/translations/de-DE/content/actions/reference/environment-variables.md index 04c7d2061baa..527ed72afc12 100644 --- a/translations/de-DE/content/actions/reference/environment-variables.md +++ b/translations/de-DE/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)“. +Um benutzerdefinierte Umgebungsvariablen festzulegen, musst Du die Variablen in der Workflow-Datei angeben. 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. Weitere Informationen finden Sie unter „[Workflow-Syntax für {% data variables.product.prodname_dotcom %}](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)“. ```yaml steps: @@ -51,8 +51,8 @@ Es wird dringend empfohlen, dass Aktionen Umgebungsvariablen verwenden, um auf d | `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_HEAD_REF` | Only set for pull request events. The name of the head branch. | +| `GITHUB_BASE_REF` | Only set for pull request events. The name of the base branch. | | `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`. | diff --git a/translations/de-DE/content/actions/reference/environments.md b/translations/de-DE/content/actions/reference/environments.md new file mode 100644 index 000000000000..58585b2950b1 --- /dev/null +++ b/translations/de-DE/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: Environments +intro: You can configure environments with protection rules and secrets. A workflow job can reference an environment to use the environment's protection rules and secrets. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About environments + +You can configure environments with protection rules and secrets. When a workflow job references an environment, the job won't start until all of the environment's protection rules pass. A job also cannot access secrets that are defined in an environment until all the environment protection rules pass. + +{% if currentVersion == "free-pro-team@latest" %} +Environment protection rules and environment secrets are only available on public repositories. If you convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. +{% endif %} + +#### Environment protection rules + +Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use environment protection rules to require a manual approval or to delay a job. + +##### Required reviewers + +Use required reviewers to require a specific person or team to approve workflow jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed. + +For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +##### Wait timer + +Use a wait timer to delay a job for a specific amount of time after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days). + +#### Environment secrets + +Secrets stored in an environment are only available to workflow jobs that reference the environment. If the environment requires approval, a job cannot access environment secrets until one of the required reviewers approves it. For more information about secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Creating an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click **New environment**. +1. Enter a name for the environment, then click **Configure environment**. Environment names are not case sensitive. An environment name may not exceed 255 characters and must be unique within the repository. +1. Configure any environment protection rules or environment secrets. + +Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment. + +### Referencing an environment + +Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. When the job is sent to the runner, the job can access the environment's secrets. + +For more information on syntax to reference environments in workflows, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)." For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +When a workflow references an environment, the environment will appear in the repository's deployments. For more information about viewing current and previous deployments, see "[Viewing deployment history](/developers/overview/viewing-deployment-history)." + +### Deleting an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +Deleting an environment will delete all secrets and protection rules associated with the environment. Any jobs currently waiting because of protection rules from the deleted environment will automatically fail. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Next the the environment that you want to delete, click {% octicon "trashcan" aria-label="The trashcan icon" %}. +2. Click **I understand, delete this environment**. 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 10d113b915a0..8a8a79a0f2b1 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 @@ -309,9 +309,9 @@ Führt den Workflow aus, wenn das Ereignis `issue_comment` eintritt. {% data reu {% data reusables.github-actions.branch-requirement %} -| 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 | +| Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | --------------------------------- | --------------- | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
- `edited`
- `deleted`
| Letzter Commit im Standard-Branch | Standard-Branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -534,7 +534,7 @@ on: #### `pull_request_review` -Führt Deinen Workflow aus, wenn das Ereignis `pull_request_review` eintritt. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Pull request reviews](/rest/reference/pulls#reviews)." +Führt den Workflow aus, wenn das Ereignis `pull_request_review` eintritt. {% data reusables.developer-site.multiple_activity_types %} For information about the REST API, see "[Pull request reviews](/rest/reference/pulls#reviews)." | Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | | ---------------------------------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------- | ------------------------------------------- | @@ -576,7 +576,13 @@ on: #### `pull_request_target` -This event is similar to `pull_request`, except that it runs in the context of the base repository of the pull request, rather than in the merge commit. This means that you can more safely make your secrets available to the workflows triggered by the pull request, because only workflows defined in the commit on the base repository are run. For example, this event allows you to create workflows that label and comment on pull requests, based on the contents of the event payload. +This event runs in the context of the base of the pull request, rather than in the merge commit as the `pull_request` event does. This prevents executing unsafe workflow code from the head of the pull request that could alter your repository or steal any secrets you use in your workflow. This event allows you to do things like create workflows that label and comment on pull requests based on the contents of the event payload. + +{% warning %} + +**Warning:** The `pull_request_target` event is granted a read/write repository token and can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch, and to help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. + +{% endwarning %} | Nutzlast des Webhook-Ereignisses | Aktivitätstypen | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | @@ -725,4 +731,4 @@ on: {% 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)“. -Wenn Du einen Workflow aus einem Workflow-Lauf auslösen möchtest, kannst Du das Ereignis mithilfe eines persönlichen Zugangs-Tokens auslösen. Du musst einen persönlichen Zugangs-Token erstellen und ihn als Geheimnis speichern. Um Dein Nutzungskosten für {% data variables.product.prodname_actions %} zu minimieren, pass auf, dass Du keine rekursiven oder unbeabsichtigten Workflow-Läufe erzeugst. Weitere Informationen findest Du unter „[Verschlüsselte Geheimnisse erstellen und speichern](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)“. +Wenn Du einen Workflow aus einem Workflow-Lauf auslösen möchtest, kannst Du das Ereignis mithilfe eines persönlichen Zugangs-Tokens auslösen. Du musst einen persönlichen Zugangs-Token erstellen und ihn als Geheimnis speichern. Um Dein Nutzungskosten für {% data variables.product.prodname_actions %} zu minimieren, pass auf, dass Du keine rekursiven oder unbeabsichtigten Workflow-Läufe erzeugst. For more information on storing a personal access token as a secret, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." diff --git a/translations/de-DE/content/actions/reference/index.md b/translations/de-DE/content/actions/reference/index.md index f2d5d6b2469f..007f0736926c 100644 --- a/translations/de-DE/content/actions/reference/index.md +++ b/translations/de-DE/content/actions/reference/index.md @@ -27,11 +27,19 @@ You can configure workflows to run when specific GitHub events occur, at a sched ### 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. +{% 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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environments{% else %} or repository{% endif %}. {% data variables.product.prodname_dotcom %} encrypts all secrets. {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Environments + +Workflow jobs can reference environments that have protection rules or environment-specific secrets. + +{% link_in_list /environments %} +{% endif %} + ### {% 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. 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 99dd441c6b7d..519cc8d08d2b 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 @@ -305,11 +305,13 @@ steps: `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. +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### Beispiel +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 f59527d0ee44..a30b82620101 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 @@ -187,7 +187,7 @@ Weitere Informationen zur Cron-Syntax findest Du unter „[Ereignisse, die Workf ### `env` -Eine `map` mit Umgebungsvariablen, die für alle Jobs und Schritte im Workflow verfügbar sind. Darüber hinaus kannst Du auch Umgebungsvariablen festlegen, die ausschließlich für einen Job oder Schritt bereitstehen. Weitere Informationen findest Du unter [`jobs..env`](#jobsjob_idenv) und [`jobs..steps.env`](#jobsjob_idstepsenv). +Eine `map` mit Umgebungsvariablen, die für alle Jobs und Schritte im Workflow verfügbar sind. Darüber hinaus kannst Du auch Umgebungsvariablen festlegen, die ausschließlich für einen Job oder Schritt bereitstehen. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: Ein Workflow-Lauf besteht aus mindestens einem Auftrag. Die Aufträge werden standardmäßig parallel ausgeführt. Sollen Aufträge sequenziell ausgeführt werden, können Sie mit dem Stichwort `jobs..needs` eine Abhängigkeit von anderen Aufträgen definieren. -Jeder Job läuft in einer Umgebung, die mit `runs-on` angegeben wird. +Each job runs in a runner environment specified by `runs-on`. 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. @@ -320,6 +320,39 @@ 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)“. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +The environment that the job references. All environment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." + +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[Deployments](/rest/reference/repos#deployments)." + +##### Example using a single environment name + +```yaml +environment: staging_environment +``` + +##### Example using environment name and URL + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +The URL can be an expression and can use any context except for the `secrets` context. For more information about expressions, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +#### Beispiel +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `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). @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -Eine `map` mit Umgebungsvariablen, die für alle Schritte im Auftrag verfügbar sind. Darüber hinaus können Sie Umgebungsvariablen für den gesamten Workflow oder für einen einzelnen Schritt festlegen. Weitere Informationen finden Sie unter [`env`](#env) und [`jobs..steps.env`](#jobsjob_idstepsenv). +Eine `map` mit Umgebungsvariablen, die für alle Schritte im Auftrag verfügbar sind. Darüber hinaus können Sie Umgebungsvariablen für den gesamten Workflow oder für einen einzelnen Schritt festlegen. For more information, see [`env`](#env) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `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)“. -### `jobs..steps.if` +### `jobs..steps[*].if` Mit der Bedingung `if` gibst Du an, dass ein Schritt nur dann ausgeführt werden soll, wenn eine bestimmte Bedingung erfüllt ist. Du kannst eine Bedingung mit jedem unterstützten Kontext und Ausdruck erstellen. @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` Name Deines Schritts, der auf {% data variables.product.prodname_dotcom %} angezeigt wird. -### `jobs..steps.uses` +### `jobs..steps[*].uses` Wählt eine Aktion aus, die als Teil eines Schritts im Auftrag ausgeführt wird. Eine Aktion ist eine wiederverwendbare Code-Einheit. Sie können eine Aktion verwenden, die im selben Repository wie der Workflow, in einem öffentlichen Repository oder in einem [veröffentlichten Docker-Container-Image](https://hub.docker.com/) definiert ist. @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` Führt Befehlszeilen-Programme über die Betriebssystem-Shell aus. Wenn Du keinen `name` angibst, wird standardmäßig der im Befehl `run` angegebene Text als Name für den Schritt übernommen. @@ -675,7 +708,7 @@ Für integrierte Shell-Schlüsselwörter gelten die folgenden Standards, die dur - Wenn Du das Fail-Fast-Verhalten uneingeschränkt nutzen möchtest, hast Du anscheinend keine andere Wahl, als Dein Skript so zu schreiben, dass jeder Fehlercode geprüft und eine entsprechende Reaktion eingeleitet wird. Dieses Verhalten kann nicht standardmäßig bereitgestellt werden; Du musst es explizit in Dein Skript schreiben. - `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. Dieses Verhalten ist intern mit dem vorherigen Standardverhalten von `sh` und `pwsh` konsistent und ist der Standard für `cmd.exe`, weshalb dieses Verhalten unverändert bleibt. -### `jobs..steps.with` +### `jobs..steps[*].with` Eine `map` der Eingabeparameter, die in der Aktion definiert sind. Jeder Eingabeparameter ist ein Schlüssel-Wert-Paar. Eingabeparameter werden als Umgebungsvariablen festgelegt. Die Variable erhält das Präfix `INPUT_` und wird in Großbuchstaben umgewandelt. @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` Ein `string`, der die Eingaben für einen Docker-Container definiert. Beim Start des Containers übergibt {% data variables.product.prodname_dotcom %} die `args`-Anweisung an den `ENTRYPOINT` des Containers. Ein `array of strings` wird von diesem Parameter nicht unterstützt. @@ -718,7 +751,7 @@ 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` +### `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. @@ -734,7 +767,7 @@ steps: The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs. -### `jobs..steps.env` +### `jobs..steps[*].env` Legt Umgebungsvariablen für Schritte fest, die in der Runner-Umgebung verwendet werden sollen. Darüber hinaus können Sie Umgebungsvariablen für den gesamten Workflow oder für einen Auftrag festlegen. Weitere Informationen finden Sie unter [`env`](#env) und [`jobs..env`](#jobsjob_idenv). @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` Verhindert das Fehlschlagen eines Auftrags, wenn ein Schritt fehlschlägt. Leg `true` fest, damit ein Auftrag auch dann erfolgreich abgeschlossen werden kann, wenn dieser Schritt fehlschlägt. -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` Maximaler Zeitraum in Minuten für die Ausführung des Schritts, bevor der Prozess abgebrochen wird. @@ -769,7 +802,7 @@ Die maximale Anzahl von Minuten, die ein Job ausgeführt wird, bevor {% data var ### `jobs..strategy` -Mit einer Strategie wird eine Build-Matrix für die Aufträge erstellt. Sie können verschiedene Varianten einer Umgebung definieren, in denen die einzelnen Aufträge ausgeführt werden. +Mit einer Strategie wird eine Build-Matrix für die Aufträge erstellt. You can define different variations to run each job in. ### `jobs..strategy.matrix` diff --git a/translations/de-DE/content/admin/configuration/configuring-email-for-notifications.md b/translations/de-DE/content/admin/configuration/configuring-email-for-notifications.md index 06bc6623bdbf..7c37675b3149 100644 --- a/translations/de-DE/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/de-DE/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ Your dedicated technical account manager in {% data variables.contact.github_support %} can configure email for notifications to be sent through your SMTP server. Make sure you include the following details in your support request. - Your SMTP server address +- Login information to authenticate to the server: username and password - The port your SMTP server uses to send email - The domain name that your SMTP server will send with a HELO response, if any - The type of encryption used by your SMTP server 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 b531327a98b4..ed893a4ac087 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 @@ -94,7 +94,7 @@ For urgent issues, we can help you in English 24 hours per day, 7 days per week, | Tag nach Thanksgiving | Vierter Freitag im November | | Heiligabend | 24. Dezember | | 1. Weihnachtsfeiertag | 25. Dezember | -| 2. Weihnachtsfeiertag | 26. Dezember | +| 2. Weihnachtsfeiertag | 28. Dezember | | Silvester | 31. Dezember | #### Feiertage in Japan 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 26dd60512799..dc000a3ae97e 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 @@ -44,7 +44,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in {% data variables.contact.enterprise_support %} beobachtet diese Feiertage in den USA. holidays. -| U.S. Weihnachtsfeiertag | Datum im Jahr 2018 | +| U.S. Weihnachtsfeiertag | Date observed | | ----------------------- | ------------------------------ | | Neujahr | 1. Januar | | Martin Luther King Day | Dritter Montag im Januar | @@ -57,7 +57,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in | Tag nach Thanksgiving | Vierter Freitag im November | | Heiligabend | 24. Dezember | | 1. Weihnachtsfeiertag | 25. Dezember | -| 2. Weihnachtsfeiertag | 26. Dezember | +| 2. Weihnachtsfeiertag | 28. Dezember | | Silvester | 31. Dezember | ### {% data variables.product.prodname_advanced_security %}-Updates installieren 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 9014ddded96b..28791c87f409 100644 --- a/translations/de-DE/content/admin/overview/about-enterprise-accounts.md +++ b/translations/de-DE/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ An enterprise account allows you to manage multiple organizations{% if enterpris - Security {% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication) - Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} 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 7eafa957d76c..ac74bd1e7ffc 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 @@ -51,6 +51,7 @@ GitHub Desktop-Tastenkürzel auf macOS | ⌘2 | Commit-Verlauf anzeigen | | ⌘B | Alle Ihre Branches anzeigen | | ⌘G | Zum Commit-Zusammenfassungsfeld navigieren | +| ⌘Enter | Commit changes when summary or description field is active | | space (Leerzeichen) | Select or deselect all highlighted files | | ⇧⌘N | Neuen Branch erstellen | | ⇧⌘R | Aktuellen Branch umbenennen | @@ -104,6 +105,7 @@ GitHub Desktop-Tastenkürzel auf Windows | STRG2 | Commit-Verlauf anzeigen | | STRGB | Alle Ihre Branches anzeigen | | STRGG | Zum Commit-Zusammenfassungsfeld navigieren | +| CtrlEnter | Commit changes when summary or description field is active | | space (Leerzeichen) | Select or deselect all highlighted files | | STRGUMSCHALTN | Neuen Branch erstellen | | STRGUMSCHALTR | Aktuellen Branch umbenennen | 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 79cc6b49eb0e..70b79256766f 100644 --- a/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/de-DE/content/developers/apps/authorizing-oauth-apps.md @@ -265,7 +265,9 @@ The optional `redirect_uri` parameter can also be used for localhost URLs. If th For the `http://localhost/path` callback URL, you can use this `redirect_uri`: - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### Creating multiple tokens for OAuth Apps 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 f93dbcf20dc5..06d9606f793e 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 @@ -49,39 +49,39 @@ The complete list of available query parameters, permissions, and events is list 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 | -| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 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](/rest/reference/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](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`. | +| [`checks (Prüfungen)`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | +| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/rest/reference/users#emails). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`follower`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/users#keys). 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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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 %}. | +| [`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](/rest/reference/orgs#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/rest/reference/interactions#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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/repos#hooks). Can be one of: `none`, `read`, or `write`. | +| [`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](/rest/reference/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](/rest/reference/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](/rest/reference/projects). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} | [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Grants access to the [Secret scanning API](/rest/reference/secret-scanning). Can be one of: `none`, `read`, or `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | Grants access to the [Code scanning API](/rest/reference/code-scanning/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/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`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/teams#discussion-comments). Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `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`.{% endif %} +| `beobachten` | 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 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 ad3c3830ad4b..4b48f0dd5768 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 @@ -85,7 +85,7 @@ Unlike OAuth apps, GitHub Apps have targeted permissions that allow them to requ | GitHub Apps | OAuth Apps | | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they needs to receive events from. | +| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they need to receive events from. | | GitHub Apps receive certain organization-level events with the organization member's permission. | OAuth Apps request the organization webhook scope to create an organization webhook for each organization they need to receive organization-level events from. | ### Git access 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 193fe293ece2..d294e3c1d397 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 @@ -67,7 +67,7 @@ If the user accepts your request, GitHub redirects back to your site with a temp {% endnote %} -Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." +Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." 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 %} 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 caf739366085..bccc484a16f3 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 @@ -7,13 +7,11 @@ versions: free-pro-team: '*' --- -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} -{% endif %} ### Suspending a GitHub App diff --git a/translations/de-DE/content/developers/apps/using-content-attachments.md b/translations/de-DE/content/developers/apps/using-content-attachments.md index 296e36840ced..d963d9ed3644 100644 --- a/translations/de-DE/content/developers/apps/using-content-attachments.md +++ b/translations/de-DE/content/developers/apps/using-content-attachments.md @@ -166,7 +166,7 @@ To create a Probot App, follow these steps: } ``` -4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to [localhost:3000](http://localhost:3000), and click the **Register GitHub App** button: +4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to `http://localhost:3000`, and click the **Register GitHub App** button: ![Register a Probot GitHub App](/assets/images/github-apps/github_apps_probot-registration.png) diff --git a/translations/de-DE/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/de-DE/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index 9252c41ece19..342754e94dfb 100644 --- a/translations/de-DE/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/de-DE/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -4,6 +4,5 @@ intro: 'You can list free and paid tools for developers to use in {% data variab mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/de-DE/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/de-DE/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index aa9d924b4990..8e765778101b 100644 --- a/translations/de-DE/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/de-DE/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -48,7 +48,7 @@ Customers can start a free trial for any paid plan on a Marketplace listing that Free trials have a fixed length of 14 days. Customers are notified 4 days before the end of their trial period (on day 11 of the free trial) that their plan will be upgraded. At the end of a free trial, customers will be auto-enrolled into the plan they are trialing if they do not cancel. -For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)." +For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/handling-new-purchases-and-free-trials/)." {% note %} diff --git a/translations/de-DE/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/de-DE/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index 3c8a760f5854..0264e77e2ec2 100644 --- a/translations/de-DE/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/de-DE/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -13,8 +13,14 @@ versions: -After your {% data variables.product.prodname_marketplace %} listing is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the onboarding process. +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -Once your revenue reaches a minimum of $500 U.S. Dollars for the month, you'll receive an electronic payment from {% data variables.product.product_name %} for 75% of the sales price. +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/de-DE/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/de-DE/content/developers/github-marketplace/requirements-for-listing-an-app.md index 2ae24c334eef..a6c8b8745645 100644 --- a/translations/de-DE/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/de-DE/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -53,7 +53,7 @@ In addition to the requirements for all apps above, each app that you offer as a - {% data variables.product.prodname_github_app %}s should have a minimum of 100 installations. - {% data variables.product.prodname_oauth_app %}s should have a minimum of 200 users. - All paid apps must handle {% data variables.product.prodname_marketplace %} purchase events for new purchases, upgrades, downgrades, cancellations, and free trials. For more information, see "[Billing requirements for paid apps](#billing-requirements-for-paid-apps)" below. -- Publishing organizations must have a verified domain and must enable two-factor authentication. 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.") +- Publishing organizations must have a verified domain and must enable two-factor authentication. Weitere Informationen finden Sie unter „[Zwei-Faktor-Authentifizierung in Ihrer Organisation erzwingen](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)“. When you are ready to publish the app on {% data variables.product.prodname_marketplace %} you must request verification for the listing. diff --git a/translations/de-DE/content/developers/overview/index.md b/translations/de-DE/content/developers/overview/index.md index c674b911aaa4..c2114dfe907d 100644 --- a/translations/de-DE/content/developers/overview/index.md +++ b/translations/de-DE/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 61c9d8151a10..dbaba31673d1 100644 --- a/translations/de-DE/content/developers/overview/managing-deploy-keys.md +++ b/translations/de-DE/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ If you don't want to use SSH keys, you can use [HTTPS with OAuth tokens][git-aut * Users don't have to change their local SSH settings. * Multiple tokens (one for each user) are not needed; one token per server is enough. * A token can be revoked at any time, turning it essentially into a one-use password. +{% if enterpriseServerVersions contains currentVersion %} * Generating new tokens can be easily scripted using [the OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization). +{% endif %} ##### Cons diff --git a/translations/de-DE/content/developers/overview/viewing-deployment-history.md b/translations/de-DE/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..bd0b394f48d5 --- /dev/null +++ b/translations/de-DE/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: Viewing deployment history +intro: View current and previous deployments for your repository. +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +You can deliver deployments through {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %} and environments or with {% endif %}the REST API and third party apps. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}For more information about {% data variables.product.prodname_actions %}, see "[{% data variables.product.prodname_actions %}](/actions)." {% endif %}For more information about deployments with the REST API, see "[Repositories](/rest/reference/repos#deployments)." + +To view current and past deployments, click **Environments** on the home page of your repository. ![Environments](/assets/images/environments-sidebar.png) + +The deployments page displays the last active deployment of each environment for your repository. If the deployment includes an environment URL, a "View deployment" button that links to the URL is shown next to the deployment. + +The activity log shows the deployment history for your environments. By default, only the most recent deployment for an environment has an `Active` status; all previously active deployments have an `Inactive` status. For more information on automatic inactivation of deployments, see "[Inactive deployments](/rest/reference/repos#inactive-deployments)." + +You can also use the REST API to get information about deployments. For more information, see "[Repositories](/rest/reference/repos#deployments)." 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 3a0487ec74bf..2040ac3c3f2f 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 @@ -91,7 +91,7 @@ The base reference branch of the pull request changed. |:------------------------- |:----------------:|:-------------------:| |
  • Pull Requests
| **X** | | - ### Event object properties +#### Event object properties {% data reusables.issue-events.issue-event-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 558685831253..600e65ad1cfe 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 @@ -71,7 +71,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) 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 465752787497..28f951075f75 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 @@ -430,7 +430,7 @@ When someone revokes their authorization of a {% data variables.product.prodname {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} For more information, see "[Suspending a {% data variables.product.prodname_github_app %} installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." @@ -715,7 +715,7 @@ The webhook this event is configured on was deleted. This event will only listen ### paketieren -Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/rest/reference/orgs#blocking)" REST API. For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. +Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. #### Availability @@ -1125,9 +1125,11 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory Activity related to a security advisory. A security advisory provides information about security-related vulnerabilities in software on GitHub. The security advisory dataset also powers the GitHub security alerts, see "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies/)." +{% endif %} #### Availability diff --git a/translations/de-DE/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/de-DE/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index d4db1b9c1d18..519526c36158 100644 --- a/translations/de-DE/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/de-DE/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -28,4 +28,4 @@ To create and access the feedback pull request, you must enable the feedback pul ### Weiterführende Informationen -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/de-DE/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/de-DE/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index f0d43700593e..f8de2b9f795d 100644 --- a/translations/de-DE/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/de-DE/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -18,7 +18,7 @@ Damit Du ein {% data variables.product.prodname_student_pack %} nutzen kannst, m - Ein [{% data variables.product.prodname_dotcom %}-Benutzerkonto](/articles/signing-up-for-a-new-github-account) besitzen, - Mindestens 13 Jahre alt sein -Zu den Dokumenten, die Deinen aktuellen Status als Schüler oder Student belegen, gehören ein Bild Deines Schulausweises, Deines Stundenplans und Deiner Zeugnisse sowie ein Schreiben zur Bestätigung der Mitgliedschaft oder Immatrikulation. +Documents that prove your current student status include a picture of your school ID with current enrollment date, class schedule, transcript, and affiliation or enrollment verification letter. Während Deiner Zeit als Student wirst Du möglicherweise dazu aufgefordert, in regelmäßigen Abständen Deinen aktuellen akademischen Status zu bestätigen. 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 a91bea687406..3a1bc4712a41 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 @@ -11,17 +11,21 @@ versions: github-ae: '*' --- +### Informationen zu geschützten Branches + {% data reusables.pull_requests.about-protected-branches %} Du kannst entscheiden, Einschränkungen zu erzwingen über die Art und Weise, wie ein Pull Request in Dein Repository zusammengeführt wird. Durch das Erstellen von Regeln für geschützte Branches können Repository-Inhaber und Personen mit Administratorberechtigung für ein Repository bestimmte Workflows oder Anforderungen erzwingen, bevor ein Mitarbeiter einen Branch in Dein Repository überführen kann. {% data reusables.repositories.branch-rules-example %} Weitere Informationen findest Du unter „[Geschützte Branches konfigurieren](/articles/configuring-protected-branches/).“ +{% data reusables.pull_requests.you-can-auto-merge %} + ### Priorisierung von Regeln für geschützte Branches -Wenn ein Repository mehrere Branch-Schutzregeln hat, die dieselben Branches betreffen, haben die Regeln, die einen spezifischen Branch-Namen enthalten, die höchste Priorität. Wenn es mehr als eine Branch-Schutzregel gibt, die auf den gleichen spezifischen Branch-Namen verweist, hat die zuerst erstellte Branch-Regel eine höhere Priorität. +Wenn es für ein Repository mehrere Regeln für geschützte Branches gibt, die dieselben Branches betreffen, haben die Regeln, die einen spezifischen Branch-Namen enthalten, die höchste Priorität. Wenn es mehr als eine Regel für geschützte Branches gibt, die auf den gleichen spezifischen Branch-Namen verweist, hat die zuerst erstellte Branch-Regel eine höhere Priorität. -Branch-Schutzregeln mit einem Sonderzeichen, wie `*`, `?` oder `]` werden in der Reihenfolge ihrer Erstellung angewendet, sodass ältere Regeln mit diesen Zeichen eine höhere Priorität haben. +Regeln für geschützte Branches mit einem Sonderzeichen, wie `*`, `?` oder `]`, werden in der Reihenfolge ihrer Erstellung angewendet, sodass ältere Regeln mit diesen Zeichen eine höhere Priorität haben. ### Einstellungen für geschützte Branches 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 e07d5cfeb507..065ddcc34139 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: '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.' +intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 52b4a0d2e6a3..45b6724fc5a3 100644 --- a/translations/de-DE/content/github/administering-a-repository/index.md +++ b/translations/de-DE/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/de-DE/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/de-DE/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..e19203c0666a --- /dev/null +++ b/translations/de-DE/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Managing auto-merge for pull requests in your repository +intro: "You can allow or disallow auto-merge for pull requests in your repository." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Under "Merge button", select or deselect **Allow auto-merge**. ![Checkbox to allow or disallow auto-merge](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file 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 5f1b998c9c49..5d8569526d02 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 @@ -24,7 +24,7 @@ We recommend reviewing the following caveats before you change the visibility of * 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. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}The visibility of any forks will also change to private.{% elsif currentVersion == "github-ae@latest" %}If the internal repository has any forks, the visibility of the forks is already private.{% 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)"{% 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 %}{% endif %} * Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -* {% 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 enterpriseServerVersions contains currentVersion %} +* {% data variables.product.prodname_dotcom %} will no longer include 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 enterpriseServerVersions contains currentVersion %} * 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 %} {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 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 8af46b96f44c..8d9e2024f20d 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 @@ -38,7 +38,7 @@ Wenn eine {% data variables.product.prodname_oauth_app %} Sie anhand Ihres {% da *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 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)." +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 %} 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 457ac0c8d0dd..7a58c5c3a7f4 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 @@ -32,7 +32,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 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)." +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 %} diff --git a/translations/de-DE/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/de-DE/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index 52127b14d03c..21626b4046da 100644 --- a/translations/de-DE/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/de-DE/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -126,8 +126,8 @@ Bevor Du einen neuen SSH-Schlüssel zum SSH-Agenten für die Verwaltung Deiner S 1. Stellen Sie sicher, dass ssh-agent ausgeführt wird. You can use the "Auto-launching the ssh-agent" instructions in "[Working with SSH key passphrases](/articles/working-with-ssh-key-passphrases)", or start it manually: ```shell - # Den SSH-Agenten im Hintergrund starten - $ eval $(ssh-agent -s) + # start the ssh-agent in the background + $ eval `ssh-agent -s` > Agent pid 59566 ``` 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 81b81c2bc9e7..5d38582f6570 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 @@ -31,7 +31,7 @@ Für den Test Deiner Verbindung musst Du diese Aktion mit Deinem Passwort authen > Are you sure you want to continue connecting (yes/no)? ``` -3. Vergewissere Dich, dass der in dieser Meldung angegebene Fingerprint mit einem der Fingerprints der Meldungen aus Schritt 2 übereinstimmt, und gib dann `yes` ein: +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Hi username! You've successfully authenticated, but GitHub does not > provide shell access. diff --git a/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..c67c7ba7a0db --- /dev/null +++ b/translations/de-DE/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: Automatically merging a pull request +intro: 'You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### About auto-merge + +If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks. + +Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)." + +You can provide feedback about auto-merge by [contacting us](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback). + +### Enabling auto-merge + +People with write permissions to a repository can enable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to auto-merge. +1. Optionally, to choose a merge method, select the **Enable auto-merge** drop-down menu, then click a merge method. Weitere Informationen finden Sie unter „[Informationen zum Mergen von Pull Requests](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)“. !["Enable auto-merge" drop-down menu](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. Click **Enable auto-merge**. ![Button to enable auto-merge](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. If you chose the merge or squash and merge methods, type a commit message and description and choose the email address you want to author the merge commit. ![Fields to enter commit message and description and choose commit author email](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. Click **Confirm auto-merge**. ![Button to confirm auto-merge](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### Disabling auto-merge + +People with write permissions to a repository and pull request authors can disable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to disable auto-merge for. +1. In the merge box, click **Disable auto-merge**. ![Button to disable auto-merge](/assets/images/help/pull_requests/disable-auto-merge-button.png) 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 f509671c5d70..6f52a1aa1f20 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 @@ -3,7 +3,7 @@ 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. 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: Anyone with write access to a repository can create a pull request from a user-owned fork. versions: free-pro-team: '*' enterprise-server: '*' 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 6a1f436ac416..633c8ac66122 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 @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 8c217fe30b99..57c71e9a466f 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 @@ -14,13 +14,15 @@ versions: Mit einem Pull Request schlägst Du vor, dass Änderungen, die Du an einem Head-Branch gemacht hast, in einen Basis-Branch zusammengeführt werden sollten. {% data reusables.pull_requests.about-protected-branches %} Es kann jedoch Einschränkungen geben, wann Du einen Pull Request zu einem bestimmten Branch zusammenführen kannst. For example, you may only be able to merge a pull request into the default branch if required status checks are passing. Weitere Informationen findest Du unter „[Informationen zu geschützten Branches](/github/administering-a-repository/about-protected-branches).“ -Wenn beim Pull Request Mergekonflikte vorliegen oder Du die Änderungen vor dem Zusammenführen testen möchtest, kannst Du [den Pull Request lokal auschecken](/articles/checking-out-pull-requests-locally) und ihn über die Befehlszeile zusammenführen. +{% data reusables.pull_requests.you-can-auto-merge %} + +Wenn beim Pull Request Mergekonflikte vorliegen oder Sie die Änderungen vor dem Mergen testen möchten, können Sie [den Pull Request lokal auschecken](/articles/checking-out-pull-requests-locally) und ihn über die Befehlszeile mergen. Pull-Request-Entwürfe kannst du nicht zusammenführen. Weitere Informationen zu Entwürfen von Pull Requests findest Du unter „[Informationen zu Pull Requests](/articles/about-pull-requests#draft-pull-requests).“ {% data reusables.pull_requests.automatically-delete-branches %} -Wenn Du die Änderungen in einem Themen-Branch nicht in den vorgelagerten Branch zusammenführen möchtest, kannst Du [den Pull Request schließen](/articles/closing-a-pull-request), ohne ihn zusammenzuführen. +Wenn Sie die Änderungen in einem Themen-Branch nicht in den vorgelagerten Branch mergen möchten, können Sie [den Pull Request schließen](/articles/closing-a-pull-request), ohne ihn zu mergen. ### Einen Pull Request auf {% data variables.product.prodname_dotcom %} zusammenführen 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 309effd0a63c..d11a128b1c2e 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 @@ -296,7 +296,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Accessing private repositories -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)." +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 `ghost/foo`, `ghost/bar`, and `ghost/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. 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 index c071341bd52a..24c418cc5751 100644 --- 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 @@ -54,7 +54,7 @@ On Windows, the `codeql-runner-win.exe` file usually requires no change to permi 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 +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux chmod +x codeql-runner-linux ``` @@ -129,7 +129,7 @@ This example is similar to the previous example, however this time the repositor > ... > 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 " + Please export these variables to future processes so that CodeQL can monitor the build, for example by running " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` 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 4f03a25e7492..a38e1da3862e 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 @@ -11,7 +11,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" %}If you're experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% 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 {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 b887b58ebb29..9e8e5c21e4aa 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 @@ -33,7 +33,7 @@ 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" %}If you experiencing abuse and want to ignore a repository, please [contact support](/contact) so we can help. {% 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 {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 7cabaf4af6e7..1775d0fc7811 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 @@ -27,10 +27,11 @@ Aufgrund der Komplexität der Codesuche gelten bei der Durchführung der Suche E - Only the _default branch_ is indexed for code search.{% if currentVersion == "free-pro-team@latest" %} - Nur Dateien kleiner 384 KB sind durchsuchbar.{% else %}* Nur Dateien kleiner 5 MB sind durchsuchbar. - Nur die ersten 500 KB jeder Datei sind durchsuchbar.{% endif %} -- Nur Repositorys mit weniger als 500.000 Dateien sind durchsuchbar. -- Ihre Suchabfrage nach Code muss mindestens einen Suchbegriff enthalten. Ausgenommen hiervon sind Suchen nach [`filename`](#search-by-filename). Beispielsweise ist eine Suche nach [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) ungültig, [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) ist dagegen gültig. +- Only repositories with fewer than 500,000 files are searchable.{% if currentVersion == "free-pro-team@latest" %} +- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} +- Deine Quellcode-Suche muss mindestens einen Suchbegriff enthalten, ausgenommen bei [`filename`-Suchen](#search-by-filename). Beispielsweise ist eine Suche nach [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) ungültig, [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) ist dagegen gültig. - Die Suchergebnisse können maximal zwei gefundene Fragmente der gleichen Datei anzeigen, selbst wenn die Datei mehr Treffer enthält. -- Folgende Platzhalterzeichen können in Suchabfragen nicht verwendet werden: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. Diese Zeichen werden bei der Suche ignoriert. +- Folgende Platzhalterzeichen können in Suchabfragen nicht verwendet werden: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. Diese Zeichen werden bei der Suche schlicht ignoriert. ### Suche nach Dateiinhalten oder Dateipfad 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 af053937e740..ee0343d47e3d 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 @@ -39,6 +39,7 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late | 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** | | | +| Restrict email notifications to verified domains (see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)" for details) | **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** | | @@ -47,13 +48,13 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late | 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** | | +| Einblicke für die Organisation anzeigen (siehe „[Einblicke für Ihre 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 %} +| Die Anzeige von Einblicken zu den Abhängigkeiten einer Organisation verwalten (siehe „[Die Sichtbarkeit der Einblicke zu den Abhängigkeiten Ihrer 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** | | | | Sponsor accounts and manage the organization's sponsorships (see "[Sponsoring open-source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)" for details) | **X** | **X** | | | Manage email updates from sponsored accounts (see "[Managing updates from accounts your organization's sponsors](/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors)" for details) | **X** | | | 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 0108aee948ce..bac9364ad5d3 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 @@ -60,7 +60,8 @@ Neben der Berechtigung zum Verwalten der organisationsweiten Einstellungen haben | [Melden von Missbrauch oder Spam](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} | Anwenden von Kennzeichnungen | | **X** | **X** | **X** | **X** | | Create, edit, delete labels | | | **X** | **X** | **X** | -| Schließen, erneutes Eröffnen und Zuweisen aller Issues und Pull Requests | | **X** | **X** | **X** | **X** | +| Schließen, erneutes Eröffnen und Zuweisen aller Issues und Pull Requests | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Enable and disable auto-merge on a pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | 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** | diff --git a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index 46a3eec676ea..7d7295482284 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/de-DE/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -Wenn in einer Organisation beschränkte E-Mail-Benachrichtigungen aktiviert sind, können die Mitglieder der Organisation E-Mail-Benachrichtigungen zu den Aktivitäten der Organisation nur an E-Mail-Adressen innerhalb der hierfür verifizierten Domäne der Organisation erhalten. Weitere Informationen findest Du unter „[Domäne Deiner Organisation verifizieren](/articles/verifying-your-organization-s-domain).“ +### About email restrictions + +When restricted email notifications are enabled in an organization, members can only use an email address associated with the organization's verified domains to receive email notifications about organization activity. Weitere Informationen findest Du unter „[Domäne Deiner Organisation verifizieren](/articles/verifying-your-organization-s-domain).“ Externe Mitarbeiter unterliegen nicht den Einschränkungen für E-Mail-Benachrichtigungen für verifizierte Domänen. Weitere Informationen zu externen Mitarbeitern findest Du unter „[Berechtigungsebenen für eine Organisation](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)." +If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +### E-Mail-Benachrichtigungen auf eine genehmigte Domäne beschränken + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. Aktiviere unter „Enforcement preferences“ (Durchsetzungspräferenzen) das Kontrollkästchen **Restrict email notifications to domain email** (E-Mail-Benachrichtigungen auf eine genehmigte E-Mail-Domäne beschränken) aus. ![Kontrollkästchen zur Beschränkung von E-Mail-Benachrichtigungen auf eine genehmigte E-Mail-Domäne](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. Klicke auf **Save** (Speichern). 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 0e1aaac86781..9af638ff3a91 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 @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### About domain verification + 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 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. - -{% note %} - -**Hinweis:** Wenn die im Profil Deiner Organisation angezeigte E-Mail- und Websiteadresse Varianten derselben Domäne verwendet, musst Du beide Varianten verifizieren. Wenn das Profil Deiner Organisation beispielsweise die Website `www.example.com` und die E-Mail-Adresse `info@example.com` zeigt, musst Du sowohl `www.example.com` wie auch `example.com` verifizieren. +If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." -{% endnote %} +{% data reusables.organizations.verified-domains-details %} 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).“ +### Domänen Deiner Organisation überprüfen + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. Klicke auf **Add a domain** (Domäne hinzufügen). ![Schaltfläche „Add a domain“ (Domäne hinzufügen)](/assets/images/help/organizations/add-a-domain-button.png) -6. Gib im Domänen-Feld die Domäne ein, die verifiziert werden soll. Klicke anschließend auf **Add domain** (Domäne hinzufügen). ![Feld zum Hinzufügen einer Domäne](/assets/images/help/organizations/add-domain-field.png) -7. Befolge die unter **Add a DNS TXT record** (TXT-Eintrag für DNS hinzufügen) angegebenen Anweisungen, um mit Deinem Domänen-Hosting-Dienst einen TXT-Eintrag für DNS zu erstellen. Es kann bis zu 72 Stunden dauern, bis sich Deine DNS-Konfiguration ändert. Wechsle zum nächsten Schritt, sobald sich Deine DNS-Konfiguration geändert hat. ![Anweisungen zum Erstellen eines TXT-Eintrags für DNS](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **Tipp:** Du kannst bestätigen, dass sich Deine DNS-Konfiguration geändert hat. Führe dazu den Befehl `dig` auf der Befehlszeile aus. Ersetze im Beispiel den Wert `ORGANIZATION` durch den Namen Deiner Organisation und den Wert `example.com` durch die Domäne, die verifiziert werden soll. In der Befehlsausgabe sollte Dein neuer TXT-Eintrag aufgelistet werden. - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ORGANIZATION` with the name of your organization and `example.com` with the domain you'd like to verify. In der Befehlsausgabe sollte Ihr neuer TXT-Eintrag aufgelistet werden. ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - -8. Nachdem Du bestätigt hast, dass Deinem DNS-Eintrag der TXT-Eintrag hinzugefügt wurde, solltest Du in den Einstellungen Deiner Organisation zur Registerkarte „Verified domains“ (Verifizierte Domänen) navigieren. Du kannst die obigen Schritte eins bis vier durchführen, um nach der Registerkarte für verifizierte Domänen zu suchen. ![Seite mit Einstellungen zu verifizierten Domänen mit ausstehender Domäne](/assets/images/help/organizations/pending-domain-verification.png) -9. Klicke neben der Domäne, deren Verifizierung aussteht, auf {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} und anschließend auf **Continue verifying** (Verifizierung fortsetzen). ![Schaltfläche „Continue verifying“ (Verifizierung fortsetzen) für Domäne](/assets/images/help/organizations/continue-verifying-domain.png) -10. Klicke auf **Verify domain** (Domäne verifizieren). ![Schaltfläche „Verify domain“ (Domäne verifizieren)](/assets/images/help/organizations/verify-domain-final-button.png) -11. Sobald der Badge „Verified“ (Verifiziert) auf der Profilseite Deiner Organisation sichtbar ist, kannst Du den TXT-Eintrag im Domänen-Hosting-Dienst optional aus dem DNS-Eintrag löschen. ![Badge „Verified“ (Verifiziert)](/assets/images/help/organizations/verified-badge.png) +8. Nachdem Sie bestätigt haben, dass Ihrem DNS-Eintrag der TXT-Eintrag hinzugefügt wurde, sollten Sie in den Einstellungen Ihrer Organisation zur Registerkarte „Verified domains“ (Verifizierte Domains) navigieren. Sie können die Schritte eins bis vier durchführen, um nach der Registerkarte für verifizierte Domains zu suchen. ![Seite mit Einstellungen zu verifizierten Domains mit ausstehender Domain](/assets/images/help/organizations/pending-domain-verification.png) +{% data reusables.organizations.continue-verifying-domain %} +11. Sobald der Badge „Verified“ (Verifiziert) auf der Profilseite Ihrer Organisation sichtbar ist, können Sie den TXT-Eintrag im Domain-Hosting-Dienst optional aus dem DNS-Eintrag löschen.![Badge „Verified“ (Verifiziert)](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/index.md index 5c87c21c1da4..1bf2a1db9a97 100644 --- a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..ce267d7adb3b --- /dev/null +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restricting email notifications for your enterprise account to approved domains +intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can restrict email notifications for an enterprise account. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About email restrictions for your enterprise account + +When you restrict email notifications to verified domains, enterprise members can only use an email address associated with a verified domain to receive email notifications about activity in organizations owned by your enterprise account. The domains can be inherited from the enterprise account or configured for the specific organization. For more information about email restrictions for organizations, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +If email restrictions are enabled for an enterprise account, organization owners cannot disable email restrictions for any organization owned by the enterprise account. If changes occur that result in an organization having no verified domains, either inherited from an enterprise account that owns the organization or for the specific organization, email restrictions will be disabled for the organization. + +### Restricting email notifications for your enterprise account + +Before you can restrict email notifications for your enterprise account, you must verify at least one domain for the enterprise account. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. Klicke auf **Save** (Speichern). diff --git a/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..9bd6bcbc3394 --- /dev/null +++ b/translations/de-DE/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verifying your enterprise account's domain +intro: 'You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can verify an enterprise account's domain. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About domain verification + +You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. Weitere Informationen findest Du unter „[Domänen Deiner Organisation überprüfen](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain).“ + +After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. {% data reusables.organizations.verified-domains-details %} + +Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. + +After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "[Restricting email notifications for your enterprise account to approved domains](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)." + +Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +### Verifying your enterprise account's domain + +To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. Klicke auf **Add a domain** (Domäne hinzufügen). ![Schaltfläche „Add a domain“ (Domäne hinzufügen)](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ENTERPRISE-ACCOUNT` with the name of your enterprise account, and `example.com` with the domain you'd like to verify. In der Befehlsausgabe sollte Ihr neuer TXT-Eintrag aufgelistet werden. + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. ![Badge „Verified“ (Verifiziert)](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 8a12a261db2f..d43c45d0cf7f 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 @@ -46,7 +46,8 @@ Der Repository-Inhaber besitzt die vollständige Kontrolle über das Repository. | Codeinhaber für das Repository definieren | „[Informationen zu Codeinhabern](/github/creating-cloning-and-archiving-repositories/about-code-owners)“ | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Sicherheitshinweise erstellen | "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Eine Sponsorenschaltfläche anzeigen | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Eine Sponsorenschaltfläche anzeigen | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| Aktion | Weitere Informationen | -|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Fork the repository | „[Über Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
  • "[About issues](/github/managing-your-work-on-github/about-issues)"
  • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
  • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
| -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | „[Meilensteine für Issues und Pull Requests erstellen und bearbeiten](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)“ | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | „[Einen Pull Request von einem Fork erstellen](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)“ | -| Submit a review on a pull request that affects the mergeability of the pull request | „[Vorgeschlagene Änderungen in einem Pull Request überprüfen](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | -| Create and edit a wiki for the repository | „[Informationen zu Wikis](/github/building-a-strong-community/about-wikis)“ | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| Aktion | Weitere Informationen | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Fork the repository | „[Über Forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
  • "[About issues](/github/managing-your-work-on-github/about-issues)"
  • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
  • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
| +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | „[Meilensteine für Issues und Pull Requests erstellen und bearbeiten](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)“ | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | „[Einen Pull Request von einem Fork erstellen](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)“ | +| Submit a review on a pull request that affects the mergeability of the pull request | „[Vorgeschlagene Änderungen in einem Pull Request überprüfen](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | +| Create and edit a wiki for the repository | „[Informationen zu Wikis](/github/building-a-strong-community/about-wikis)“ | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| sich selbst als Mitarbeiter aus dem Repository entfernen | „[Dich selbst aus dem Repository eines Mitarbeiters entfernen](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)“ | +| sich selbst als Mitarbeiter aus dem Repository entfernen | „[Dich selbst aus dem Repository eines Mitarbeiters entfernen](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)“ | ### Weiterführende Informationen 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 52a69a7135ca..70d4eb12aa38 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 @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} analyzes your {% data var product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. diff --git a/translations/de-DE/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/de-DE/content/github/site-policy/github-marketplace-developer-agreement.md index 6a1c37f520b7..142c5427a356 100644 --- a/translations/de-DE/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/de-DE/content/github/site-policy/github-marketplace-developer-agreement.md @@ -8,7 +8,7 @@ versions: **DIESE BESTIMMUNGEN UND BEDINGUNGEN (DIE "VEREINBARUNG") REGELN IHRE TEILNAHME AM GITHUB MARKETPLACE-PROGRAMM. DURCH DIE ANMELDUNG ZUR TEILNAHME AM MARKETPLACE-PROGRAMM ODER DURCH KLICKEN AUF "ICH AKZEPTIERE" UNTEN BESTÄTIGEN SIE, DASS SIE DIESE VEREINBARUNG VERSTANDEN HABEN UND DASS SIE ALLE IHRE BESTIMMUNGEN UND BEDINGUNGEN AKZEPTIEREN. WENN SIE DIESE VEREINBARUNG IM NAMEN EINES UNTERNEHMENS ODER EINER ANDEREN JURISTISCHEN PERSON ABSCHLIEßEN, VERSICHERN SIE, DASS SIE RECHTLICH BEFUGT SIND, DIE PERSON AN DIESE VEREINBARUNG ZU BINDEN. IN DIESEM FALL BEDEUTET "SIE" DIE PERSON, DIE SIE VERTRETEN.** -Effective Date: July 21, 2020 +Effective Date: January 1, 2021 ### 1. DEFINITIONEN @@ -143,7 +143,7 @@ Für den Fall, dass Ihr Angebot zwangsläufig entfernt wird, weil es fehlerhaft **6.1** GitHub fungiert als Vertragspartner für Entwicklerprodukte, die von Endbenutzern über den Marketplace gekauft werden. -**6.2** Preise für Marketplace-Angebote von Entwickleranwendungen werden in US-Dollar (USD) festgelegt. Der Entwickler hat die vollständige Kontrolle über die Festlegung von Preisen für jedes Angebot, und sobald diese Preise festgelegt sind, können diese Preise nicht geändert werden. Sie können eine Preisübersicht für ein bestehendes Angebot zurückziehen und eine neue Preisübersicht für ein solches Angebot hinzufügen, unter der Voraussetzung, dass sich diese neue Preisübersicht nicht negativ auf bestehende Endnutzer auswirkt. Die Preise, die Sie für Entwicklerprodukte festlegen, bestimmen den Zahlungsbetrag, den Sie erhalten. GitHub überweist 75% des Verkaufspreises in USD ohne Abzug von Steuern mit Ausnahme von Quellensteuern, die nach geltendem Recht erforderlich sind. Die restlichen 25 % des Verkaufspreises werden GitHub zugeteilt und einbehalten. GitHub überweist Ihnen am Ende jedes Monats und sobald ein Mindestbetrag von 500 USD erreicht wird, Ihren Zahlungsanteil. +**6.2** Preise für Marketplace-Angebote von Entwickleranwendungen werden in US-Dollar (USD) festgelegt. Der Entwickler hat die vollständige Kontrolle über die Festlegung von Preisen für jedes Angebot, und sobald diese Preise festgelegt sind, können diese Preise nicht geändert werden. Sie können eine Preisübersicht für ein bestehendes Angebot zurückziehen und eine neue Preisübersicht für ein solches Angebot hinzufügen, unter der Voraussetzung, dass sich diese neue Preisübersicht nicht negativ auf bestehende Endnutzer auswirkt. Die Preise, die Sie für Entwicklerprodukte festlegen, bestimmen den Zahlungsbetrag, den Sie erhalten. GitHub überweist 95% des Verkaufspreises in USD ohne Abzug von Steuern mit Ausnahme von Quellensteuern, die nach geltendem Recht erforderlich sind. Die restlichen 5 % des Verkaufspreises werden GitHub zugeteilt und einbehalten. GitHub überweist Ihnen am Ende jedes Monats und sobald ein Mindestbetrag von 500 USD erreicht wird, Ihren Zahlungsanteil. **6.3** Rückerstattungsanforderungen. Sie sind dafür verantwortlich, die Bedingungen für Rückerstattungen an Ihre Endbenutzer festzulegen. In keinem Fall ist GitHub dafür verantwortlich, Unterstützung für Rückerstattungen zu leisten; ebenfalls haftet GitHub nicht für die Bezahlung von Rückerstattungen. @@ -169,7 +169,7 @@ UNTER KEINEN UMSTÄNDEN UND UNTER KEINER RECHTLICHEN GRUNDLAGE (SEI ES VERTRAGLI **10.3** GitHub kann diese Vereinbarung jederzeit kündigen, wenn (a) Sie gegen eine Bestimmung dieser Vereinbarung verstoßen haben oder (b) GitHub gesetzlich dazu verpflichtet ist. -**10.4** Folgen der Kündigung durch den Entwickler. Nach Erhalt einer fünfundvierzig (45) Tage im Voraus erfolgenden schriftlichen Kündigung durch den Entwickler wird die Annahme neuer Kunden über den Marketplace für den Entwickler gesperrt. Alle ausstehenden Gebühren werden nach Beendigung und Entfernung des Entwicklerprodukts aus dem Marketplace überwiesen. Wird die Kündigung aufgrund einer Anderung dieser Bedingungen durch GitHub eingeleitet (Abschnitt 11), gelten die unmittelbar vor dieser Änderung in Kraft getretenen Bedingungen für die Dauer der 45-tägigen Kündigungsfrist bis zum Datum der tatsächlichen Kündigung. +**10.4** Folgen der Kündigung durch den Entwickler. Nach Erhalt einer fünfundvierzig (45) Tage im Voraus erfolgenden schriftlichen Kündigung durch den Entwickler wird die Annahme neuer Kunden über den Marketplace für den Entwickler gesperrt. Alle ausstehenden Gebühren werden nach Beendigung und Entfernung des Entwicklerprodukts aus dem Marketplace überwiesen. If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** Die Verpflichtungen in den Abschnitten 2, 3, 4, 5, 8, 9 und 12-18 gelten auch nach Ablauf oder Kündigung dieser Vereinbarung. 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 b254f2f5a0f4..1e9eb01b3516 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 @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Effective date: November 16, 2020 +Effective date: December 19, 2020 Vielen Dank, dass Sie GitHub Inc. ("GitHub", "wir") Ihren Quellcode, Ihre Projekte und Ihre persönlichen Informationen anvertrauen. Die Speicherung Ihrer persönlichen Daten ist eine große Verantwortung, und wir möchten, dass Sie wissen, wie wir diese handhaben. @@ -28,14 +28,14 @@ Natürlich enthalten die Kurzfassung und die Zusammenfassung unten nicht alle In | Abschnitt | Welche Informationen sind dort enthalten? | | ---------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [Welche Daten erfasst GitHub](#what-information-github-collects) | GitHub erfasst Daten direkt von Ihnen für Ihre Registrierung, Zahlung, Transaktionen und Ihr Benutzerprofil. Wir erfassen von Ihnen außerdem automatisch Ihre Nutzungsinformationen, Cookies und ähnliche Technologien und Geräteinformationen, die erforderlichenfalls Ihrer Zustimmung unterliegen. GitHub kann auch personenbezogene Benutzerinformationen von Dritten erfassen. Wir erfassen von Ihnen nur die minimale Menge an personenbezogenen Daten, die wir benötigen, es sei denn, Sie geben weitere an. | +| [Welche Daten erfasst GitHub](#what-information-github-collects) | GitHub erfasst Daten direkt von Ihnen für Ihre Registrierung, Zahlung, Transaktionen und Ihr Benutzerprofil. We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. GitHub kann auch personenbezogene Benutzerinformationen von Dritten erfassen. Wir erfassen von Ihnen nur die minimale Menge an personenbezogenen Daten, die wir benötigen, es sei denn, Sie geben weitere an. | | [Welche Daten erfasst GitHub _nicht_](#what-information-github-does-not-collect) | Wir erfassen nicht wissentlich Daten von Kindern unter 13 Jahren, und wir erfassen keine [Sensiblen persönlichen Daten](https://gdpr-info.eu/art-9-gdpr/). | | [Wie verwendet GitHub Ihre Informationen](#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. Wir beschreiben außerdem die Rechtsgrundlage, auf der wir Ihre Daten verarbeiten, sofern dies gesetzlich vorgeschrieben ist. | | [Weitergabe der von uns erfassten Daten](#how-we-share-the-information-we-collect) | Wir können Ihre Daten unter einem der folgenden Umstände an Dritte weitergeben: mit Ihrem Einverständnis, an unsere Dienstleistungsanbieter, zu Sicherheitszwecken, zur Erfüllung unserer gesetzlichen Verpflichtungen oder wenn es zu einem Wechsel der Kontrolle oder zum Verkauf von Unternehmenseinheiten oder Geschäftsbereichen kommt. Wir verkaufen Ihre persönlichen Daten nicht, und wir betreiben keine Werbung auf GitHub. Sie können eine Liste der Dienstanbieter einsehen, die auf Ihre Informationen zugreifen können. | | [Weitere wichtige Informationen](#other-important-information) | Wir stellen zusätzliche Informationen für Repository-Inhalte, öffentliche Informationen und Organisationen auf GitHub bereit. | | [Weitere Dienste](#additional-services) | Wir bieten Informationen zu zusätzlichen Serviceangeboten, einschließlich Anwendungen von Drittanbietern, GitHub Pages und GitHub-Anwendungen. | | [Wie Sie auf die von uns erfassten Daten zugreifen und diese kontrollieren können](#how-you-can-access-and-control-the-information-we-collect) | Wir bieten Ihnen Möglichkeiten, auf Ihre personenbezogenen Daten zuzugreifen, sie zu ändern oder zu löschen. | -| [Unsere Verwendung von Cookies und Tracking](#our-use-of-cookies-and-tracking) | Wir verwenden Cookies für die allgemeine Funktionalität unserer Website, und wir verwenden eine kleine Anzahl von Tracking- und Analysediensten auf einigen Teilen unserer Website. Wir bieten eine Seite, die dies sehr transparent macht. Weitere Informationen finden Sie in diesem Abschnitt. | +| [Unsere Verwendung von Cookies und Tracking](#our-use-of-cookies-and-tracking) | We only use strictly necessary cookies to provide, secure and improve our service. Wir bieten eine Seite, die dies sehr transparent macht. Weitere Informationen finden Sie in diesem Abschnitt. | | [Wie GitHub Ihre Daten schützt](#how-github-secures-your-information) | Wir setzen alle erforderlichen Maßnahmen ein, um die Vertraulichkeit, Integrität und Verfügbarkeit Ihrer persönlichen Daten auf GitHub zu schützen und die Ausfallsicherheit unserer Server zu gewährleisten. | | [GitHubs globale Datenschutzpraktiken](#githubs-global-privacy-practices) | We provide the same high standard of privacy protection to all our users around the world. | | [zur Kommunikation mit Ihnen](#how-we-communicate-with-you) | Die Kommunikation mit Ihnen erfolgt per E-Mail. Sie können in Ihren Kontoeinstellungen oder durch Kontaktaufnahme mit uns festlegen, wie wir Sie kontaktieren. | @@ -74,8 +74,8 @@ Wenn Sie ein kostenpflichtiges Konto bei uns haben, eine Anwendung verkaufen, di ##### Usage information Wenn Sie auf unseren Dienst oder unsere Website zugreifen, erfassen wir automatisch dieselben grundlegenden Informationen, die die meisten Dienste sammeln, gegebenenfalls vorbehaltlich Ihrer Zustimmung. Dazu gehören Informationen darüber, wie Sie den Dienst verwenden, z. B. die von Ihnen angezeigten Seiten, die Referenz-Website, Ihre IP-Adresse und Sitzungsinformationen sowie Datum und Uhrzeit jeder Anfrage. Dies sind Informationen, die wir von jedem Besucher der Website erfassen, unabhängig davon, ob er ein Konto hat oder nicht. Diese Informationen können personenbezogene Benutzerdaten enthalten. -##### Cookies and similar technologies information -Wie weiter unten beschrieben und gegebenenfalls vorbehaltlich Ihrer Zustimmung sammeln wir automatisch Informationen aus Cookies und ähnlichen Technologien (wie z. B. Cookie-ID und Einstellungen), damit Sie eingeloggt bleiben, um Ihre Präferenzen zu speichern und um Sie und Ihr Gerät zu identifizieren. +##### Cookies +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### Device information Wir erfassen möglicherweise bestimmte Informationen über Ihr Gerät, z. B. die IP-Adresse, Browser- oder Clientanwendungsinformationen, Spracheinstellungen, Betriebssystem- und Anwendungsversion, Gerätetyp und -ID sowie Gerätemodell und Hersteller. Diese Informationen können personenbezogene Benutzerdaten enthalten. @@ -235,15 +235,17 @@ Die von Ihnen angegebene E-Mail-Adresse [über Ihre Git-Commit-Einstellungen](/g #### Cookies -GitHub uses cookies and similar technologies (e.g., HTML5 localStorage) to make interactions with our service easy and meaningful. Cookies sind kleine Textdateien, die oft von Websites auf Computer-Festplatten oder mobilen Geräten von Besuchern gespeichert werden. We use cookies and similar technologies (hereafter collectively "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. 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. +GitHub only uses strictly necessary cookies. Cookies sind kleine Textdateien, die oft von Websites auf Computer-Festplatten oder mobilen Geräten von Besuchern gespeichert werden. -Auf unserer Webseite [Cookies und Tracking](/github/site-policy/github-subprocessors-and-cookies) beschreiben wir die von uns gesetzten Cookies, die Voraussetzungen für diese Cookies und die unterschiedlichen Arten von Cookies (temporär oder permanent). Die Website enthält außerdem eine Liste unserer externen Analyse- und Dienstanbieter sowie genaue Angaben darüber, welche Teile unserer Website von diesen Anbietern erfasst werden dürfen. +We use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### Tracking und Analyse +By using our service, 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 our service. -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. +Auf unserer Webseite [Cookies und Tracking](/github/site-policy/github-subprocessors-and-cookies) beschreiben wir die von uns gesetzten Cookies, die Voraussetzungen für diese Cookies und die unterschiedlichen Arten von Cookies (temporär oder permanent). -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. +#### DNT + +"[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/). 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. Es gibt auch gute Anwendungen, die die Online-Verfolgung verhindern. Ein gutes Beispiel dafür ist [Privacy Badger](https://privacybadger.org/). ### 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 76412bb633a4..b56123fec3d4 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,9 +10,9 @@ versions: free-pro-team: '*' --- -Effective date: **October 2, 2020** +Effective date: **December 30, 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. +GitHub bietet viel Transparenz darüber, wie wir Ihre Daten verwenden, wie wir Ihre Daten sammeln und mit wem wir Ihre Daten teilen. To that end, we provide this page, which details [our subprocessors](#github-subprocessors), and how we use [cookies](#cookies-on-github). ### GitHub-Unterauftragsverarbeiter @@ -29,14 +29,13 @@ Wenn wir Ihre Daten an Unterauftragsverarbeiter, wie z. B. unsere Anbieter und D | 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 | Analytics and performance | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | -| LinkedIn Navigator | Marketing-Datenanreicherungsservice | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | +| LinkedIn Navigator | Data enrichment service | 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 | | Mailgun | Transaktions-Mail-Dienstanbieter | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Microsoft | Microsoft Services | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Monday.com | Plattform für Teamkollaboration und Projektmanagement | Vereinigte Staaten von Amerika | Israel | | Nexmo | SMS-Benachrichtigungsanbieter | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | -| Oracle | Unternehmens-Finanzsystem | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Salesforce.com | Customer Relations-Management | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Sendgrid | Transaktions-Mail-Dienstanbieter | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | | Sentry.io | Application monitoring provider | Vereinigte Staaten von Amerika | Vereinigte Staaten von Amerika | @@ -49,49 +48,35 @@ Wenn wir einen neuen Unterauftragsverarbeiter einsetzen, der die personenbezogen ### Cookies auf GitHub -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. +GitHub uses 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` | 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. | Session, Sitzung | -| 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. | Session, Sitzung | -| 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 | +| 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 | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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 for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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` | This cookie allows us to customize timestamps to your time zone. | Session, Sitzung | +| GitHub | `user_session` | Dieses Cookie wird verwendet, um Sie anzumelden. | two weeks | _*_ 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 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/). 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. +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, 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. diff --git a/translations/de-DE/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/de-DE/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index 181a60ee397b..945e931bd373 100644 --- a/translations/de-DE/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/de-DE/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -163,8 +163,6 @@ c/o Corporation Service Company Sacramento, CA 95833-3505, USA. ``` -Sie können auch eine Kopie an legal@support.github.com senden. - Bitte formulieren Sie Ihre Wünsche so spezifisch und begrenzt wie möglich, einschließlich der folgenden Informationen: - Vollständige Informationen über die Behörde, die die Anfrage ausstellt 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 4ad3ce598e90..dfa2073b4614 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 @@ -39,12 +39,6 @@ If vulnerabilities have been detected in the repository, these are shown at the 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_alerts %}. -{% note %} - -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. - -{% endnote %} - ![Abhängigkeitsdiagramm](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ Any direct and indirect dependencies that are specified in the repository's mani {% if enterpriseServerVersions contains currentVersion 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. - -{% endnote %} - ![Abhängigkeitsdiagramm](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,6 +81,24 @@ You can also enable or disable the dependency graph for all repositories owned b 4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} ### Fehler beim Abhängigkeitsdiagramm beheben 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 881058bb62a0..fe6416f38f3a 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 @@ -40,8 +40,9 @@ 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` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% 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 @@ -72,6 +73,8 @@ Zum Einrichten einer Apex-Domäne, beispielsweise `example.com`, musst Du eine _ 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. Prüfe die korrekte Konfiguration des DNS-Datensatzes mit dem Befehl `dig`, und ersetze _EXAMPLE.COM_ dabei durch Deine Apex-Domäne. Prüfe, ob die Ergebnisse mit den obigen IP-Adressen für {% data variables.product.prodname_pages %} übereinstimmen. ```shell 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 a9156cf1f022..4547e23e2ca8 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 @@ -39,11 +39,7 @@ Deine Website darf nicht: - Mehrere `www`-Subdomänen umfassen. Beispiel: `www.example.com` und `www.anotherexample.com`. - Sowohl eine Apex-Domäne als auch eine benutzerdefinierte Subdomäne umfassen. Beispiel: `example.com` und `docs.example.com`. -{% warning %} - -**Warnung:** Es wird dringend empfohlen, keine Platzhalter-DNS-Einträge wie `*.example.com` zu verwenden. Dadurch würdest Du jedem ermöglichen, eine {% data variables.product.prodname_pages %}-Website auf Deinen Subdomänen zu hosten. - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} Eine Liste der unterstützten benutzerdefinierten Domänen findest Du unter „[Informationen zu benutzerdefinierten Domänen und {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages/#supported-custom-domains).“ @@ -53,7 +49,7 @@ Zugriff über HTTPS ist auf {% data variables.product.prodname_pages %}-Websites Nach der Konfiguration Deiner benutzerdefinierten Domäne kann es bis zu einer Stunde dauern, bis die Website über HTTPS verfügbar ist. Nach einer Aktualisierung bestehender DNS-Einstellungen musst Du Deine benutzerdefinierte Domäne zudem eventuell aus dem Repository Deiner Website entfernen und erneut dort einfügen, um den Prozess der HTTPS-Aktivierung zu initiieren. 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 Du CAA-Einträge (Certification Authority Authorization) verwendest, muss mindestens ein CAA-Eintrag mit dem Wert `letsencrypt.org` vorhanden sein, wenn Deine Website über HTTPS zugänglich sein soll. Weitere Informationen findest Du in der 'Let's Encrypt'-Dokumentation unter „[Certificate Authority Authorization (CAA)](https://letsencrypt.org/docs/caa/)“. +Wenn Du CAA-Einträge (Certification Authority Authorization) verwendest, muss mindestens ein CAA-Eintrag mit dem Wert `letsencrypt.org` vorhanden sein, wenn Deine Website über HTTPS zugänglich sein soll. Weitere Informationen finden Sie in der Let's Encrypt-Dokumentation unter „[Certificate Authority Authorization (CAA)](https://letsencrypt.org/docs/caa/)“. ### URL-Formatierung unter Linux diff --git a/translations/de-DE/content/graphql/overview/resource-limitations.md b/translations/de-DE/content/graphql/overview/resource-limitations.md index d0714a5d93c8..e7e574bb2f5f 100644 --- a/translations/de-DE/content/graphql/overview/resource-limitations.md +++ b/translations/de-DE/content/graphql/overview/resource-limitations.md @@ -117,7 +117,7 @@ These two examples show how to calculate the total nodes in a call. = 22,060 total nodes -### Rate limit +## Rate limit The GraphQL API v4 limit is different from the REST API v3's [rate limits](/rest/overview/resources-in-the-rest-api#rate-limiting). @@ -130,12 +130,6 @@ To accurately represent the server cost of a query, the GraphQL API v4 calculate The GraphQL API v4 rate limit is **5,000 points per hour**. -{% if currentVersion == "free-pro-team@latest" %} - -For {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s that belong to a {% data variables.product.prodname_ghe_cloud %} account, requests to resources owned by the same {% data variables.product.prodname_ghe_cloud %} account have an increased limit of 15,000 points per hour. - -{% endif %} - Note that 5,000 points per hour is not the same as 5,000 calls per hour: the GraphQL API v4 and REST API v3 use different rate limits. {% note %} diff --git a/translations/de-DE/content/graphql/reference/enums.md b/translations/de-DE/content/graphql/reference/enums.md index f87cc2e4ccd3..50ff25548cab 100644 --- a/translations/de-DE/content/graphql/reference/enums.md +++ b/translations/de-DE/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: Enums redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/input-objects.md b/translations/de-DE/content/graphql/reference/input-objects.md index 423c6511c8b7..ad927ff2bbd6 100644 --- a/translations/de-DE/content/graphql/reference/input-objects.md +++ b/translations/de-DE/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: Input objects redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/interfaces.md b/translations/de-DE/content/graphql/reference/interfaces.md index bfc411d7967c..492e7b535c62 100644 --- a/translations/de-DE/content/graphql/reference/interfaces.md +++ b/translations/de-DE/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: Interfaces redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/mutations.md b/translations/de-DE/content/graphql/reference/mutations.md index e42955c3d30c..387dcd51ac14 100644 --- a/translations/de-DE/content/graphql/reference/mutations.md +++ b/translations/de-DE/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: Mutations redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/objects.md b/translations/de-DE/content/graphql/reference/objects.md index 345786d5e1fc..7872b01baa65 100644 --- a/translations/de-DE/content/graphql/reference/objects.md +++ b/translations/de-DE/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: Objects redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/queries.md b/translations/de-DE/content/graphql/reference/queries.md index a2cc6af7b152..48b714cd4b40 100644 --- a/translations/de-DE/content/graphql/reference/queries.md +++ b/translations/de-DE/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: Queries miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/scalars.md b/translations/de-DE/content/graphql/reference/scalars.md index 338b4f42c7ee..2863a61f0de0 100644 --- a/translations/de-DE/content/graphql/reference/scalars.md +++ b/translations/de-DE/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: Scalars redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/graphql/reference/unions.md b/translations/de-DE/content/graphql/reference/unions.md index 5a87c63fc0a6..2c9b6a786244 100644 --- a/translations/de-DE/content/graphql/reference/unions.md +++ b/translations/de-DE/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: Unions redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/de-DE/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/de-DE/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index f55c416c6832..3f8fda59751e 100644 --- a/translations/de-DE/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/de-DE/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ You can choose which contributors are included in metrics and create teams of co ### Weiterführende Informationen - "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" \ No newline at end of file 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 f0e3e63bd0fc..ab1ce4a27156 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 @@ -99,4 +99,4 @@ To configure {% data variables.product.prodname_insights %} to connect to {% dat ### Weiterführende Informationen - "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" diff --git a/translations/de-DE/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/de-DE/content/packages/guides/configuring-npm-for-use-with-github-packages.md index 550c4294e9b9..e3070fd048ec 100644 --- a/translations/de-DE/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/de-DE/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: **Note:** 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" or currentVersion ver_gt "enterprise-server@2.22" %} +### Limits for published npm versions + +If you publish over 1,000 npm package versions to {% data variables.product.prodname_registry %}, you may see performance issues and timeouts occur during usage. + +To reduce the number of versions you have published for your npm package, consider deleting package versions. Weitere Informationen findest Du unter „[Ein Paket löschen](/packages/manage-packages/deleting-a-package)." + +In the future, {% data variables.product.company_short %} will enforce a hard limit on publishing more than 1,000 versions of an npm package. When we start enforcing the 1,000 versions limit for each npm package hosted on {% data variables.product.prodname_registry %}, we will offer more guidance on how to manage your package versions. + +{% endif %} + ### Bei {% data variables.product.prodname_registry %} authentifizieren {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/de-DE/content/packages/guides/deleting-a-container-image.md b/translations/de-DE/content/packages/guides/deleting-a-container-image.md index 33451deeaa34..e3e6c5254f83 100644 --- a/translations/de-DE/content/packages/guides/deleting-a-container-image.md +++ b/translations/de-DE/content/packages/guides/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 %}.' +intro: 'You can delete a specific version or all versions of a private or public container image on {% data variables.product.prodname_dotcom %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ When deleting public packages, be aware that you may break projects that depend ### Deleting a version of a user-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "[Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-a-user-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-user-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### Deleting a version of an organization-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "[Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-an-organization-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-org-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-user-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-org-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/de-DE/content/packages/index.md b/translations/de-DE/content/packages/index.md index c40765a9dc5d..1defcebba01f 100644 --- a/translations/de-DE/content/packages/index.md +++ b/translations/de-DE/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: + - + title: ghcr.io container names redirect to the container page + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: Filter for tagged and untagged containers + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ - title: Packages container support is an opt-in beta date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: Organization admins access to containers - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: Packages now respects IP allow list settings - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/de-DE/content/rest/overview/libraries.md b/translations/de-DE/content/rest/overview/libraries.md index c44db06aa8ed..6f14bb96cf5d 100644 --- a/translations/de-DE/content/rest/overview/libraries.md +++ b/translations/de-DE/content/rest/overview/libraries.md @@ -7,6 +7,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
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 53f7c5a4e0de..cd0b1f0231fd 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 @@ -41,8 +41,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -214,7 +215,7 @@ All error objects have resource and field properties so that your client can tel | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `missing` | A resource does not exist. | | `missing_field` | A required field on a resource has not been set. | -| `invalid` | The formatting of a field is invalid. Review the documentation for the for more specific information. | +| `invalid` | The formatting of a field is invalid. Review the documentation for more specific information. | | `already_exists` | Another resource has the same value as this field. This can happen in resources that must have some unique key (such as label names). | | `unprocessable` | The inputs provided were invalid. | @@ -235,14 +236,14 @@ Other redirection status codes may be used in accordance with the HTTP 1.1 spec. Where possible, API v3 strives to use appropriate HTTP verbs for each action. -| Verb | Beschreibung | -| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `HEAD` | Can be issued against any resource to get just the HTTP header info. | -| `GET` | Used for retrieving resources. | -| `POST` | Used for creating resources. | -| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A PATCH request may accept one or more of the attributes to update the resource. PATCH is a relatively new and uncommon HTTP verb, so resource endpoints also accept `POST` requests. | -| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | -| `DELETE` | Used for deleting resources. | +| Verb | Beschreibung | +| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `HEAD` | Can be issued against any resource to get just the HTTP header info. | +| `GET` | Used for retrieving resources. | +| `POST` | Used for creating resources. | +| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A `PATCH` request may accept one or more of the attributes to update the resource. | +| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | +| `DELETE` | Used for deleting resources. | ### Hypermedia diff --git a/translations/de-DE/content/rest/reference/enterprise-admin.md b/translations/de-DE/content/rest/reference/enterprise-admin.md index 0fbf117ef0d5..49789906773e 100644 --- a/translations/de-DE/content/rest/reference/enterprise-admin.md +++ b/translations/de-DE/content/rest/reference/enterprise-admin.md @@ -40,7 +40,7 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### Authentifizierung -Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** (which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} OAuth tokens must have the `site_admin` [OAuth scope](/developers/apps/scopes-for-oauth-apps#available-scopes) when used with Enterprise-specific endpoints.{% endif %} +Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** {% if enterpriseServerVersions contains currentVersion %}(which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) {% endif %}or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} 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 administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% if enterpriseServerVersions contains currentVersion %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% endif %}. 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 387c4192b51c..cfbcf43b1a90 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 @@ -135,12 +135,12 @@ _Suche_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _Bearbeiter_ _Ereignisse_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _Kennzeichnungen_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) diff --git a/translations/de-DE/data/release-notes/2-20/23.yml b/translations/de-DE/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..bde9f73982f7 --- /dev/null +++ b/translations/de-DE/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/de-DE/data/release-notes/2-21/14.yml b/translations/de-DE/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..97d5bac00ab3 --- /dev/null +++ b/translations/de-DE/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/de-DE/data/release-notes/2-22/6.yml b/translations/de-DE/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..971924052fb5 --- /dev/null +++ b/translations/de-DE/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/de-DE/data/reusables/actions/environments-beta.md b/translations/de-DE/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/de-DE/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/de-DE/data/reusables/actions/forked-secrets.md b/translations/de-DE/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..b7e069fc1db5 --- /dev/null +++ b/translations/de-DE/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +Mit Ausnahme von `GITHUB_TOKEN` werden Geheimnisse nicht an den Runner übergeben, wenn ein Workflow von einem geforkten Repository aus ausgelöst wird. 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 682635306981..2b866ca1c355 100644 --- a/translations/de-DE/data/reusables/dependabot/supported-package-managers.md +++ b/translations/de-DE/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn` (v1 only) (specify `npm`) +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`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 %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. 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 724e3f2c494e..27084f91f4ea 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 @@ -10,4 +10,4 @@ Wenn Sie einen Pull Request an das Basis-Repository aus einem geforkten Reposito Workflows werden standardmäßig nicht für geforkte Repositorys ausgeführt. Du musst GitHub Actions auf der Registerkarte **Actions** (Aktionen) im geforkten Repository aktivieren. -Die Berechtigungen für das `GITHUB_TOKEN` in geforkten Repositorys sind schreibgeschützt. Weitere Informationen findest Du unter „[Authentifizierung mit dem GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. 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/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/de-DE/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/de-DE/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/de-DE/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/de-DE/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/de-DE/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/de-DE/data/reusables/gated-features/actions-shared.md b/translations/de-DE/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..eb02add02e64 --- /dev/null +++ b/translations/de-DE/data/reusables/gated-features/actions-shared.md @@ -0,0 +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 %} ist nicht verfügbar für private Repositorys, die im Besitz von Konten mit älteren Pro-Repository-Plänen sind. diff --git a/translations/de-DE/data/reusables/gated-features/actions.md b/translations/de-DE/data/reusables/gated-features/actions.md index ed730faaf2ee..bafbe8fae92d 100644 --- a/translations/de-DE/data/reusables/gated-features/actions.md +++ b/translations/de-DE/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{{ 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/de-DE/data/reusables/gated-features/auto-merge.md b/translations/de-DE/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/de-DE/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/de-DE/data/reusables/gated-features/environments.md b/translations/de-DE/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/de-DE/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% 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/github-actions/permissions-statement-environment.md b/translations/de-DE/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/de-DE/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/de-DE/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/de-DE/data/reusables/github-actions/sidebar-environment.md b/translations/de-DE/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/de-DE/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. diff --git a/translations/de-DE/data/reusables/notifications/outbound_email_tip.md b/translations/de-DE/data/reusables/notifications/outbound_email_tip.md index 5a18d0418f4e..aae723ad3dd9 100644 --- a/translations/de-DE/data/reusables/notifications/outbound_email_tip.md +++ b/translations/de-DE/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. Für weitere Informationen kontaktiere Deinen Websiteadministrator. {% endnote %} - {% endif %} diff --git a/translations/de-DE/data/reusables/organizations/add-dns-txt-record.md b/translations/de-DE/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..93b9df8c4911 --- /dev/null +++ b/translations/de-DE/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. Befolge die unter **Add a DNS TXT record** (TXT-Eintrag für DNS hinzufügen) angegebenen Anweisungen, um mit Deinem Domänen-Hosting-Dienst einen TXT-Eintrag für DNS zu erstellen. ![Anweisungen zum Erstellen eines TXT-Eintrags für DNS](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/de-DE/data/reusables/organizations/add-domain.md b/translations/de-DE/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..c1bd06c9e9fb --- /dev/null +++ b/translations/de-DE/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. Gib im Domänen-Feld die Domäne ein, die verifiziert werden soll. Klicke anschließend auf **Add domain** (Domäne hinzufügen). ![Feld zum Hinzufügen einer Domain](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/de-DE/data/reusables/organizations/continue-verifying-domain.md b/translations/de-DE/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..34652f8455a3 --- /dev/null +++ b/translations/de-DE/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Schaltfläche „Continue verifying“ (Verifizierung fortsetzen) für Domain](/assets/images/help/organizations/continue-verifying-domain.png) +10. Klicke auf **Verify domain** (Domäne verifizieren). ![Schaltfläche „Verify domain“ (Domain verifizieren)](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/de-DE/data/reusables/organizations/restrict-email-notifications.md b/translations/de-DE/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..a83076a0ba7a --- /dev/null +++ b/translations/de-DE/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. Aktiviere unter „Enforcement preferences“ (Durchsetzungspräferenzen) das Kontrollkästchen **Restrict email notifications to domain email** (E-Mail-Benachrichtigungen auf eine genehmigte E-Mail-Domäne beschränken) aus. ![Kontrollkästchen zur Beschränkung von E-Mail-Benachrichtigungen auf eine genehmigte E-Mail-Domain](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/de-DE/data/reusables/organizations/verified-domains-details.md b/translations/de-DE/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..9384fb4aee08 --- /dev/null +++ b/translations/de-DE/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. Wenn die im Profil Deiner Organisation angezeigten Website- und E-Mail-Adressen auf unterschiedlichen Domänen gehostet werden, musst Du alle Domänen verifizieren. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/de-DE/data/reusables/pages/wildcard-dns-warning.md b/translations/de-DE/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..6aaf882954ba --- /dev/null +++ b/translations/de-DE/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**Warnung:** Es wird dringend empfohlen, keine Platzhalter-DNS-Einträge wie `*.example.com` zu verwenden. Dadurch würdest Du jedem ermöglichen, eine {% data variables.product.prodname_pages %}-Website auf Deinen Subdomänen zu hosten. + +{% endwarning %} 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 e02fdea38195..2bab45542fcc 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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 %} +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)." diff --git a/translations/de-DE/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/de-DE/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/de-DE/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/de-DE/data/reusables/pull_requests/you-can-auto-merge.md b/translations/de-DE/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..410aec2a8ee8 --- /dev/null +++ b/translations/de-DE/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." +{% endif %} \ No newline at end of file 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 2c1eb510dfd4..34f0e751bf00 100644 --- a/translations/ja-JP/content/actions/creating-actions/about-actions.md +++ b/translations/ja-JP/content/actions/creating-actions/about-actions.md @@ -17,7 +17,7 @@ versions: ### アクションについて -{% data variables.product.prodname_dotcom %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急の問題が発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 +{% data variables.product.prodname_dotcom %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急のIssueが発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 {% if currentVersion == "free-pro-team@latest" %} 独自のアクションの作成、または 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 34312304fd0c..edb6bf2bda58 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,60 +1,56 @@ --- -title: Creating a composite run steps action -intro: 'In this guide, you''ll learn how to build a composite run steps action.' +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 variables.product.prodname_actions %} の支払いを管理する +{% data variables.product.prodname_dotcom %}は、macOSランナーのホストに[MacStadium](https://www.macstadium.com/)を使用しています。 -### Introduction +### はじめに -In this guide, you'll learn about the basic components needed to create and use a packaged composite run steps action. To focus this guide on the components needed to package the action, the functionality of the action's code is minimal. The action prints "Hello World" and then "Goodbye", or if you provide a custom name, it prints "Hello [who-to-greet]" and then "Goodbye". The action also maps a random number to the `random-number` output variable, and runs a script named `goodbye.sh`. +このガイドでは、パッケージ化された複合実行ステップ アクションを作成および使用するために必要な基本的なコンポーネントについて説明します。 アクションのパッケージ化に必要なコンポーネントのガイドに焦点を当てるため、アクションのコードの機能は最小限に留めます。 アクションは「ハローワールド」と「さよなら」を印刷するか、カスタム名を指定すると「こんにちは [who-to-greet]」と「さようなら」を出力します。 このアクションでは、乱数も `乱数` 出力変数にマップされ、 `goodbye.sh`という名前のスクリプトが実行されます。 -Once you complete this project, you should understand how to build your own composite run steps action and test it in a workflow. +このプロジェクトを完了したら、独自の複合実行ステップ アクションをビルドし、ワークフローでテストする方法を理解する必要があります。 -### Prerequisites +### 必要な環境 -Before you begin, you'll create a {% data variables.product.product_name %} repository. +始める前に、{% data variables.product.product_name %} リポジトリを作成します。 -1. Create a new public repository on {% data variables.product.product_location %}. You can choose any repository name, or use the following `hello-world-composite-run-steps-action` example. You can add these files after your project has been pushed to {% data variables.product.product_name %}. For more information, see "[Create a new repository](/articles/creating-a-new-repository)." +1. {% data variables.product.product_location %} に新しいパブリックリポジトリを作成します。 任意のリポジトリ名を選択するか、hello-world コンポジット実行ステップアクション 例 `次の方法を使用できます。 これらのファイルは、プロジェクトを {% data variables.product.product_name %}にプッシュした後で追加できます。 詳しい情報については、「新しいリポジトリの作成」を参照してください。

+

  • リポジトリをお手元のコンピューターにクローンします。 詳しい情報についてはリポジトリのクローンを参照してください。

    • +

  • ターミナルから、ディレクトリを新しいリポジトリに変更します。 +

      cd ハローワールドコンポジット実行ステップアクション
+`
    -1. Clone your repository to your computer. For more information, see "[Cloning a repository](/articles/cloning-a-repository)." +2. `hello-world-composite-run-steps-action` リポジトリで、 `goodbye.sh`という名前の新しいファイルを作成し、次のコード例を追加します。 -1. From your terminal, change directories into your new repository. - - ```shell - cd hello-world-composite-run-steps-action - ``` - -2. In the `hello-world-composite-run-steps-action` repository, create a new file called `goodbye.sh`, and add the following example code: - ```bash - echo "Goodbye" + エコー"さようなら" ``` -3. From your terminal, make `goodbye.sh` executable. +3. ターミナルから、`goodbye.sh` を実行可能にします。 ```shell chmod +x goodbye.sh ``` -1. From your terminal, check in your `goodbye.sh` file. +1. 端末から、 `goodbye.sh` ファイルをチェックインします。 ```shell - git add goodbye.sh - git commit -m "Add goodbye script" - git push + git を追加goodbye.sh + git コミット -m "さよならスクリプトを追加" + git プッシュ ``` -### Creating an action metadata file +### アクションのメタデータファイルの作成 -1. In the `hello-world-composite-run-steps-action` repository, create a new file called `action.yml` and add the following example code. For more information about this syntax, see "[`runs` for a composite run steps](/actions/creating-actions/metadata-syntax-for-github-actions#runs-for-composite-run-steps-actions)". +1. `hello-world-composite-run-steps-action` リポジトリで、action.yml `という名前の新しいファイルを作成し、次のコード例を追加します。 この構文の詳細については、「実行` 」を参照してください。 {% raw %} - **action.yml** + **アクション.yml** ```yaml name: 'Hello World' description: 'Greet someone' @@ -79,35 +75,47 @@ Before you begin, you'll create a {% data variables.product.product_name %} repo shell: bash ``` {% endraw %} - This file defines the `who-to-greet` input, maps the random generated number to the `random-number` output variable, and runs the `goodbye.sh` script. It also tells the runner how to execute the composite run steps action. + This file defines the `who-to-greet` input, maps the random generated number to the `random-number` output variable, and runs the `goodbye.sh` script. また、複合実行ステップアクションの実行方法をランナーに指示します。 + + 出力の管理の詳細については、「複合実行手順の出力 を[`する」参照してください。

    - For more information about managing outputs, see "[`outputs` for a composite run steps](/actions/creating-actions/metadata-syntax-for-github-actions#outputs-for-composite-run-steps-actions)". +

    github.action_path`の使用方法の詳細については、「github コンテキスト](/actions/creating-actions/metadata-syntax-for-github-actions#outputs-for-composite-run-steps-actions)の + +`」を参照してください。

    • +

  • ターミナルから、action.yml` ファイルをチェックインします。 - 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. 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)." +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 ``` + + -### 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 tag you created. You can also replace the `who-to-greet` input with your name. +次のワークフロー コードでは、「アクション メタデータ ファイルの作成」で行った完了した hello world アクション[使用](/actions/creating-actions/creating-a-composite-run-steps-action#creating-an-action-metadata-file)。 + +ワークフローコードを別のリポジトリの `.github/workflows/main.yml` ファイルにコピーしますが、`actions/hello-world-composite-run-steps-action@v1` は作成したリポジトリとタグに置き換えます。 `who-to-greet` 入力を自分の名前に置き換えることもできます。 {% raw %} -**.github/workflows/main.yml** + +**.github/ワークフロー/メイン.yml** + + ```yaml on: [push] @@ -124,6 +132,8 @@ jobs: - run: echo random-number ${{ steps.foo.outputs.random-number }} shell: bash ``` + + {% endraw %} -From your repository, click the **Actions** tab, and select the latest workflow run. The output should include: "Hello Mona the Octocat", the result of the "Goodbye" script, and a random number. +リポジトリから [**Actions**] タブをクリックして、最新のワークフロー実行を選択します。 出力には、「こんにちはモナオクトキャット」、"Goodbye"スクリプトの結果、および乱数が含まれている必要があります。 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 d6c213db580c..39c5300031e4 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 @@ -117,6 +117,7 @@ runs: {% endraw %} #### `outputs..value` + **必須** 出力パラメーターがマップされる値。 これを `string` またはコンテキスト付きの式に設定できます。 たとえば、`steps` コンテキストを使用して、出力の `value` をステップの出力値に設定できます。 コンテキストと式の構文の使用方法について詳しくは、「[{% data variables.product.prodname_actions %} のコンテキストと式の構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 @@ -204,9 +205,11 @@ runs: **必須** このアクションで実行する予定の実行ステップ。 -##### `runs.steps.run` +##### `runs.steps[*].run` **必須** 実行するコマンド。 これは、インラインでも、アクションリポジトリ内のスクリプトでもかまいません。 + +{% raw %} ```yaml runs: using: "composite" @@ -214,6 +217,7 @@ runs: - run: ${{ github.action_path }}/test/script.sh shell: bash ``` +{% endraw %} または、`$GITHUB_ACTION_PATH` を使用できます。 @@ -227,23 +231,23 @@ runs: 詳しい情報については、「[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)」を参照してください。 -##### `runs.steps.shell` +##### `runs.steps[*].shell` **必須** コマンドを実行するシェル。 [こちら](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)にリストされている任意のシェルを使用できます。 -##### `runs.steps.name` +##### `runs.steps[*].name` **オプション** 複合実行ステップの名前。 -##### `runs.steps.id` +##### `runs.steps[*].id` **オプション** ステップの一意の識別子。 `id`を使って、コンテキストのステップを参照することができます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 -##### `runs.steps.env` +##### `runs.steps[*].env` **オプション** そのステップのみの環境変数の `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` +##### `runs.steps[*].working-directory` **オプション** コマンドを実行する作業ディレクトリを指定します。 diff --git a/translations/ja-JP/content/actions/guides/about-continuous-integration.md b/translations/ja-JP/content/actions/guides/about-continuous-integration.md index 8bcce36adb32..c3e3275f0599 100644 --- a/translations/ja-JP/content/actions/guides/about-continuous-integration.md +++ b/translations/ja-JP/content/actions/guides/about-continuous-integration.md @@ -25,7 +25,7 @@ versions: ### {% 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)」を参照してください。 +{% data variables.product.prodname_actions %} を利用した CI では、リポジトリ内のコードをビルドしてテストを実行できるワークフローが利用できます。 ワークフローは、{% data variables.product.prodname_dotcom %} でホストされている仮想マシン、または自分がホストしているマシンで実行できます。 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)." CI ワークフローは、{% data variables.product.product_name %} イベントが発生したとき（たとえば、新しいコードがリポジトリにプッシュされたとき）、設定されたスケジュールで、またはリポジトリディスパッチ Webhook を使用して外部イベントが発生したときに実行するように設定できます。 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 index 61f97ffc5b7c..b28baf91afe8 100644 --- a/translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/ja-JP/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% data reusables.github-actions.setup-node-intro %} -プライベートリポジトリで認証を受けるには、npm認証トークンをリポジトリ設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +To authenticate to your private registry, you'll need to store your npm authentication token as a secret. For example, create a repository secret called `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の認証トークンを含むシークレットを設定しなければなりません。 +以下の例では、`NPM_TOKEN`というシークレットにはnpmの認証トークンが保存されます。 `setup-node`アクションは、環境変数の`NODE_AUTH_TOKEN`からnpmの認証トークンを読み取るよう*.npmrc*ファイルを設定します。 When using the `setup-node` action to create an *.npmrc* file, you must set the `NODE_AUTH_TOKEN` environment variable with the secret that contains your npm authentication token. 依存関係をインストールする前に、`setup-node`アクションを使って*.npmrc*ファイルを作成してください。 このアクションには2つの入力パラメーターがあります。 `node-version`パラメーターはNode.jsのバージョンを設定し、`registry-url`パラメーターはデフォルトのレジストリを設定します。 パッケージレジストリがスコープを使うなら、`scope`パラメーターを使わなければなりません。 詳しい情報については[`npm-scope`](https://docs.npmjs.com/misc/scope)を参照してください。 diff --git a/translations/ja-JP/content/actions/guides/building-and-testing-powershell.md b/translations/ja-JP/content/actions/guides/building-and-testing-powershell.md index 30c070c4ea0d..8872f5c1c1c6 100644 --- a/translations/ja-JP/content/actions/guides/building-and-testing-powershell.md +++ b/translations/ja-JP/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ The `always()` function configures the job to continue processing even if there ### Publishing to PowerShell Gallery -You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use repository secrets to store any tokens or credentials needed to publish your package. 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use secrets to store any tokens or credentials needed to publish your package. 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 The following example creates a package and uses `Publish-Module` to publish it to the PowerShell Gallery: 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 index a661d3443623..4c5c232c37a9 100644 --- a/translations/ja-JP/content/actions/guides/building-and-testing-python.md +++ b/translations/ja-JP/content/actions/guides/building-and-testing-python.md @@ -391,7 +391,7 @@ jobs: CIテストにパスしたなら、Pythonパッケージを任意のパッケージレジストリに公開するようにワークフローを設定できます。 -パッケージを公開するのに必要なアクセストークンやクレデンシャルは、リポジトリシークレットを使って保存できます。 以下の例では、`twine`と`dist`を使ってパッケージを作成してPyPIに公開しています。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +You can store any access tokens or credentials needed to publish your package using secrets. 以下の例では、`twine`と`dist`を使ってパッケージを作成してPyPIに公開しています。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 {% raw %} ```yaml diff --git a/translations/ja-JP/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/ja-JP/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..af233a2d590c --- /dev/null +++ b/translations/ja-JP/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: Deploying to Amazon Elastic Container Service +intro: You can deploy to Amazon Elastic Container Service (ECS) as part of your continuous deployment (CD) workflows. +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/)を使用しています。 + +### はじめに + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/), and deploy it to [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/). + +On every new release in your {% data variables.product.company_short %} repository, the {% data variables.product.prodname_actions %} workflow builds and pushes a new container image to Amazon ECR, and then deploys a new task definition to Amazon ECS. + +### 必要な環境 + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps for Amazon ECR and ECS: + +1. Create an Amazon ECR repository to store your images. + + For example, using [the AWS CLI](https://aws.amazon.com/cli/): + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Ensure that you use the same Amazon ECR repository name (represented here by `MY_ECR_REPOSITORY`) for the `ECR_REPOSITORY` variable in the workflow below. + + Ensure that you use the same AWS region value for the `AWS_REGION` (represented here by `MY_AWS_REGION`) variable in the workflow below. + +2. Create an Amazon ECS task definition, cluster, and service. + + For details, follow the [Getting started wizard on the Amazon ECS console](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), or the [Getting started guide](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) in the Amazon ECS documentation. + + Ensure that you note the names you set for the Amazon ECS service and cluster, and use them for the `ECS_SERVICE` and `ECS_CLUSTER` variables in the workflow below. + +3. Store your Amazon ECS task definition as a JSON file in your {% data variables.product.company_short %} repository. + + The format of the file should be the same as the output generated by: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Ensure that you set the `CONTAINER_NAME` variable in the workflow below as the container name in the `containerDefinitions` section of the task definition. + +4. Create {% data variables.product.prodname_actions %} secrets named `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to store the values for your Amazon IAM access key. + + For more information on creating secrets for {% data variables.product.prodname_actions %}, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + See the documentation for each action used below for the recommended IAM policies for the IAM user, and methods for handling the access key credentials. + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to Amazon ECR. It then updates the task definition with the new image ID, and deploys the task definition to Amazon ECS. + +Ensure that you provide your own values for all the variables in the `env` key of the workflow. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### Additional resources + +For more information on the services used in these examples, see the following documentation: + +* "[Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)" in the Amazon AWS documentation. +* Official AWS "[Configure AWS Credentials](https://github.com/aws-actions/configure-aws-credentials)" action. +* Official AWS [Amazon ECR "Login"](https://github.com/aws-actions/amazon-ecr-login) action. +* Official AWS [Amazon ECS "Render Task Definition"](https://github.com/aws-actions/amazon-ecs-render-task-definition) action. +* Official AWS [Amazon ECS "Deploy Task Definition"](https://github.com/aws-actions/amazon-ecs-deploy-task-definition) action. diff --git a/translations/ja-JP/content/actions/guides/deploying-to-azure-app-service.md b/translations/ja-JP/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..d509e5364f06 --- /dev/null +++ b/translations/ja-JP/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: Deploying to Azure App Service +intro: You can deploy to Azure App Service as part of your continuous deployment (CD) workflows. +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/)を使用しています。 + +### はじめに + +This guide explains how to use {% data variables.product.prodname_actions %} to build, test, and deploy an application to [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/). + +Azure App Service can run web apps in several languages, but this guide demonstrates deploying an existing Node.js project. + +### 必要な環境 + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps: + +1. Create an Azure App Service plan. + + For example, you can use the Azure CLI to create a new App Service plan: + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + In the command above, replace `MY_RESOURCE_GROUP` with your pre-existing Azure Resource Group, and `MY_APP_SERVICE_PLAN` with a new name for the App Service plan. + + See the Azure documentation for more information on using the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/): + + * For authentication, see "[Sign in with Azure CLI](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)". + * If you need to create a new resource group, see "[az group](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)." + +2. Create a web app. + + For example, you can use the Azure CLI to create an Azure App Service web app with a node runtime: + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + In the command above, replace the parameters with your own values, where `MY_WEBAPP_NAME` is a new name for the web app. + +3. Configure an Azure publish profile and create an `AZURE_WEBAPP_PUBLISH_PROFILE` secret. + + Generate your Azure deployment credentials using a publish profile. For more information, see "[Generate deployment credentials](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" in the Azure documentation. + + In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build, test, and deploy the Node.js project to Azure App Service. + +Ensure that you set `AZURE_WEBAPP_NAME` in the workflow `env` key to the name of the web app you created. + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### Additional resources + +The following resources may also be useful: + +* For the original starter workflow, see [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml) in the {% data variables.product.prodname_actions %} `starter-workflows` repository. +* The action used to deploy the web app is the official Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) action. +* The "[Create a Node.js web app in Azure](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)" quickstart in the Azure web app documentation demonstrates using VS Code with the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). diff --git a/translations/ja-JP/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/ja-JP/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..1ac60c04779a --- /dev/null +++ b/translations/ja-JP/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: Deploying to Google Kubernetes Engine +intro: You can deploy to Google Kubernetes Engine as part of your continuous deployment (CD) workflows. +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/)を使用しています。 + +### はじめに + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to Google Container Registry (GCR), and deploy it to Google Kubernetes Engine (GKE). + +GKE is a managed Kubernetes cluster service from Google Cloud that can host your containerized workloads in the cloud or in your own datacenter. For more information, see [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine). + +### 必要な環境 + +Before you proceed with creating the workflow, you will need to complete the following steps for your Kubernetes project. This guide assumes the root of your project already has a `Dockerfile` and a Kubernetes Deployment configuration file. For an example, see [google-github-actions](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke). + +#### Creating a GKE cluster + +To create the GKE cluster, you will first need to authenticate using the `gcloud` CLI. For more information on this step, see the following articles: +- [`gcloud auth login`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI and Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +例: + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### Enabling the APIs + +Enable the Kubernetes Engine and Container Registry APIs. 例: + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### Configuring a service account and storing its credentials + +This procedure demonstrates how to create the service account for your GKE integration. It explains how to create the account, add roles to it, retrieve its keys, and store them as a base64-encoded [encrypted repository secret](/actions/reference/encrypted-secrets) named `GKE_SA_KEY`. + +1. Create a new service account: + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. Retrieve the email address of the service account you just created: + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. Add roles to the service account. Note: Apply more restrictive roles to suit your requirements. + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. Download the JSON keyfile for the service account: + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. Store the project ID as a secret named `GKE_PROJECT`: + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### (Optional) Configuring kustomize +Kustomize is an optional tool used for managing YAML specs. After creating a _kustomization_ file, the workflow below can be used to dynamically set fields of the image and pipe in the result to `kubectl`. For more information, see [kustomize usage](https://github.com/kubernetes-sigs/kustomize#usage). + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to GCR. It then uses the Kubernetes tools (such as `kubectl` and `kustomize`) to pull the image into the cluster deployment. + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### Additional resources + +For more information on the tools used in these examples, see the following documentation: + +* For the full starter workflow, see the ["Build and Deploy to GKE" workflow](https://github.com/actions/starter-workflows/blob/master/ci/google.yml). +* For more starter workflows and accompanying code, see Google's [{% data variables.product.prodname_actions %} example workflows](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/). +* The Kubernetes YAML customization engine: [Kustomize](https://kustomize.io/). +* "[Deploying a containerized web application](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)" in the Google Kubernetes Engine documentation. diff --git a/translations/ja-JP/content/actions/guides/index.md b/translations/ja-JP/content/actions/guides/index.md index 8d4e47d0ee8a..45d9b8067d4f 100644 --- a/translations/ja-JP/content/actions/guides/index.md +++ b/translations/ja-JP/content/actions/guides/index.md @@ -36,6 +36,14 @@ versions: {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### Creating custom continuous deployment workflows + +You can use {% data variables.product.prodname_actions %} to create custom continuous deployment (CD) workflows that deploy projects to a number of cloud partner ecosystems. + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### ソフトウェア パッケージを公開する 継続的デリバリ (CD) ワークフローの一部として、ソフトウェア パッケージの公開を自動化できます。 パッケージは、任意のパッケージ ホストおよび {% data reusables.gated-features.packages %} に公開できます。 diff --git a/translations/ja-JP/content/actions/guides/publishing-docker-images.md b/translations/ja-JP/content/actions/guides/publishing-docker-images.md index 0c92831b995a..1a95f1b78fec 100644 --- a/translations/ja-JP/content/actions/guides/publishing-docker-images.md +++ b/translations/ja-JP/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ versions: 以下のワークフローの例では、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にプッシュするためには、Docker Hubのアカウントを持っており、Docker Hubのレジストリを作成していなければなりません。 For more information, see "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" in the Docker documentation. Docker Hubに必要な`build-push-action`のオプションは以下のとおりです。 -* `username`及び`password`: Docker Hubのユーザ名とパスワードです。 We recommend storing your Docker Hub username and password as encrypted secrets in your {% data variables.product.prodname_dotcom %} repository so they aren't exposed in your workflow file. 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +* `username`及び`password`: Docker Hubのユーザ名とパスワードです。 We recommend storing your Docker Hub username and password as secrets so they aren't exposed in your workflow file. 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 * `repository`: `DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY`フォーマットでのDocker Hubのリポジトリ。 {% raw %} diff --git a/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md b/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md index 7bde7bd386e3..fd72447502b5 100644 --- a/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/ja-JP/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ Node.jsプロジェクトのためのCIワークフローの作成に関する 新しいリリースを作成するたびに、パッケージを公開するワークフローを起動できます。 以下の例でのワークフローは、`created`という種類で`release`イベントが発生したときに実行されます。 このワークフローは、CIテストをパスすればnpmレジストリにパッケージを公開します。 -ワークフロー中でnpmレジストリに対して認証を受けた操作を行うためには、npmの認証トークンをリポジトリの設定中にシークレットとして保存しなければなりません。 たとえば`NPM_TOKEN`というシークレットを生成してください。 詳しい情報については、「[暗号化されたシークレットの作成と利用](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)」を参照してください。 +To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret. For example, create a repository secret called `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`という名前のパッケージを公開できます。 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 b88dc4a3be93..b707eab552f9 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 @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data variables.product.prodname_actions %} の支払いを管理する 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 803035358746..01d246ca361a 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 @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data variables.product.prodname_actions %} の支払いを管理する diff --git a/translations/ja-JP/content/actions/index.md b/translations/ja-JP/content/actions/index.md index 3117a1d37884..03fee5cffedb 100644 --- a/translations/ja-JP/content/actions/index.md +++ b/translations/ja-JP/content/actions/index.md @@ -25,6 +25,10 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: + - + title: Workflow visualization + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ - title: Removing set-env and add-path commands on November 16 date: '2020-11-09' @@ -33,14 +37,6 @@ changelog: title: Ubuntu-latest workflows will use Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - - title: MacOS Big Sur Preview - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - - title: Self-Hosted Runner Group Access Changes - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU redirect_from: - /articles/automating-your-workflow-with-github-actions/ 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 index 4a19585ae322..b49364b109f6 100644 --- 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 @@ -76,7 +76,7 @@ steps: #### ブランチの使用 -特定のブランチを参照するということは、アクションが常にターゲットブランチの最新の更新を含み使用することを示しますが、それらの更新に重大な変更が含まれる場合、問題が発生する可能性があります。 この例では、`@main` という名前のブランチを対象としています。 +Referring to a specific branch means that the action will always use the latest updates on the target branch, but can create problems if those updates include breaking changes. この例では、`@main` という名前のブランチを対象としています。 ```yaml steps: 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 index 4c3f6822067f..dff0eb5dceda 100644 --- 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 @@ -36,7 +36,7 @@ versions: イベントは、ワークフローをトリガーする特定のアクティビティです。 たとえば、誰かがコミットをリポジトリにプッシュした場合、あるいはIssueもしくはプルリクエストが作成された場合、{% data variables.product.prodname_dotcom %}からアクティビティを発生させることができます。 You can also use the [repository dispatch webhook](/rest/reference/repos#create-a-repository-dispatch-event) to trigger a workflow when an external event occurs. ワークフローのトリガーに使用できるイベントの完全なリストについては、[ワークフローをトリガーするイベント](/actions/reference/events-that-trigger-workflows)を参照してください。 -#### Jobs +#### ジョブ ジョブは、同じランナーで実行される一連のステップです。 デフォルトでは、複数のジョブを含むワークフローは、それらのジョブを並行して実行します。 ジョブを順番に実行するようにワークフローを設定することもできます。 たとえば、ワークフローにコードのビルドとテストという2つのシーケンシャルなジョブを持たせ、テストジョブをビルドジョブのステータスに依存させることができます。 ビルドジョブが失敗した場合は、テストジョブは実行されません。 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 index edb77e5c9777..5cb3e9aa80d0 100644 --- 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 @@ -1,7 +1,7 @@ --- title: 複雑なワークフローを管理する shortTitle: 複雑なワークフローを管理する -intro: 'このガイドでは、{% data variables.product.prodname_actions %} の高度な機能を、シークレット管理、依存ジョブ、キャッシング、ビルドマトリックス、ラベルとともに使用する方法を説明します。' +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,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} environments,{% endif %} and labels.' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: 詳しい情報については、「[セルフホストランナーでのラベルの利用](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)」を参照してください。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Using environments + +You can configure environments with protection rules and secrets. Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." +{% endif %} + ### 次のステップ {% 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-circleci-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-circleci-to-github-actions.md index b1c71453caf7..09c761b8fa3b 100644 --- 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 @@ -37,7 +37,7 @@ CircleCIと{% data variables.product.prodname_actions %}は、どちらも似た ### 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と{% data variables.product.prodname_actions %}は、どちらもワークフロー中のタスクを再利用し、共有するための仕組みを提供しています。 CircleCIはorbsという概念を利用します。これはYAMLで書かれ、ワークフロー中で再利用できるタスクを提供します。 {% data variables.product.prodname_actions %}はアクションと呼ばれる協力で柔軟な再利用できるコンポーネントを持っており、これはJavaScriptファイルもしくはDockerイメージで構築できます。 {% data variables.product.product_name %}の API やパブリックに利用可能なサードパーティAPIとのインテグレーションなど、好きな方法でリポジトリを操作するカスタムコードを書いて、アクションを作成することができます。 たとえば、アクションでnpmモジュールを公開する、緊急のIssueが発生したときにSMSアラートを送信する、本番対応のコードをデプロイすることなどが可能です。 詳細については、「[アクションを作成する](/actions/creating-actions)」を参照してください。 CircleCIは、YAMLのアンカーとエイリアスでワークフローの部分を再利用できます。 {% data variables.product.prodname_actions %}はビルドマトリックスを使って、再利用性についての一般的な要求のほとんどをサポートします。 ビルドマトリックスに関する詳細な情報については「[複雑なワークフローを管理する](/actions/learn-github-actions/managing-complex-workflows/#using-a-build-matrix)」を参照してください。 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 index 08077dad2ffa..5402d2151e4b 100644 --- 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 @@ -20,7 +20,7 @@ GitLab CI/CD と {% data variables.product.prodname_actions %} は、どちら いくつかの違いがありますので、このガイドでは、ワークフローを {% data variables.product.prodname_actions %} に移行できるようにする際の重要な違いを説明します。 -### Jobs +### ジョブ GitLab CI/CD のジョブは、{% data variables.product.prodname_actions %} のジョブと非常によく似ています。 どちらのシステムでも、ジョブは以下の特徴を持ちます。 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 index df3f32cfee5c..4ef768ff7854 100644 --- 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 @@ -57,7 +57,7 @@ Jenkinsは、_宣言的パイプライン_を管理するためにディレク | 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) | +| [`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) | diff --git a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index 129c23238c96..e014f54682e2 100644 --- a/translations/ja-JP/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/ja-JP/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ When migrating from Travis CI, consider the following key features in {% data va #### シークレットを保存する -{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} also includes policies that allow you to limit access to secrets at the repository and organization level. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." +{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} organizations can limit which repositories can access organization secrets. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Environment protection rules can require manual approval for a workflow to access environment secrets. {% endif %}For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." #### Sharing files between jobs and workflows 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 index 5b9152ac2a01..750532fb5732 100644 --- 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 @@ -19,7 +19,7 @@ versions: ### シークレットを使用する -機密性の高い値は、平文としてワークフローファイルに保存するのではなく、シークレットとして保存してください。 [シークレット](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)は Organization またはリポジトリレベルで設定でき、機密情報を {% data variables.product.product_name %} に保存できます。 +機密性の高い値は、平文としてワークフローファイルに保存するのではなく、シークレットとして保存してください。 [Secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets) can be configured at the organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environment{% else %} or repository{% endif %} level, and allow you to store sensitive information in {% 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 %} はそれを復号化して、ワークフローランタイムに挿入できるようになります。 @@ -38,6 +38,10 @@ versions: - **登録されたシークレットの監査とローテーション** - 登録されたシークレットを定期的に確認して、現在も必要であることを確認します。 不要になったものは削除してください。 - シークレットを定期的にローテーションして、不正使用されたシークレットが有効である期間を短縮します。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Environments](/actions/reference/environments)." +{% endif %} ### サードパーティアクションを使用する @@ -66,13 +70,13 @@ versions: ### リポジトリ間のアクセスを検討する -{% 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.product_name %} は、意図的に一度に単一のリポジトリに対してスコープされます。 The `GITHUB_TOKEN` 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. ユーザはリポジトリごとに特定の権限を持っているため、1 つのリポジトリの `GITHUB_TOKEN` に別のリポジトリへのアクセスを許可すると、慎重に実装しない場合 {% data variables.product.prodname_dotcom %} 権限モデルに影響します。 Similarly, caution must be taken when adding {% data variables.product.prodname_dotcom %} authentication tokens to a workflow, because this can also affect the {% data variables.product.prodname_dotcom %} permission model by inadvertently granting broad access to collaborators. -[{% data variables.product.prodname_dotcom %} ロードマップ](https://github.com/github/roadmap/issues/74)では、{% data variables.product.product_name %} 内のリポジトリ間アクセスを可能にするフローをサポートする計画がありますが、この機能はまだサポートされていません。 現在、権限のあるリポジトリ間のやり取りを実行する唯一の方法は、ワークフロー環境内に {% data variables.product.prodname_dotcom %} 認証トークンまたは SSH キーをシークレットとして配置することです。 多くの認証トークンタイプでは特定のリソースへの詳細なアクセスが許可されていないことから、意図したものよりはるかに広範なアクセスを許可できるため、間違ったトークンタイプを使用すると重大なリスクが生じます。 +[{% data variables.product.prodname_dotcom %} ロードマップ](https://github.com/github/roadmap/issues/74)では、{% data variables.product.product_name %} 内のリポジトリ間アクセスを可能にするフローをサポートする計画がありますが、この機能はまだサポートされていません。 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. 多くの認証トークンタイプでは特定のリソースへの詳細なアクセスが許可されていないことから、意図したものよりはるかに広範なアクセスを許可できるため、間違ったトークンタイプを使用すると重大なリスクが生じます。 次のリストでは、ワークフロー内のリポジトリデータにアクセスするための推奨アプローチを優先度の高い順に説明しています。 -1. **ワークフロー環境の `GITHUB_TOKEN`** +1. **The `GITHUB_TOKEN`** - このトークンは、ワークフローを呼び出した単一のリポジトリに意図的にスコープが設定されており、リポジトリの書き込みアクセスユーザと同じレベルのアクセス権を持っています。 トークンは各ジョブが開始する前に作成され、ジョブが終了すると期限切れになります。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 - 可能な場合は、常に `GITHUB_TOKEN` を使用する必要があります。 2. **リポジトリのデプロイキー** 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 index 6b1ced34d347..3c05a81c794a 100644 --- 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 @@ -13,6 +13,9 @@ versions: これらの追加ログは、ワークフローを含むリポジトリにシークレットを設定することで有効になるため、同じ権限要件が適用されます。 - {% data reusables.github-actions.permissions-statement-secrets-repository %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/index.md b/translations/ja-JP/content/actions/managing-workflow-runs/index.md index 988cc40d9d92..4c44aec33f95 100644 --- a/translations/ja-JP/content/actions/managing-workflow-runs/index.md +++ b/translations/ja-JP/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- title: ワークフロー実行を管理する shortTitle: ワークフロー実行を管理する -intro: 'ワークフローの各ステップのステータスと結果の表示、保留中のワークフローのキャンセル、請求可能なジョブ実行時間の表示、失敗したワークフローのデバッグと再実行、ログの検索とダウンロード、アーティファクトのダウンロードを行うことができます。' +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}review deployments, {% endif %}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 @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/ja-JP/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/ja-JP/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..cbeb7fe2ce54 --- /dev/null +++ b/translations/ja-JP/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: Reviewing deployments +intro: You can approve or reject jobs awaiting review. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About required reviews in workflows + +Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled. + +For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." + +### Approving or rejecting a job + +1. Navigate to the workflow run that requires review. For more information about navigating to a workflow run, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." +2. Click **Review deployments**. ![Review deployments](/assets/images/actions-review-deployments.png) +3. Select the job environment(s) to approve or reject. Optionally, leave a comment. ![Approve deployments](/assets/images/actions-approve-deployments.png) +4. Approve or reject: + - To approve the job, click **Approve and deploy**. Once a job is approved (and any other environment protection rules have passed), the job will proceed. At this point, the job can access any secrets stored in the environment. + - To reject the job, click **Reject**. If a job is rejected, the workflow will fail. 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 index 898f939e431a..15dbfc52534b 100644 --- a/translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/ja-JP/content/actions/reference/authentication-in-a-workflow.md @@ -14,8 +14,6 @@ versions: {% 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`は、ワークフローの実行内での認証に利用できます。 diff --git a/translations/ja-JP/content/actions/reference/encrypted-secrets.md b/translations/ja-JP/content/actions/reference/encrypted-secrets.md index e14a78e759ba..209a748147aa 100644 --- a/translations/ja-JP/content/actions/reference/encrypted-secrets.md +++ b/translations/ja-JP/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- title: 暗号化されたシークレット -intro: 暗号化されたシークレットを使用すると、機密情報をリポジトリまたは Organization に保存できます。 +intro: Encrypted secrets allow you to store sensitive information in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environments{% else %} or repository{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,14 +12,19 @@ versions: --- {% data variables.product.prodname_actions %} の支払いを管理する +{% data reusables.actions.environments-beta %} {% 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 %}に到達する前に暗号化され、ワークフローで使われるまで暗号化されたままになっていることを保証する手助けをします。 +Secrets are encrypted environment variables that you create in an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environment{% else %} or repository{% endif %}. The secrets that 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +For secrets stored at the environment level, you can enable required reviewers to control access to the secrets. A workflow job cannot access environment secrets until approval is granted by required approvers. +{% endif %} + #### シークレットに名前を付ける シークレットの名前には次のルールが適用されます。 @@ -27,7 +32,10 @@ versions: * シークレット名には、英数字（`[a-z]`、`[A-Z]`、`[0-9]`）または下線（`_`）のみを含めることができます。 スペースは使用できません。 * シークレット名の最初を `GITHUB_` プレフィックスにすることはできません。 * シークレット名の最初を数字にすることはできません。 -* シークレット名は、作成されたレベルで一意である必要があります。 たとえば、Organization レベルで作成されたシークレット名はそのレベルで一意である必要があり、リポジトリレベルで作成されたシークレット名はそのリポジトリ内で一意である必要があります。 Organization レベルのシークレット名がリポジトリレベルのシークレット名と同じ場合、リポジトリレベルのシークレット名が優先されます。 +* Secret names are not case-sensitive. +* シークレット名は、作成されたレベルで一意である必要があります。 For example, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}a secret created at the environment level must have a unique name in that environment, {% endif %}a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level. + + If a secret with the same name exists at multiple levels, the secret at the lower level takes precedence. For example, if an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Similarly, if an organization, repository, and environment all have a secret with the same name, the environment-level secret takes precedence.{% endif %} {% data variables.product.prodname_dotcom %} がログのシークレットを確実に削除するよう、シークレットの値として構造化データを使用しないでください。 たとえば、JSONやエンコードされたGit blobを含むシークレットは作成しないでください。 @@ -43,6 +51,10 @@ versions: {% endwarning %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Organization and repository secrets are read when a workflow run is queued, and environment secrets are read when a job referencing the environment starts. +{% endif %} + REST API を使用してシークレットを管理することもできます。 詳しい情報については、「[シークレット](/rest/reference/actions#secrets)」を参照してください。 #### 認証情報のアクセス許可を制限する @@ -56,12 +68,28 @@ REST API を使用してシークレットを管理することもできます {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.github-actions.sidebar-secret %} -1. [**Add a new secret**] をクリックします。 +1. Click **New repository secret**. 1. [名前] 入力ボックスにシークレットの名前 **入力します。 1 シークレットの値を入力します。 1 [**Add secret**] をクリックします。 -リポジトリが親組織のシークレットにアクセスできる場合、そのシークレットもこのページに表示されます。 +If your repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}has environment secrets or {% endif %}can access secrets from the parent organization, then those secrets are also listed on this page. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Creating encrypted secrets for an environment + +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click on the environment that you want to add a secret to. +1. Under **Environment secrets**, click **Add secret**. +1. [名前] 入力ボックスにシークレットの名前 **入力します。 +1 シークレットの値を入力します。 +1 +[**Add secret**] をクリックします。 +{% endif %} ### 組織の暗号化されたシークレットの作成 @@ -72,7 +100,7 @@ REST API を使用してシークレットを管理することもできます {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.sidebar-secret %} -1. [新しいシークレット ****] をクリックします。 +1. Click **New organization secret**. 1. [名前] 入力ボックスにシークレットの名前 **入力します。 1 シークレットの **値** を入力します。 1 [ **リポジトリアクセス** ドロップダウン リストから、アクセス ポリシーを選択します。 @@ -90,7 +118,7 @@ REST API を使用してシークレットを管理することもできます ### 暗号化されたシークレットのワークフロー内での利用 -`GITHUB_TOKEN`を除き、フォークしたリポジトリからワークフローがトリガーされた場合、シークレットは runner に渡されません。 +{% data reusables.actions.forked-secrets %} アクションに入力あるいは環境変数としてシークレットを提供するには、リポジトリ内に作成したシークレットにアクセスする`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)」を参照してください。 @@ -150,7 +178,7 @@ steps: ### シークレットの制限 -ワークフローは、最大で100のシークレットを持てます。 シークレット環境変数の名前は、リポジトリ内でユニークでなければなりません。 +You can store up to 1,000 secrets per organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 secrets per repository, and 100 secrets per environment{% else %} and 100 secrets per repository{% endif %}. A workflow may use up to 100 organization secrets and 100 repository secrets.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Additionally, a job referencing an environment may use up to 100 environment secrets.{% endif %} シークレットの容量は最大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)」を参照してください。 diff --git a/translations/ja-JP/content/actions/reference/environment-variables.md b/translations/ja-JP/content/actions/reference/environment-variables.md index f3428854d7f4..465269fb243f 100644 --- a/translations/ja-JP/content/actions/reference/environment-variables.md +++ b/translations/ja-JP/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)」を参照してください。 +カスタムの環境変数を設定するには、ワークフローファイル中でその変数を指定しなければなりません。 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. 詳しい情報については、「[{% data variables.product.prodname_dotcom %}のワークフロー構文](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)」を参照してください。 ```yaml steps: @@ -51,8 +51,8 @@ steps: | `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_HEAD_REF` | Only set for pull request events. The name of the head branch. | +| `GITHUB_BASE_REF` | Only set for pull request events. The name of the base branch. | | `GITHUB_SERVER_URL` | {% data variables.product.product_name %} サーバーの URL を返します。 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`. | diff --git a/translations/ja-JP/content/actions/reference/environments.md b/translations/ja-JP/content/actions/reference/environments.md new file mode 100644 index 000000000000..58585b2950b1 --- /dev/null +++ b/translations/ja-JP/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: Environments +intro: You can configure environments with protection rules and secrets. A workflow job can reference an environment to use the environment's protection rules and secrets. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About environments + +You can configure environments with protection rules and secrets. When a workflow job references an environment, the job won't start until all of the environment's protection rules pass. A job also cannot access secrets that are defined in an environment until all the environment protection rules pass. + +{% if currentVersion == "free-pro-team@latest" %} +Environment protection rules and environment secrets are only available on public repositories. If you convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. +{% endif %} + +#### Environment protection rules + +Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use environment protection rules to require a manual approval or to delay a job. + +##### Required reviewers + +Use required reviewers to require a specific person or team to approve workflow jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed. + +For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +##### Wait timer + +Use a wait timer to delay a job for a specific amount of time after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days). + +#### Environment secrets + +Secrets stored in an environment are only available to workflow jobs that reference the environment. If the environment requires approval, a job cannot access environment secrets until one of the required reviewers approves it. For more information about secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Creating an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click **New environment**. +1. Enter a name for the environment, then click **Configure environment**. Environment names are not case sensitive. An environment name may not exceed 255 characters and must be unique within the repository. +1. Configure any environment protection rules or environment secrets. + +Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment. + +### Referencing an environment + +Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. When the job is sent to the runner, the job can access the environment's secrets. + +For more information on syntax to reference environments in workflows, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)." For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +When a workflow references an environment, the environment will appear in the repository's deployments. For more information about viewing current and previous deployments, see "[Viewing deployment history](/developers/overview/viewing-deployment-history)." + +### Deleting an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +Deleting an environment will delete all secrets and protection rules associated with the environment. Any jobs currently waiting because of protection rules from the deleted environment will automatically fail. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Next the the environment that you want to delete, click {% octicon "trashcan" aria-label="The trashcan icon" %}. +2. Click **I understand, delete this environment**. 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 02d4025f521d..9921a26477c4 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 @@ -131,7 +131,7 @@ jobs: steps: - run: | echo "Hello ${{ github.event.inputs.name }}!" - エコー "- ${{ github.event.inputs.home }}で! + echo "- in ${{ github.event.inputs.home }}!" ``` {% endraw %} @@ -224,7 +224,7 @@ on: #### `delete` -誰かがブランチまたはタグを作成し、それによって `create` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[リファレンスの削除](/rest/reference/git#delete-a-reference)」を参照してください。 +誰かがブランチまたはタグを作成し、それによって `delete` イベントがトリガーされるときにワークフローを実行します。 REST API の詳細については、「[リファレンスの削除](/rest/reference/git#delete-a-reference)」を参照してください。 {% data reusables.github-actions.branch-requirement %} @@ -309,9 +309,9 @@ on: {% data reusables.github-actions.branch-requirement %} -| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | -| --------------------------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------ | -| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | +| webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------- | ------------ | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | デフォルトブランチの直近のコミット | デフォルトブランチ | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -576,7 +576,13 @@ on: #### `pull_request_target` -このイベントは `pull_request` に似ていますが、マージコミットではなく、プルリクエストのベースリポジトリのコンテキストで実行される点で異なります。 つまり、ベースリポジトリのコミットで定義されたワークフローのみが実行されるため、プルリクエストによってトリガーされたワークフローでシークレットをより安全に使用できるようになります。 たとえば、このイベントでは、イベントペイロードの内容に基づいて、プルリクエストにラベルを付けてコメントを付けるワークフローを作成できます。 +This event runs in the context of the base of the pull request, rather than in the merge commit as the `pull_request` event does. This prevents executing unsafe workflow code from the head of the pull request that could alter your repository or steal any secrets you use in your workflow. This event allows you to do things like create workflows that label and comment on pull requests based on the contents of the event payload. + +{% warning %} + +**Warning:** The `pull_request_target` event is granted a read/write repository token and can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch, and to help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. + +{% endwarning %} | webhook イベントのペイロード | アクティビティタイプ | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ | ------------ | @@ -725,4 +731,4 @@ on: {% data reusables.github-actions.actions-do-not-trigger-workflows %} 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 -ワークフローの実行からワークフローをトリガーしたい場合意は、個人アクセストークンを使ってイベントをトリガーできます。 個人アクセストークンを作成し、それをシークレットとして保存する必要があります。 {% data variables.product.prodname_actions %}の利用コストを最小化するために、再帰的あるいは意図しないワークフローの実行が生じないようにしてください。 詳しい情報については「[暗号化されたシークレットの作成と保存](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)」を参照してください。 +ワークフローの実行からワークフローをトリガーしたい場合意は、個人アクセストークンを使ってイベントをトリガーできます。 個人アクセストークンを作成し、それをシークレットとして保存する必要があります。 {% data variables.product.prodname_actions %}の利用コストを最小化するために、再帰的あるいは意図しないワークフローの実行が生じないようにしてください。 For more information on storing a personal access token as a secret, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." diff --git a/translations/ja-JP/content/actions/reference/index.md b/translations/ja-JP/content/actions/reference/index.md index 45a4375628ec..1387d28de807 100644 --- a/translations/ja-JP/content/actions/reference/index.md +++ b/translations/ja-JP/content/actions/reference/index.md @@ -27,11 +27,19 @@ versions: ### 認証とシークレット -{% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_actions %}の代理で認証を受けるために利用できるトークンを提供します。 機密情報をシークレットとして Organization またはリポジトリに保存することもできます。 {% data variables.product.prodname_dotcom %} はすべてのシークレットを暗号化します。 +{% data variables.product.prodname_dotcom %}は、{% data variables.product.prodname_actions %}の代理で認証を受けるために利用できるトークンを提供します。 You can also store sensitive information as a secret in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environments{% else %} or repository{% endif %}. {% data variables.product.prodname_dotcom %} はすべてのシークレットを暗号化します。 {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Environments + +Workflow jobs can reference environments that have protection rules or environment-specific secrets. + +{% link_in_list /environments %} +{% endif %} + ### {% data variables.product.prodname_dotcom %}ホストランナー GitHub は、ワークフローを実行するホストされた仮想マシンを提供します。 仮想マシンには、GitHub Actions が使用するツール、パッケージ、および環境変数を備えた環境が含まれます。 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 a5ec6b636a29..38ef1f86b0f4 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 @@ -305,11 +305,13 @@ steps: `echo "{path}" >> $GITHUB_PATH` -現在のジョブ内にある、続くすべてのアクションにおいて、システム `PATH` 変数の前に、ディレクトリを付加します。 現在実行中のアクションは、新しいパス変数にアクセスできません。 +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### サンプル +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 1617fb429b4b..282be096f179 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 @@ -187,7 +187,7 @@ cron構文に関する詳しい情報については、「[ワークフローを ### `env` -ワークフロー中のすべてのジョブやステップから利用できる環境変数の`map`です。 1つのジョブあるいはステップからだけ利用できる環境変数を設定することもできます。 詳しい情報については「[`jobs..env`](#jobsjob_idenv)」及び「[`jobs..steps.env`](#jobsjob_idstepsenv)を参照してください。 +ワークフロー中のすべてのジョブやステップから利用できる環境変数の`map`です。 1つのジョブあるいはステップからだけ利用できる環境変数を設定することもできます。 For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: 1つのワークフロー実行は、1つ以上のジョブからなります。 デフォルトでは、ジョブは並行して実行されます。 ジョブを逐次的に実行するには、`jobs..needs`キーワードを使用して他のジョブに対する依存関係を定義します。 -それぞれのジョブは、`runs-on`で指定された環境で実行されます。 +Each job runs in a runner environment specified by `runs-on`. ワークフローの利用限度内であれば、実行するジョブ数に限度はありません。 詳細については、{% data variables.product.prodname_dotcom %} ホストランナーの「[使用制限と支払い](/actions/reference/usage-limits-billing-and-administration)」、およびセルフホストランナーの使用制限については「[セルフホストランナーについて](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)」を参照してください。 @@ -320,6 +320,39 @@ 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)」を参照してください。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +The environment that the job references. All environment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." + +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[Deployments](/rest/reference/repos#deployments)." + +##### Example using a single environment name + +```yaml +environment: staging_environment +``` + +##### Example using environment name and URL + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +The URL can be an expression and can use any context except for the `secrets` context. For more information about expressions, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +#### サンプル +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `jobs..outputs` ジョブからの出力の`map`です。 ジョブの出力は、そのジョブに依存しているすべての下流のジョブから利用できます。 ジョブの依存関係の定義に関する詳しい情報については[`jobs..needs`](#jobsjob_idneeds)を参照してください。 @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -ジョブ中のすべてのステップから利用できる環境変数の`map`です。 ワークフロー全体あるいは個別のステップのための環境変数を設定することもできます。 詳しい情報については「[`env`](#env)」及び「[`jobs..steps.env`](#jobsjob_idstepsenv)」を参照してください。 +ジョブ中のすべてのステップから利用できる環境変数の`map`です。 ワークフロー全体あるいは個別のステップのための環境変数を設定することもできます。 For more information, see [`env`](#env) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `jobs..steps[*].id` ステップの一意の識別子。 `id`を使って、コンテキストのステップを参照することができます。 詳しい情報については、「[{% data variables.product.prodname_actions %} のコンテキストと式構文](/actions/reference/context-and-expression-syntax-for-github-actions)」を参照してください。 -### `jobs..steps.if` +### `jobs..steps[*].if` 条件文の`if`を使って、条件が満たされなければステップを実行しないようにできます。 条件文を作成するには、サポートされている任意のコンテキストや式が使えます。 @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` {% data variables.product.prodname_dotcom %}で表示されるステップの名前。 -### `jobs..steps.uses` +### `jobs..steps[*].uses` ジョブでステップの一部として実行されるアクションを選択します。 アクションとは、再利用可能なコードの単位です。 ワークフロー、パブリックリポジトリ、または[公開されているDockerコンテナイメージ](https://hub.docker.com/)と同じリポジトリで定義されているアクションを使用できます。 @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` オペレーティングシステムのシェルを使用してコマンドラインプログラムを実行します。 `name`を指定しない場合、ステップ名はデフォルトで`run`コマンドで指定された文字列になります。 @@ -675,7 +708,7 @@ steps: - 各エラーコードをチェックしてそれぞれに対応するスクリプトを書く以外、フェイルファースト動作を完全にオプトインする方法はないようです。 デフォルトでその動作を指定することはできないため、この動作はスクリプトに記述する必要があります。 - `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. この動作は、これ以前の`sh`および`pwsh`のデフォルト動作と内部的に一貫しており、`cmd.exe`のデフォルトなので、この動作には影響しません。 -### `jobs..steps.with` +### `jobs..steps[*].with` アクションによって定義される入力パラメータの`map`。 各入力パラメータはキー/値ペアです。 入力パラメータは環境変数として設定されます。 変数の前には`INPUT_`が付けられ、大文字に変換されます。 @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` Dockerコンテナへの入力を定義する`文字列`。 {% data variables.product.prodname_dotcom %}は、コンテナの起動時に`args`をコンテナの`ENTRYPOINT`に渡します。 このパラメータは、`文字列の配列`をサポートしません。 @@ -718,7 +751,7 @@ steps: 1. `args`を指定せずにアクションを利用できるよう、デフォルトを使ってください。 1. アクションが`--help`フラグやそれに類するものを備えている場合は、アクションを自己ドキュメント化するためのデフォルトとして利用してください。 -### `jobs..steps.with.entrypoint` +### `jobs..steps[*].with.entrypoint` `Dockerfile`中のDockerの`ENTRYPOINT`をオーバーライドします。あるいは、もしそれが指定されていなかった場合に設定します。 shellやexec形式を持つDockerの`ENTRYPOINT`命令とは異なり、`entrypoint`キーワードは実行する実行可能ファイルを定義する単一の文字列だけを受け付けます。 @@ -734,7 +767,7 @@ steps: The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs. -### `jobs..steps.env` +### `jobs..steps[*].env` ランナー環境でステップが使う環境変数を設定します。 ワークフロー全体あるいはジョブのための環境変数を設定することもできます。 詳しい情報については「[`env`](#env)」及び「[`jobs..env`](#jobsjob_idenv)」を参照してください。 @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` ステップが失敗してもジョブが失敗にならないようにします。 `true`に設定すれば、このステップが失敗した場合にジョブが次へ進めるようになります。 -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` プロセスがkillされるまでにステップが実行できる最大の分数。 @@ -769,7 +802,7 @@ steps: ### `jobs..strategy` -strategy (戦略) によって、ジョブのビルドマトリクスが作成されます。 各ジョブを実行する環境のバリエーションを定義できます。 +strategy (戦略) によって、ジョブのビルドマトリクスが作成されます。 You can define different variations to run each job in. ### `jobs..strategy.matrix` 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 8e16bbdc6c87..ee16d97d44fe 100644 --- a/translations/ja-JP/content/admin/configuration/command-line-utilities.md +++ b/translations/ja-JP/content/admin/configuration/command-line-utilities.md @@ -283,7 +283,7 @@ $ ghe-saml-mapping-csv -u -n -f /path/to/file 新しい値でSAMLマッピングを更新するには、次のようにします。 ```shell -$ ghe-saml-mapping-csv -u -n -f /path/to/file +$ ghe-saml-mapping-csv -u -f /path/to/file ``` #### ghe-service-list diff --git a/translations/ja-JP/content/admin/configuration/configuring-email-for-notifications.md b/translations/ja-JP/content/admin/configuration/configuring-email-for-notifications.md index 15da3313baa8..831bacf9e2e0 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/ja-JP/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ Your dedicated technical account manager in {% data variables.contact.github_support %} can configure email for notifications to be sent through your SMTP server. Make sure you include the following details in your support request. - Your SMTP server address +- Login information to authenticate to the server: username and password - The port your SMTP server uses to send email - The domain name that your SMTP server will send with a HELO response, if any - The type of encryption used by your SMTP server 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 c0c0c7aee118..b5417575a62a 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 @@ -94,7 +94,7 @@ For urgent issues, we {% else %}We{% endif %} are available 24 hours per day, 7 | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | 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 fa9a6e542423..c696b1890489 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 @@ -44,7 +44,7 @@ versions: {% data variables.contact.enterprise_support %} は、以下の米国の祝日を休日としています。 （アメリカの祝日は除く） -| アメリカ合衆国の祝日 祝日 | 2018年の祝日 | +| アメリカ合衆国の祝日 祝日 | 対象日付 | | --------------------------- | --------------------------- | | New Year's Day | January 1 | | Martin Luther King, Jr. Day | Third Monday in January | @@ -57,7 +57,7 @@ versions: | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | New Year's Eve | December 31 | ### {% data variables.product.prodname_advanced_security %} のアップデートのインストール diff --git a/translations/ja-JP/content/admin/overview/about-enterprise-accounts.md b/translations/ja-JP/content/admin/overview/about-enterprise-accounts.md index dbb8a037a7bf..cbd522aa90af 100644 --- a/translations/ja-JP/content/admin/overview/about-enterprise-accounts.md +++ b/translations/ja-JP/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ An enterprise account allows you to manage multiple organizations{% if enterpris - Security {% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication) - Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} 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 7e2b5a300a95..4ad99bf8025e 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 @@ -51,6 +51,7 @@ macOSでのGitHub Desktopキーボードショートカット | ⌘2 | コミット履歴を表示 | | ⌘B | 全てのブランチを表示 | | ⌘G | コミット概要のフィールドに移動 | +| ⌘Enter | 概要または説明フィールドがアクティブな場合に変更をコミット | | space | ハイライトされたすべてのファイルを選択または選択解除 | | ⇧⌘N | 新規ブランチの作成 | | ⇧⌘R | 現在ブランチの名前を変更 | @@ -104,6 +105,7 @@ WindowsでのGitHub Desktopキーボードのショートカット | Ctrl2 | コミット履歴を表示 | | CtrlB | 全てのブランチを表示 | | CtrlG | コミット概要のフィールドに移動 | +| CtrlEnter | 概要または説明フィールドがアクティブな場合に変更をコミット | | space | ハイライトされたすべてのファイルを選択または選択解除 | | CtrlShiftN | 新規ブランチの作成 | | CtrlShiftR | 現在ブランチの名前を変更 | 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 31c9ff647b41..ea678905057e 100644 --- a/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ja-JP/content/developers/apps/authorizing-oauth-apps.md @@ -117,7 +117,7 @@ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre {% if currentVersion ver_lt "enterprise-server@3.1" %} {% note %} -**Note:** The device flow is in public beta and subject to change. +**注釈:** デバイスフローは現在パブリックベータであり、変更されることがあります。 {% endnote %} {% endif %} @@ -265,7 +265,9 @@ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre `http://localhost/path`というコールバックURLに対して、以下の`redirect_uri`が利用できます。 - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### OAuthアプリケーションに複数のトークンを作成する 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 c2229e0e70df..f7be3190f757 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 @@ -49,39 +49,39 @@ versions: 以下の表にある権限名をクエリパラメータ名として、権限タイプをクエリの値として使用することで、クエリ文字列で権限を設定できます。 たとえば、`contents` のユーザインターフェースに `Read & write` 権限を設定するには、クエリ文字列に `&contents=write` を含めます。 `blocking` のユーザインターフェースに `Read-only` 権限を設定するには、クエリ文字列に `&blocking=read` を含めます。 `checks` のユーザインターフェースに `no-access` を設定するには、クエリ文字列に `checks` 権限を含めないようにします。 -| 権限 | 説明 | -| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 権限 | 説明 | +| -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | Organization およびリポジトリ管理のためのさまざまなエンドポイントにアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% if currentVersion == "free-pro-team@latest" %} | [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | [Blocking Users API](/rest/reference/users#blocking) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %} -| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | [Checks API](/rest/reference/checks) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| `content_references` | 「[コンテンツ添付の作成](/rest/reference/apps#create-a-content-attachment)」エンドポイントへのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | さまざまなエンドポイントにアクセス権を付与し、リポジトリのコンテンツを変更できるようにします。 `none`、`read`、`write` のいずれかです。 | +| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | [Checks API](/rest/reference/checks) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| `content_references` | 「[コンテンツ添付の作成](/rest/reference/apps#create-a-content-attachment)」エンドポイントへのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`contents`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | さまざまなエンドポイントにアクセス権を付与し、リポジトリのコンテンツを変更できるようにします。 `none`、`read`、`write` のいずれかです。 | | [`deployments`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | [Deployments API](/rest/reference/repos#deployments) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | [Emails API](/rest/reference/users#emails) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %} -| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | [Followers API](/rest/reference/users#followers) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | [GPG Keys API](/rest/reference/users#gpg-keys) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | [Issues API](/rest/reference/issues) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | [Public Keys API](/rest/reference/users#keys) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | [Followers API](/rest/reference/users#followers) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | [GPG Keys API](/rest/reference/users#gpg-keys) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | [Issues API](/rest/reference/issues) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | [Public Keys API](/rest/reference/users#keys) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | | [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | Organization のメンバーへのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% if currentVersion == "free-pro-team@latest" %} -| [`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | 機密データを漏洩しない、読み取り専用のエンドポイントへのアクセス権を付与します。 `read`、`none` のいずれかです。 {% data variables.product.prodname_github_app %} に何らかの権限を設定した場合、デフォルトは `read` となり、権限を指定しなかった場合、デフォルトは `none` となります。 | +| [`metadata`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | 機密データを漏洩しない、読み取り専用のエンドポイントへのアクセス権を付与します。 `read`、`none` のいずれかです。 {% data variables.product.prodname_github_app %} に何らかの権限を設定した場合、デフォルトは `read` となり、権限を指定しなかった場合、デフォルトは `none` となります。 | | [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | 「[Organization の更新](/rest/reference/orgs#update-an-organization)」エンドポイントと、[Organization Interaction Restrictions API](/rest/reference/interactions#set-interaction-restrictions-for-an-organization) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | [Organization Webhooks API](/rest/reference/orgs#webhooks/) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| `organization_plan` | 「[Organization の取得](/rest/reference/orgs#get-an-organization)」エンドポイントを使用して Organization のプランについての情報を取得するためのアクセス権を付与します。 `none`、`read` のいずれかです。 | +| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | [Organization Webhooks API](/rest/reference/orgs#webhooks/) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| `organization_plan` | 「[Organization の取得](/rest/reference/orgs#get-an-organization)」エンドポイントを使用して Organization のプランについての情報を取得するためのアクセス権を付与します。 `none`、`read` のいずれかです。 | | [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | [Projects API](/rest/reference/projects) へのアクセス権を付与します。 `none`、`read`、`write`、`admin` のいずれかです。{% if currentVersion == "free-pro-team@latest" %} | [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | [Blocking Organization Users API](/rest/reference/orgs#blocking) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %} -| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | [Pages API](/rest/reference/repos#pages) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| `plan` | 「[ユーザの取得](/rest/reference/users#get-a-user)」エンドポイントを使用してユーザの GitHub プランについての情報を取得するためのアクセス権を付与します。 `none`、`read` のいずれかです。 | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | さまざまなプルリクエストエンドポイントへのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | [Repository Webhooks API](/rest/reference/repos#hooks) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`pages`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | [Pages API](/rest/reference/repos#pages) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| `plan` | 「[ユーザの取得](/rest/reference/users#get-a-user)」エンドポイントを使用してユーザの GitHub プランについての情報を取得するためのアクセス権を付与します。 `none`、`read` のいずれかです。 | +| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | さまざまなプルリクエストエンドポイントへのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | [Repository Webhooks API](/rest/reference/repos#hooks) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | | [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | [Projects API](/rest/reference/projects) へのアクセス権を付与します。 `none`、`read`、`write`、`admin` のいずれかです。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} | [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | [Secret scanning API](/rest/reference/secret-scanning) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | [Code scanning API](/rest/reference/code-scanning/) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | [Contents API](/rest/reference/repos#contents) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | [Starring API](/rest/reference/activity#starring) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`ステータス`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | [Statuses API](/rest/reference/repos#statuses) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | [Team Discussions API](/rest/reference/teams#discussions) および [Team Discussion Comments API](/rest/reference/teams#discussion-comments) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | -| `vulnerability_alerts` | リポジトリ内の脆弱性のある依存関係に対するセキュリティアラートを受信するためのアクセス権を付与します。 詳細は「[脆弱性のある依存関係に対するセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies)」を参照。 `none`、`read` のいずれかです。 | -| `Watch` | リストへのアクセス権を付与し、ユーザがサブスクライブするリポジトリの変更を許可します。 `none`、`read`、`write` のいずれかです。 | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | [Contents API](/rest/reference/repos#contents) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`starring`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | [Starring API](/rest/reference/activity#starring) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`ステータス`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | [Statuses API](/rest/reference/repos#statuses) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。 | +| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | [Team Discussions API](/rest/reference/teams#discussions) および [Team Discussion Comments API](/rest/reference/teams#discussion-comments) へのアクセス権を付与します。 `none`、`read`、`write` のいずれかです。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `vulnerability_alerts` | リポジトリ内の脆弱性のある依存関係に対するセキュリティアラートを受信するためのアクセス権を付与します。 詳細は「[脆弱性のある依存関係に対するセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies)」を参照。 `none`、`read` のいずれかです。{% endif %} +| `Watch` | リストへのアクセス権を付与し、ユーザがサブスクライブするリポジトリの変更を許可します。 `none`、`read`、`write` のいずれかです。 | ### {% data variables.product.prodname_github_app %} webhook イベント 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 0a23419f3761..a3743928e1ba 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 @@ -832,7 +832,7 @@ end ### トラブルシューティング -Here are a few common problems and some suggested solutions. If you run into any other trouble, you can ask for help or advice in the {% data variables.product.prodname_support_forum_with_url %}. +以下は、いくつかの一般的な問題と推奨される解決策です。 他の問題が生じた場合は、{% data variables.product.prodname_support_forum_with_url %}で助けやアドバイスを求めることができます。 * **Q:** アプリケーションが GitHub にコードをプッシュしません。 RuboCop が自動的に行う修正が表示されません。 @@ -858,7 +858,7 @@ Here are a few common problems and some suggested solutions. If you run into any ### おわりに -このガイドの手順を一通り終えたら、Checks API を使用して CI サーバーを作成することの基本が習得できています。 To review, you: +このガイドの手順を一通り終えたら、Checks API を使用して CI サーバーを作成することの基本が習得できています。 振り返ると、以下を行いました。 * Checks API イベントを受信し、チェック実行を作成するようサーバーを設定しました。 * リポジトリ内のコードをチェックし、エラーのアノテーションを作成するため RuboCop を使用しました。 @@ -866,7 +866,7 @@ Here are a few common problems and some suggested solutions. If you run into any ### 次のステップ -Here are some ideas for what you can do next: +以下は、次に行えることのいくつかのアイデアです。 * 現在、[Fix this] ボタンは常に表示されています。 ここまで書いたコードを更新し、RuboCop がエラーを見つけた時にのみ [Fix this] ボタンが表示されるようにしましょう。 * RuboCop がファイルを head ブランチに直接コミットしないようにしたい場合、head ブランチに基づいて新しいブランチで[プルリクエストを作成する](/rest/reference/pulls#create-a-pull-request)ようにコードを更新できます。 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 59c7538b04f2..19799bdabe37 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 @@ -28,80 +28,80 @@ GitHub App は、個人アカウントおよび自分が所有する Organizatio | GitHub App をアンインストールしてアクセス権限を削除するには、Organization のオーナーであるか、個人リポジトリの所有者であるか、リポジトリの管理者権限を所有している必要があります。 | OAuth アクセストークンを削除して、アクセス権限を削除することができます。 | | GitHub App のインストールを要求するには、Organization のオーナーであるかリポジトリの管理者権限を所有している必要があります。 | Organization のアプリケーションポリシーが有効である場合、その Organization の任意のメンバーが OAuth App のインストールを要求できます。 Organization のオーナーは、その要求を承認または拒否する必要があります。 | -### What can GitHub Apps and OAuth Apps access? +### GitHub App と OAuth App がアクセスできるリソース アカウントの所有者は、別のアカウントにアクセス権限を与えることなく {% data variables.product.prodname_github_app %} を使用できます。 たとえば、サードパーティ製のビルドサービスを従業員の Organization にインストールしつつ、そのビルドサービスに個人アカウントにあるリポジトリへのアクセスを許可しないことができます。 GitHub App をセットアップした人が Organization から離れても、その GitHub App はインストールされたままになります。 _承認された_ OAuth App は、 ユーザまたは Organization のオーナーがアクセス可能なすべてのリソースにアクセスできます。 -| GitHub Apps | OAuth App | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| GitHub App をインスールすると、アプリケーションはユーザまたは Organization アカウントの指定したリポジトリにアクセス可能になります。 | OAuth App を承認すると、アプリケーションはユーザがアクセス可能なリソースにアクセスできます。 （例: リポジトリ） | -| 管理者がインストールからリポジトリを削除した場合、GitHub App のインストールトークンはリソースにアクセスできなくなります。 | リポジトリへの書き込みアクセスを失ったときなど、ユーザがアクセスを失ったとき、OAuth アクセストークンはリソースにアクセスできなくなります。 | -| インストールアクセストークンは、アプリケーションの作成者が指定したリポジトリの、選択した権限に制限されます。 | OAuth アクセストークンは、スコープにより制限されます。 | -| GitHub App は、リポジトリの実際のコンテンツにアクセスすることなく、Issue やプルリクエストへの個別のアクセスを要求できます。 | OAuth App は、Issue やプルリクエストなど、リポジトリが所有するリソースにアクセスするには `repo` スコープをリクエストする必要があります。 | -| GitHub Apps aren't subject to organization application policies. A GitHub App only has access to the repositories an organization owner has granted. | If an organization application policy is active, only an organization owner can authorize the installation of an OAuth App. If installed, the OAuth App gains access to anything visible to the token the organization owner has within the approved organization. | -| A GitHub App receives a webhook event when an installation is changed or removed. This tells the app creator when they've received more or less access to an organization's resources. | OAuth Apps can lose access to an organization or repository at any time based on the granting user's changing access. The OAuth App will not inform you when it loses access to a resource. | +| GitHub Apps | OAuth App | +| ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| GitHub App をインスールすると、アプリケーションはユーザまたは Organization アカウントの指定したリポジトリにアクセス可能になります。 | OAuth App を承認すると、アプリケーションはユーザがアクセス可能なリソースにアクセスできます。 （例: リポジトリ） | +| 管理者がインストールからリポジトリを削除した場合、GitHub App のインストールトークンはリソースにアクセスできなくなります。 | リポジトリへの書き込みアクセスを失ったときなど、ユーザがアクセスを失ったとき、OAuth アクセストークンはリソースにアクセスできなくなります。 | +| インストールアクセストークンは、アプリケーションの作成者が指定したリポジトリの、選択した権限に制限されます。 | OAuth アクセストークンは、スコープにより制限されます。 | +| GitHub App は、リポジトリの実際のコンテンツにアクセスすることなく、Issue やプルリクエストへの個別のアクセスを要求できます。 | OAuth App は、Issue やプルリクエストなど、リポジトリが所有するリソースにアクセスするには `repo` スコープをリクエストする必要があります。 | +| GitHub App には、Organization のアプリケーションポリシーは適用されません。 GitHub App は、Organization のオーナーが許可したリポジトリにのみアクセスできます。 | Organization のアプリケーションポリシーが有効である場合、Organization のオーナーのみが OAuth App のインストールを承認できます。 インストールされた OAuth App は、承認を受けた Organization において Organization のオーナーが所有するトークンで表示できるすベてのリソースにアクセスできます。 | +| GitHub App は、インストールが変更または削除されると webhook イベントを受信します。 これにより、アプリケーションの作者は、GitHub App の Organization のリソースに対するアクセス権が変更されたことがわかります。 | OAuth App は、付与したユーザのアクセス権が変更されると、Organization やリポジトリへのアクセス権を失います。 OAuth App は、リソースへのアクセス権を失った際にも通知を行いません。 | -### Token-based identification +### トークンベースの識別 {% note %} -**Note:** GitHub Apps can also use a user-based token. For more information, see "[Identifying and authorizing users for GitHub Apps](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)." +**注釈:** GitHub App は、ユーザベーストークンも使用できます。 詳しい情報については「[GitHub App のユーザの特定と認可](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)」を参照してください。 {% endnote %} -| GitHub Apps | OAuth App | -| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| 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" or currentVersion == "github-ae@latest" %} -| {% 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 %} +| GitHub Apps | OAuth App | +| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| GitHub App は、JSON Web トークンフォーマットのアウトオブバンドで秘密鍵を使用することにより、インストールアクセストークンをリクエストできます。 | OAuth App は、Web リクエストを通じてリダイレクトされた後にリクエストトークンをアクセストークンに交換できます。 | +| インストールトークンは、アプリケーションを GitHub App のボット (@jenkins-bot など) として識別します。 | アクセストークンは、アプリケーションを、アプリケーションにトークンを付与したユーザ (@octocat など) として識別します。 | +| インストールトークンは、事前に定義された時間 (現在は 1 時間) が経過すると期限切れになります。 | OAuth トークンは、顧客によって取り消されるまで有効となります。 | +| {% data reusables.apps.api-rate-limits-non-ghec %}{% if currentVersion == "free-pro-team@latest" %}{% data variables.product.prodname_ghe_cloud %} では、適用されるレート制限値が高くなります。 詳しい情報については、「[GitHub App のレート制限](/developers/apps/rate-limits-for-github-apps)」を参照してください。{% endif %} | OAuth トークンでは、1 時間あたり 5,000 リクエストのレート制限が適用されます。 | +| レート制限の増加は、GitHub App レベル (すべてのインストールに影響) と個々のインストールレベルの両方に適用できます。 | レート制限の増加は、OAuth App ごとに適用されます。 その OAuth App に付与されたすべてのトークンで、制限値が増大します。 |{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +| {% data variables.product.prodname_github_app %} は、ユーザの代わりに認証を行うことができ、これをユーザからサーバーに対するリクエストといいます。 このフローは、OAuth App 認可フローと同じです。 ユーザからサーバーに対するトークンは期限切れとなることがあり、リフレッシュトークンで更新できます。 詳しい情報については、「[ユーザからサーバーに対するアクセストークンをリフレッシュする](/apps/building-github-apps/refreshing-user-to-server-access-tokens/)」および「[GitHub Apps のユーザの特定と認可](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)」を参照してください。 | {% data variables.product.prodname_oauth_app %} により使用される OAuth フローでは、ユーザの代わりに {% data variables.product.prodname_oauth_app %} を承認します。 これは、{% data variables.product.prodname_github_app %} ユーザからサーバーに対する承認で用いられるフローと同じです。 |{% endif %} -### Requesting permission levels for resources +### リソースに対する権限レベルのリクエスト -Unlike OAuth apps, GitHub Apps have targeted permissions that allow them to request access only to what they need. For example, a Continuous Integration (CI) GitHub App can request read access to repository content and write access to the status API. Another GitHub App can have no read or write access to code but still have the ability to manage issues, labels, and milestones. OAuth Apps can't use granular permissions. +OAuth App と異なり、GitHub App には必要なアクセス権のみをリクエストできる、ターゲットを絞った権限があります。 たとえば、継続的インテグレーション (CI) GitHub App は、リポジトリコンテンツへの読み取りアクセスと、ステータス API への書き込みアクセスをリクエストできます。 別の GitHub App では、コードへの読み取りおよび書き込みアクセスを持たせずに、Issue、ラベル、マイルストーンを管理させることが可能です。 OAuth App では、権限を細かく設定できません。 -| アクセス | GitHub Apps (`read` or `write` permissions) | OAuth App | -| ------------------------------------------------------- | --------------------------------------------------------- | -------------------------------------------- | -| **For access to public repositories** | Public repository needs to be chosen during installation. | `public_repo` scope. | -| **For access to repository code/contents** | リポジトリコンテンツ | `repo` scope. | -| **For access to issues, labels, and milestones** | 問題 | `repo` scope. | -| **For access to pull requests, labels, and milestones** | プルリクエスト | `repo` scope. | -| **For access to commit statuses (for CI builds)** | Commit statuses | `repo:status` scope. | -| **For access to deployments and deployment statuses** | デプロイメント | `repo_deployment` scope. | -| **To receive events via a webhook** | A GitHub App includes a webhook by default. | `write:repo_hook` or `write:org_hook` scope. | +| アクセス | GitHub App (`read` または `write` 権限) | OAuth App | +| -------------------------------- | -------------------------------------- | -------------------------------------------- | +| **パブリックリポジトリへのアクセス** | パブリックリポジトリはインストール中に選択する必要があります。 | `public_repo` スコープ。 | +| **リポジトリコード/コンテンツへのアクセス** | リポジトリコンテンツ | `repo` スコープ。 | +| **Issue、ラベル、マイルストーンへのアクセス** | 問題 | `repo` スコープ。 | +| **プルリクエスト、ラベル、マイルストーンへのアクセス** | プルリクエスト | `repo` スコープ。 | +| **(CI ビルドの) コミットのステータスへのアクセス** | コミットのステータス | `repo:status` スコープ。 | +| **デプロイメントおよびデプロイメントステータスへのアクセス** | デプロイメント | `repo_deployment` スコープ。 | +| **webhook 経由によるイベントの受信** | GitHub App には、デフォルトで webhook が含まれています。 | `write:repo_hook` または `write:org_hook` スコープ。 | -### Repository discovery +### リポジトリの確認 -| GitHub Apps | OAuth App | -| ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| GitHub Apps can look at `/installation/repositories` to see repositories the installation can access. | OAuth Apps can look at `/user/repos` for a user view or `/orgs/:org/repos` for an organization view of accessible repositories. | -| GitHub Apps receive webhooks when repositories are added or removed from the installation. | OAuth Apps create organization webhooks for notifications when a new repository is created within an organization. | +| GitHub Apps | OAuth App | +| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | +| GitHub App は、`/installation/repositories` を参照して、インストールでアクセスできるリポジトリを確認できます。 | OAuth App は、ユーザ表示 (`/user/repos`) または Organization 表示 (`/orgs/:org/repos`) を参照して、アクセスできるリポジトリを確認できます。 | +| GitHub App は、リポジトリがインストールから追加または削除されたときに webhook を受信します。 | OAuth App は、Organization 内で新しいリポジトリが作成されたときに通知用の Organization webhook を作成します。 | ### webhook -| GitHub Apps | OAuth App | -| ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they needs to receive events from. | -| GitHub Apps receive certain organization-level events with the organization member's permission. | OAuth Apps request the organization webhook scope to create an organization webhook for each organization they need to receive organization-level events from. | +| GitHub Apps | OAuth App | +| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | +| デフォルトでは、GitHub App には webhook が 1 つあり、その webhook は、アクセス権のあるすべてのリポジトリにおいて、受信するよう設定されたイベントを受信します。 | OAuth App は、イベントを受信する必要がある各リポジトリに対し、リポジトリ webhook を作成するため webhook スコープをリクエストします。 | +| GitHub App は、Organization メンバーの権限で、特定の Organization レベルのイベントを受信します。 | OAuth App は、Organization レベルのイベントを受信する必要がある各 Organization に対し、Organization webhook を作成するため Organization webhook スコープをリクエストします。 | -### Git access +### Git アクセス -| GitHub Apps | OAuth App | -| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| GitHub Apps ask for repository contents permission and use your installation token to authenticate via [HTTP-based Git](/apps/building-github-apps/authenticating-with-github-apps/#http-based-git-access-by-an-installation). | OAuth Apps ask for `write:public_key` scope and [Create a deploy key](/rest/reference/repos#create-a-deploy-key) via the API. You can then use that key to perform Git commands. | -| The token is used as the HTTP password. | The token is used as the HTTP username. | +| GitHub Apps | OAuth App | +| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | +| GitHub App は、リポジトリコンテンツの権限を求め、[HTTP ベースのGit](/apps/building-github-apps/authenticating-with-github-apps/#http-based-git-access-by-an-installation) 経由で認証するためインストールトークンを使用します。 | OAuth App は `write:public_key` スコープを要求し、API 経由で[デプロイキーを作成](/rest/reference/repos#create-a-deploy-key)します。 そして、そのキーを使用して Git コマンドを実行できます。 | +| トークンは、HTTP パスワードとして使用されます。 | トークンは、HTTP ユーザ名として使用されます。 | -### Machine vs. bot accounts +### マシンアカウントとボットアカウントの比較 -Machine user accounts are OAuth-based user accounts that segregate automated systems using GitHub's user system. +マシンユーザアカウントは OAuth ベースのユーザアカウントで、GitHub のユーザシステムを使用して自動化されたシステムを分離します。 -Bot accounts are specific to GitHub Apps and are built into every GitHub App. +ボットアカウントは GitHub App 固有のもので、すべての GitHub App に組み込まれています。 -| GitHub Apps | OAuth App | -| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | -| 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. | +| GitHub Apps | OAuth App | +| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------ | +| GitHub App ボットは {% data variables.product.prodname_enterprise %} シートを消費しません。 | マシンユーザアカウントは {% data variables.product.prodname_enterprise %} シートを消費します。 | +| GitHub App ボットにはパスワードが付与されないため、顧客は GitHub App に直接サインインできません。 | マシンユーザアカウントには、ユーザ名およびパスワードが付与されます。顧客はそれらを管理および保護します。 | 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 f2d30396e315..3cbf4ce3b3bc 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 @@ -1,5 +1,5 @@ --- -title: Editing a GitHub App's permissions +title: GitHub App の権限を編集する intro: '{% data reusables.shortdesc.editing_permissions_for_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/editing-a-github-app-s-permissions/ @@ -12,16 +12,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. +**注釈:** アカウントまたは Organization のオーナーが変更を承認するまで、更新した権限はインストールしたアプリケーションに反映されません。 [InstallationEvent webhook](/webhooks/event-payloads/#installation) を使用すると、ユーザがアプリケーションの新しい権限を受け入れた時に確認できます。 ただし[ユーザレベルの権限](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions)は例外で、アカウントの所有者が変更を承認する必要はありません。 {% 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. ![アプリケーションの選択](/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) +4. 権限を変更する GitHub App を選択します。 ![アプリケーションの選択](/assets/images/github-apps/github_apps_select-app.png) +5. 左サイドバーで、[**Permissions & webhooks**] をクリックします。 ![権限と webhook](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. 変更したい権限を修正します。 権限の各タイプで、ドロップダウンメニューから [Read-only]、[Read & write]、[No access] のいずれかを選択します。 ![GitHub App に対する権限の選択](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. [Subscribe to events] で、アプリケーションがサブスクライブするイベントを選択します。 ![GitHub App がイベントにサブスクライブするための権限の選択](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. O必要に応じて、[Add a note to users] で注釈を追加し、GitHub App がリクエストする権限を変更する理由をユーザに伝えます。 ![GitHub App の権限を変更した理由をユーザに説明する注釈を追加するための入力ボックス](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. [**Save 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 12d946734b9c..fb4727f2afb3 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 @@ -1,5 +1,5 @@ --- -title: Identifying and authorizing users for GitHub Apps +title: GitHub App のユーザの特定と認可 intro: '{% data reusables.shortdesc.identifying_and_authorizing_github_apps %}' redirect_from: - /early-access/integrations/user-identification-authorization/ @@ -14,27 +14,27 @@ versions: {% data reusables.pre-release-program.expiring-user-access-tokens-beta %} -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. +GitHub App がユーザの代わりに動作すると、ユーザからサーバーに対するリクエストを実行します。 こうしたリクエストは、ユーザのアクセストークンで承認される必要があります。 ユーザからサーバーに対するリクエストには、特定のユーザに対してどのリポジトリを表示するか決定するなど、ユーザに対するデータのリクエストが含まれます。 これらのリクエストには、ビルドの実行など、ユーザがトリガーしたアクションも含まれます。 {% data reusables.apps.expiring_user_authorization_tokens %} -### Identifying users on your site +### サイト上のユーザを特定する -To authorize users for standard apps that run in the browser, use the [web application flow](#web-application-flow). +ブラウザで動作する標準的なアプリケーションでユーザを認可するには、[Web アプリケーションフロー](#web-application-flow)を利用してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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). +CLI ツールや Git 認証情報マネージャーなどの、ブラウザに直接アクセスしないヘッドレスアプリケーションでユーザを認可するには、[デバイスフロー](#device-flow)を利用します。 デバイスフローは、OAuth 2.0 [Device Authorization Grant](https://tools.ietf.org/html/rfc8628) を利用します。 {% endif %} ### Web アプリケーションフロー -Using the web application flow, the process to identify users on your site is: +Web アプリケーションフローを利用して、サイト上のユーザを特定するプロセスは以下の通りです。 1. ユーザはGitHubのアイデンティティをリクエストするためにリダイレクトされます 2. ユーザはGitHubによってサイトにリダイレクトして戻されます -3. Your GitHub App accesses the API with the user's access token +3. GitHub Appはユーザのアクセストークンで API にアクセスします -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)." +アプリケーションを作成または変更する際に [**Request user authorization (OAuth) during installation**] を選択した場合、アプリケーションのインストール中にステップ 1 が完了します。 詳しい情報については、「[インストール中のユーザの認可](/apps/installing-github-apps/#authorizing-users-during-installation)」を参照してください。 #### 1. ユーザのGitHubアイデンティティのリクエスト @@ -44,50 +44,50 @@ GitHub Appが`login`パラメータを指定すると、ユーザに対して利 ##### パラメータ -| 名前 | 種類 | 説明 | -| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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` | 認可の後にユーザが送られるアプリケーション中のURL。 This must be an exact match to {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} one of the URLs you provided as a **Callback URL** {% else %} the URL you provided in the **User authorization callback URL** field{% endif %} 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` | サインインとアプリケーションの認可に使われるアカウントを指示します。 | +| 名前 | 種類 | 説明 | +| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `client_id` | `string` | **必須。**GitHub App のクライアント IDです。 アプリケーションを選択したときに、[GitHub App 設定](https://github.com/settings/apps)に表示されます。 | +| `redirect_uri` | `string` | 認可の後にユーザが送られるアプリケーション中のURL。 これは、GitHub App をセットアップする際に{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}**コールバック URL** として指定された URL の １つ{% else %}[**User authorization callback URL**] フィールドで指定された URL {% endif %}と一致させる必要があり、他の追加パラメータを含めることはできません。 | +| `state` | `string` | これはフォージェリアタックを防ぐためにランダムな文字列を含める必要があり、あらゆる任意のデータを含めることができます。 | +| `login` | `string` | サインインとアプリケーションの認可に使われるアカウントを指示します。 | {% note %} -**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. +**注釈:** 認可リクエストにスコープを指定する必要はありません。 従来の OAuth とは異なり、認証トークンはGitHub App に紐付けられた権限およびユーザの権限に限定されます。 {% endnote %} #### 2. ユーザは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. +ユーザがリクエストを受け付けると、GitHub は一時的なコードを `code` パラメータに、そして前のステップで渡された状態を `state` パラメータに入れてリダイレクトさせ、サイトに戻します。 状態が一致しない場合、そのリクエストは第三者が作成したものであり、プロセスを中止する必要があります。 {% note %} -**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. +**注釈:** アプリケーションを作成または変更する際に [**Request user authorization (OAuth) during installation**] を選択した場合、GitHub はアクセストークンと交換する必要がある一時的な `code` を返します。 アプリケーションのインストール中に GitHub が OAuth フローを開始した場合、`state` パラメータは返されません。 {% endnote %} -Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." +この `code` をアクセストークンと交換します。 {% if currentVersion == "free-pro-team@latest" %}トークンの期限設定が有効になっている場合、アクセストークンは 8 時間で期限切れとなり、リフレッシュトークンは 6 か月で期限切れとなります。 トークンを更新するたびに、新しいリフレッシュトークンを取得します。 詳しい情報については、「[ユーザからサーバーに対するアクセストークンをリフレッシュする](/developers/apps/refreshing-user-to-server-access-tokens)」を参照してください。 -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 %} +ユーザトークンの期限設定は、ユーザからサーバーに対するトークンのベータ版機能の一部であり、変更される可能性があります。 ベータ版の機能である、ユーザからサーバーに対するトークンの期限設定にオプトインするには、「[アプリケーションのベータ版機能を有効化する](/developers/apps/activating-beta-features-for-apps)」を参照してください。{% endif %} POST {% data variables.product.oauth_host_code %}/login/oauth/access_token ##### パラメータ -| 名前 | 種類 | 説明 | -| --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `client_id` | `string` | **Required.** The client ID for your GitHub App. | -| `client_secret` | `string` | **Required.** The client secret for your GitHub App. | -| `コード` | `string` | **必須。** ステップ1でレスポンスとして受け取ったコード。 | -| `redirect_uri` | `string` | 認可の後にユーザが送られるアプリケーション中のURL。 This must be an exact match to {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} one of the URLs you provided as a **Callback URL** {% else %} the URL you provided in the **User authorization callback URL** field{% endif %} when setting up your GitHub App and can't contain any additional parameters. | -| `state` | `string` | ステップ1で提供した推測できないランダムな文字列。 | +| 名前 | 種類 | 説明 | +| --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `client_id` | `string` | **必須。**GitHub App のクライアント ID。 | +| `client_secret` | `string` | **必須。**GitHub App のクライアントシークレット。 | +| `コード` | `string` | **必須。** ステップ1でレスポンスとして受け取ったコード。 | +| `redirect_uri` | `string` | 認可の後にユーザが送られるアプリケーション中のURL。 これは、GitHub App をセットアップする際に{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}**コールバック URL** として指定された URL の １つ{% else %}[**User authorization callback URL**] フィールドで指定された URL {% endif %}と一致させる必要があり、他の追加パラメータを含めることはできません。 | +| `state` | `string` | ステップ1で提供した推測できないランダムな文字列。 | ##### レスポンス {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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. +デフォルトでは、レスポンスは以下の形式になります。 レスポンスパラメータの `expires_in`、`refresh_token`、`refresh_token_expires_in` は、ベータ版の機能である、ユーザからサーバに対するアクセストークンの期限設定を有効にしている場合にのみ返されます。 ``` { @@ -107,9 +107,9 @@ By default, the response takes the following form. The response parameters `expi {% endif %} -#### 3. Your GitHub App accesses the API with the user's access token +#### 3. GitHub Appはユーザのアクセストークンで API にアクセスします -The user's access token allows the GitHub App to make requests to the API on behalf of a user. +ユーザのアクセストークンを使用すると、GitHub App がユーザの代わりに API にリクエストを発行できます。 Authorization: token OAUTH-TOKEN GET {% data variables.product.api_url_code %}/user @@ -126,256 +126,256 @@ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre {% if currentVersion ver_lt "enterprise-server@3.1" %} {% note %} -**Note:** The device flow is in public beta and subject to change. +**注釈:** デバイスフローは現在パブリックベータであり、変更されることがあります。 {% endnote %} {% endif %} デバイスフローを使えば、CLIツールやGit認証情報マネージャーなどのヘッドレスアプリケーションのユーザを認可できます。 -For more information about authorizing users using the device flow, see "[Authorizing OAuth Apps](/developers/apps/authorizing-oauth-apps#device-flow)". +デバイスフローを使ったユーザの認可については、「[OAuth App の認可](/developers/apps/authorizing-oauth-apps#device-flow)」を参照してください。 {% endif %} -### Check which installation's resources a user can access +### ユーザがアクセスできるインストールされたリソースの確認 {% if enterpriseServerVersions contains currentVersion 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 %} -Once you have an OAuth token for a user, you can check which installations that user can access. +ユーザの OAuth トークンを取得したら、そのユーザがアクセスできるインストールされたアプリケーションを確認できます。 Authorization: token OAUTH-TOKEN GET /user/installations -You can also check which repositories are accessible to a user for an installation. +また、インストールされたアプリケーションでユーザがアクセスできるリポジトリも確認できます。 Authorization: token OAUTH-TOKEN GET /user/installations/:installation_id/repositories -More details can be found in: [List app installations accessible to the user access token](/rest/reference/apps#list-app-installations-accessible-to-the-user-access-token) and [List repositories accessible to the user access token](/rest/reference/apps#list-repositories-accessible-to-the-user-access-token). +詳細については、[ユーザアクセストークンがアクセスできるインストールされたアプリケーションの一覧表示](/rest/reference/apps#list-app-installations-accessible-to-the-user-access-token)および[ユーザアクセストークンがアクセスできるリポジトリの一覧表示](/rest/reference/apps#list-repositories-accessible-to-the-user-access-token)でご確認ください。 -### Handling a revoked GitHub App authorization +### GitHub App の認可の取り消し処理 -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 %} +ユーザが GitHub App の認可を取り消した場合、アプリケーションはデフォルトで [`github_app_authorization`](/webhooks/event-payloads/#github_app_authorization) webhook を受信します。 GitHub App は、このイベントをサブスクライブ解除できません。 {% data reusables.webhooks.authorization_event %} -### User-level permissions +### ユーザレベルの権限 -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](/rest/reference/permissions-required-for-github-apps), which are granted at the time of installation on an organization or user account. +[ユーザ認可フロー](#identifying-users-on-your-site)の一環として、個々のユーザに付与されたユーザのメールなどのユーザが所有するリソースにアクセスできる、ユーザレベルの権限を GitHub App に付与できます。 ユーザレベルの権限は、Organization またはユーザアカウントにインストールされる際に付与される、[リポジトリおよび Organization レベルの権限](/rest/reference/permissions-required-for-github-apps)とは異なります。 -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/)." +ユーザレベルの権限は、[**Permissions & webhooks**] ページの [**User permissions**] セクションにある GitHub App の設定で選択できます。 権限の選択に関する詳しい情報については、「[GitHub Appの権限の編集](/apps/managing-github-apps/editing-a-github-app-s-permissions/)」を参照してください。 -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. +ユーザが自分のアカウントにアプリケーションをインストールする時、インストールプロンプトは、アプリケーションがリクエストするユーザレベルの権限を一覧表示し、アプリケーションがこれらの権限を個々のユーザに求めることができるということを説明します。 -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. +ユーザレベルの権限は個々のユーザに付与されるため、ユーザにアップグレードを促すことなく、既存のアプリケーションに権限を追加できます。 ただし、新しい権限を認可し、ユーザからサーバーに対するトークンを取得するため、ユーザ認可フローを通じて既存のユーザを送信する必要があります。 -### User-to-server requests +### ユーザからサーバーへのリクエスト -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](/graphql) or [REST v3](/rest) endpoints. +While most of your API インタラクションのほとんどは、サーバーからサーバーへのインストールアクセストークンを用いて行われますが、一部のエンドポイントでは、ユーザアクセストークンを使用し、API 経由でアクションを実行できます。 [GraphQL v4](/graphql) または [REST v3](/rest) エンドポイントを使用して、アプリケーションは次のリクエストを行うことができます。 -#### Supported endpoints +#### 対応しているエンドポイント {% if currentVersion == "free-pro-team@latest" %} -##### Actions Runners - -* [List runner applications for a repository](/rest/reference/actions#list-runner-applications-for-a-repository) -* [List self-hosted runners for a repository](/rest/reference/actions#list-self-hosted-runners-for-a-repository) -* [Get a self-hosted runner for a repository](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) -* [Delete a self-hosted runner from a repository](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) -* [Create a registration token for a repository](/rest/reference/actions#create-a-registration-token-for-a-repository) -* [Create a remove token for a repository](/rest/reference/actions#create-a-remove-token-for-a-repository) -* [List runner applications for an organization](/rest/reference/actions#list-runner-applications-for-an-organization) -* [List self-hosted runners for an organization](/rest/reference/actions#list-self-hosted-runners-for-an-organization) -* [Get a self-hosted runner for an organization](/rest/reference/actions#get-a-self-hosted-runner-for-an-organization) -* [Delete a self-hosted runner from an organization](/rest/reference/actions#delete-a-self-hosted-runner-from-an-organization) -* [Create a registration token for an organization](/rest/reference/actions#create-a-registration-token-for-an-organization) -* [Create a remove token for an organization](/rest/reference/actions#create-a-remove-token-for-an-organization) - -##### Actions Secrets - -* [Get a repository public key](/rest/reference/actions#get-a-repository-public-key) -* [List repository secrets](/rest/reference/actions#list-repository-secrets) -* [Get a repository secret](/rest/reference/actions#get-a-repository-secret) -* [Create or update a repository secret](/rest/reference/actions#create-or-update-a-repository-secret) -* [Delete a repository secret](/rest/reference/actions#delete-a-repository-secret) -* [Get an organization public key](/rest/reference/actions#get-an-organization-public-key) -* [List organization secrets](/rest/reference/actions#list-organization-secrets) -* [Get an organization secret](/rest/reference/actions#get-an-organization-secret) -* [Create or update an organization secret](/rest/reference/actions#create-or-update-an-organization-secret) -* [List selected repositories for an organization secret](/rest/reference/actions#list-selected-repositories-for-an-organization-secret) -* [Set selected repositories for an organization secret](/rest/reference/actions#set-selected-repositories-for-an-organization-secret) -* [Add selected repository to an organization secret](/rest/reference/actions#add-selected-repository-to-an-organization-secret) -* [Remove selected repository from an organization secret](/rest/reference/actions#remove-selected-repository-from-an-organization-secret) -* [Delete an organization secret](/rest/reference/actions#delete-an-organization-secret) +##### Actions ランナー + +* [リポジトリのランナーアプリケーションの一覧表示](/rest/reference/actions#list-runner-applications-for-a-repository) +* [リポジトリのセルフホストランナーの一覧表示](/rest/reference/actions#list-self-hosted-runners-for-a-repository) +* [リポジトリのセルフホストランナーの取得](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) +* [リポジトリからのセルフホストランナーの削除](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) +* [リポジトリに対する登録トークンの作成](/rest/reference/actions#create-a-registration-token-for-a-repository) +* [リポジトリに対する削除トークンの作成](/rest/reference/actions#create-a-remove-token-for-a-repository) +* [Organization のランナーアプリケーションの一覧表示](/rest/reference/actions#list-runner-applications-for-an-organization) +* [Organizationのセルフホストランナーの一覧表示](/rest/reference/actions#list-self-hosted-runners-for-an-organization) +* [Organizationのセルフホストランナーの取得](/rest/reference/actions#get-a-self-hosted-runner-for-an-organization) +* [Organizationのセルフホストランナーの削除](/rest/reference/actions#delete-a-self-hosted-runner-from-an-organization) +* [Organizationの登録トークンの作成](/rest/reference/actions#create-a-registration-token-for-an-organization) +* [Organizationの削除トークンの作成](/rest/reference/actions#create-a-remove-token-for-an-organization) + +##### Actionsのシークレット + +* [リポジトリ公開鍵の取得](/rest/reference/actions#get-a-repository-public-key) +* [リポジトリのシークレットの一覧表示](/rest/reference/actions#list-repository-secrets) +* [リポジトリのシークレットの取得](/rest/reference/actions#get-a-repository-secret) +* [リポジトリのシークレットの作成もしくは更新](/rest/reference/actions#create-or-update-a-repository-secret) +* [リポジトリシークレットの削除](/rest/reference/actions#delete-a-repository-secret) +* [Organizationの公開鍵の取得](/rest/reference/actions#get-an-organization-public-key) +* [Organizationのシークレットの一覧表示](/rest/reference/actions#list-organization-secrets) +* [Organizationのシークレットの取得](/rest/reference/actions#get-an-organization-secret) +* [Organizationのシークレットの作成もしくは更新](/rest/reference/actions#create-or-update-an-organization-secret) +* [Organizatinoの選択されたリポジトリのシークレットの一覧表示](/rest/reference/actions#list-selected-repositories-for-an-organization-secret) +* [Organizationの選択されたリポジトリのシークレットの設定](/rest/reference/actions#set-selected-repositories-for-an-organization-secret) +* [Organizationの選択されたリポジトリのシークレットの追加](/rest/reference/actions#add-selected-repository-to-an-organization-secret) +* [Organizationの選択されたリポジトリからのシークレットの削除](/rest/reference/actions#remove-selected-repository-from-an-organization-secret) +* [Organizationのシークレットの削除](/rest/reference/actions#delete-an-organization-secret) {% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### 成果物 -* [List artifacts for a repository](/rest/reference/actions#list-artifacts-for-a-repository) -* [List workflow run artifacts](/rest/reference/actions#list-workflow-run-artifacts) -* [Get an artifact](/rest/reference/actions#get-an-artifact) -* [Delete an artifact](/rest/reference/actions#delete-an-artifact) -* [Download an artifact](/rest/reference/actions#download-an-artifact) +* [リポジトリの成果物の一覧表示](/rest/reference/actions#list-artifacts-for-a-repository) +* [ワークフローの実行の成果物の一覧表示](/rest/reference/actions#list-workflow-run-artifacts) +* [成果物の取得](/rest/reference/actions#get-an-artifact) +* [成果物の削除](/rest/reference/actions#delete-an-artifact) +* [成果物のダウンロード](/rest/reference/actions#download-an-artifact) {% endif %} ##### チェックラン -* [Create a check run](/rest/reference/checks#create-a-check-run) -* [Get a check run](/rest/reference/checks#get-a-check-run) -* [Update a check run](/rest/reference/checks#update-a-check-run) -* [List check run annotations](/rest/reference/checks#list-check-run-annotations) -* [List check runs in a check suite](/rest/reference/checks#list-check-runs-in-a-check-suite) -* [List check runs for a Git reference](/rest/reference/checks#list-check-runs-for-a-git-reference) +* [チェックランの作成](/rest/reference/checks#create-a-check-run) +* [チェックランの取得](/rest/reference/checks#get-a-check-run) +* [チェックランの更新](/rest/reference/checks#update-a-check-run) +* [チェックランのアノテーションの一覧表示](/rest/reference/checks#list-check-run-annotations) +* [チェックスイート中のチェックランの一覧表示](/rest/reference/checks#list-check-runs-in-a-check-suite) +* [Git参照のチェックランの一覧表示](/rest/reference/checks#list-check-runs-for-a-git-reference) ##### チェックスイート -* [Create a check suite](/rest/reference/checks#create-a-check-suite) -* [Get a check suite](/rest/reference/checks#get-a-check-suite) -* [Rerequest a check suite](/rest/reference/checks#rerequest-a-check-suite) -* [Update repository preferences for check suites](/rest/reference/checks#update-repository-preferences-for-check-suites) -* [List check suites for a Git reference](/rest/reference/checks#list-check-suites-for-a-git-reference) +* [チェックスイートの作成](/rest/reference/checks#create-a-check-suite) +* [チェックスイートの取得](/rest/reference/checks#get-a-check-suite) +* [チェックスイートのリクエスト](/rest/reference/checks#rerequest-a-check-suite) +* [チェックスイートのリポジトリ環境設定の更新](/rest/reference/checks#update-repository-preferences-for-check-suites) +* [Git参照のチェックスイートの一覧表示](/rest/reference/checks#list-check-suites-for-a-git-reference) -##### Codes Of Conduct +##### 行動規範 -* [Get all codes of conduct](/rest/reference/codes-of-conduct#get-all-codes-of-conduct) -* [Get a code of conduct](/rest/reference/codes-of-conduct#get-a-code-of-conduct) +* [すべての行動規範の取得](/rest/reference/codes-of-conduct#get-all-codes-of-conduct) +* [行動規範の取得](/rest/reference/codes-of-conduct#get-a-code-of-conduct) -##### Deployment Statuses +##### デプロイメントステータス -* [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) +* [デプロイメントステータスの一覧表示](/rest/reference/repos#list-deployment-statuses) +* [デプロイメントステータスの作成](/rest/reference/repos#create-a-deployment-status) +* [デプロイメントステータスの取得](/rest/reference/repos#get-a-deployment-status) ##### デプロイメント -* [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" or currentVersion == "github-ae@latest" %} -* [Delete a deployment](/rest/reference/repos#delete-a-deployment){% endif %} +* [デプロイメントの一覧表示](/rest/reference/repos#list-deployments) +* [デプロイメントの作成](/rest/reference/repos#create-a-deployment) +* [デプロイメントの取得](/rest/reference/repos#get-a-deployment){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} +* [デプロイメントの削除](/rest/reference/repos#delete-a-deployment){% endif %} ##### イベント -* [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) +* [リポジトリのネットワークのパブリックなイベントの一覧表示](/rest/reference/activity#list-public-events-for-a-network-of-repositories) +* [パブリックなOrganizationのイベントの一覧表示](/rest/reference/activity#list-public-organization-events) ##### フィード -* [Get feeds](/rest/reference/activity#get-feeds) +* [フィードの取得](/rest/reference/activity#get-feeds) -##### Git Blobs +##### Git Blob -* [Create a blob](/rest/reference/git#create-a-blob) -* [Get a blob](/rest/reference/git#get-a-blob) +* [blobの作成](/rest/reference/git#create-a-blob) +* [blobの取得](/rest/reference/git#get-a-blob) -##### Git Commits +##### Gitのコミット -* [Create a commit](/rest/reference/git#create-a-commit) -* [Get a commit](/rest/reference/git#get-a-commit) +* [コミットの作成](/rest/reference/git#create-a-commit) +* [コミットの取得](/rest/reference/git#get-a-commit) -##### Git Refs +##### Git参照 -* [Create a reference](/rest/reference/git#create-a-reference)* [Get a reference](/rest/reference/git#get-a-reference) -* [List matching references](/rest/reference/git#list-matching-references) -* [Update a reference](/rest/reference/git#update-a-reference) -* [Delete a reference](/rest/reference/git#delete-a-reference) +* [参照の作成](/rest/reference/git#create-a-reference)*[参照の取得](/rest/reference/git#get-a-reference) +* [一致する参照の一覧表示](/rest/reference/git#list-matching-references) +* [参照の更新](/rest/reference/git#update-a-reference) +* [参照の削除](/rest/reference/git#delete-a-reference) -##### Git Tags +##### Gitタグ -* [Create a tag object](/rest/reference/git#create-a-tag-object) -* [Get a tag](/rest/reference/git#get-a-tag) +* [タグオブジェクトの作成](/rest/reference/git#create-a-tag-object) +* [タグの取得](/rest/reference/git#get-a-tag) -##### Git Trees +##### Gitツリー -* [Create a tree](/rest/reference/git#create-a-tree) -* [Get a tree](/rest/reference/git#get-a-tree) +* [ツリーの作成](/rest/reference/git#create-a-tree) +* [ツリーの取得](/rest/reference/git#get-a-tree) -##### Gitignore Templates +##### gitignoreテンプレート -* [Get all gitignore templates](/rest/reference/gitignore#get-all-gitignore-templates) -* [Get a gitignore template](/rest/reference/gitignore#get-a-gitignore-template) +* [すべてのgitignoreテンプレートの取得](/rest/reference/gitignore#get-all-gitignore-templates) +* [gitignoreテンプレートの取得](/rest/reference/gitignore#get-a-gitignore-template) -##### Installations +##### インストール -* [List repositories accessible to the user access token](/rest/reference/apps#list-repositories-accessible-to-the-user-access-token) +* [ユーザアクセストークンでアクセスできるリポジトリの一覧表示](/rest/reference/apps#list-repositories-accessible-to-the-user-access-token) {% if currentVersion == "free-pro-team@latest" %} -##### Interaction Limits - -* [Get interaction restrictions for an organization](/rest/reference/interactions#get-interaction-restrictions-for-an-organization) -* [Set interaction restrictions for an organization](/rest/reference/interactions#set-interaction-restrictions-for-an-organization) -* [Remove interaction restrictions for an organization](/rest/reference/interactions#remove-interaction-restrictions-for-an-organization) -* [Get interaction restrictions for a repository](/rest/reference/interactions#get-interaction-restrictions-for-a-repository) -* [Set interaction restrictions for a repository](/rest/reference/interactions#set-interaction-restrictions-for-a-repository) -* [Remove interaction restrictions for a repository](/rest/reference/interactions#remove-interaction-restrictions-for-a-repository) +##### インタラクションの制限 + +* [Organizationのインタラクション制限の取得](/rest/reference/interactions#get-interaction-restrictions-for-an-organization) +* [Organizationのインタラクション制限の設定](/rest/reference/interactions#set-interaction-restrictions-for-an-organization) +* [Organizationのインタラクション制限の削除](/rest/reference/interactions#remove-interaction-restrictions-for-an-organization) +* [リポジトリのインタラクション制限の取得](/rest/reference/interactions#get-interaction-restrictions-for-a-repository) +* [リポジトリのインタラクション制限の設定](/rest/reference/interactions#set-interaction-restrictions-for-a-repository) +* [リポジトリのインタラクション制限の削除](/rest/reference/interactions#remove-interaction-restrictions-for-a-repository) {% endif %} -##### Issue Assignees +##### Issueにアサインされた人 -* [Add assignees to an issue](/rest/reference/issues#add-assignees-to-an-issue) -* [Remove assignees from an issue](/rest/reference/issues#remove-assignees-from-an-issue) +* [Issueへのアサインされる人の追加](/rest/reference/issues#add-assignees-to-an-issue) +* [Issueからアサインされた人を削除](/rest/reference/issues#remove-assignees-from-an-issue) -##### Issue Comments +##### Issueコメント -* [List issue comments](/rest/reference/issues#list-issue-comments) -* [Create an issue comment](/rest/reference/issues#create-an-issue-comment) -* [List issue comments for a repository](/rest/reference/issues#list-issue-comments-for-a-repository) -* [Get an issue comment](/rest/reference/issues#get-an-issue-comment) -* [Update an issue comment](/rest/reference/issues#update-an-issue-comment) -* [Delete an issue comment](/rest/reference/issues#delete-an-issue-comment) +* [Issueコメントの一覧表示](/rest/reference/issues#list-issue-comments) +* [Issueコメントの作成](/rest/reference/issues#create-an-issue-comment) +* [リポジトリのIssueコメントの一覧表示](/rest/reference/issues#list-issue-comments-for-a-repository) +* [Issueコメントの取得](/rest/reference/issues#get-an-issue-comment) +* [Issueコメントの更新](/rest/reference/issues#update-an-issue-comment) +* [Issueコメントの削除](/rest/reference/issues#delete-an-issue-comment) -##### Issue Events +##### Issueイベント -* [List issue events](/rest/reference/issues#list-issue-events) +* [Issueイベントの一覧表示](/rest/reference/issues#list-issue-events) -##### Issue Timeline +##### Issueのタイムライン -* [List timeline events for an issue](/rest/reference/issues#list-timeline-events-for-an-issue) +* [Issueのタイムラインイベントの一覧表示](/rest/reference/issues#list-timeline-events-for-an-issue) -##### 問題 +##### Issue -* [List issues assigned to the authenticated user](/rest/reference/issues#list-issues-assigned-to-the-authenticated-user) -* [List assignees](/rest/reference/issues#list-assignees) -* [Check if a user can be assigned](/rest/reference/issues#check-if-a-user-can-be-assigned) -* [List repository issues](/rest/reference/issues#list-repository-issues) -* [Issue を作成します](/rest/reference/issues#create-an-issue) -* [Get an issue](/rest/reference/issues#get-an-issue) -* [Update an issue](/rest/reference/issues#update-an-issue) -* [Lock an issue](/rest/reference/issues#lock-an-issue) -* [Unlock an issue](/rest/reference/issues#unlock-an-issue) +* [認証されたユーザにアサインされたIssueの一覧表示](/rest/reference/issues#list-issues-assigned-to-the-authenticated-user) +* [アサインされた人の一覧表示](/rest/reference/issues#list-assignees) +* [ユーザにアサインできるかを確認](/rest/reference/issues#check-if-a-user-can-be-assigned) +* [リポジトリのIssueの一覧表示](/rest/reference/issues#list-repository-issues) +* [Issueの作成](/rest/reference/issues#create-an-issue) +* [Issueの取得](/rest/reference/issues#get-an-issue) +* [Issueの更新](/rest/reference/issues#update-an-issue) +* [Issueのロック](/rest/reference/issues#lock-an-issue) +* [Issueのロック解除](/rest/reference/issues#unlock-an-issue) {% if currentVersion == "free-pro-team@latest" %} -##### Jobs +##### ジョブ -* [Get a job for a workflow run](/rest/reference/actions#get-a-job-for-a-workflow-run) -* [Download job logs for a workflow run](/rest/reference/actions#download-job-logs-for-a-workflow-run) -* [List jobs for a workflow run](/rest/reference/actions#list-jobs-for-a-workflow-run) +* [ワークフローランのジョブを取得](/rest/reference/actions#get-a-job-for-a-workflow-run) +* [ワークフローランのジョブのログをダウンロード](/rest/reference/actions#download-job-logs-for-a-workflow-run) +* [ワークフローランのジョブを一覧表示](/rest/reference/actions#list-jobs-for-a-workflow-run) {% endif %} ##### ラベル -* [List labels for an issue](/rest/reference/issues#list-labels-for-an-issue) -* [Add labels to an issue](/rest/reference/issues#add-labels-to-an-issue) -* [Set labels for an issue](/rest/reference/issues#set-labels-for-an-issue) -* [Remove all labels from an issue](/rest/reference/issues#remove-all-labels-from-an-issue) -* [Remove a label from an issue](/rest/reference/issues#remove-a-label-from-an-issue) -* [List labels for a repository](/rest/reference/issues#list-labels-for-a-repository) -* [Create a label](/rest/reference/issues#create-a-label) -* [Get a label](/rest/reference/issues#get-a-label) -* [Update a label](/rest/reference/issues#update-a-label) -* [Delete a label](/rest/reference/issues#delete-a-label) -* [Get labels for every issue in a milestone](/rest/reference/issues#list-labels-for-issues-in-a-milestone) +* [Issueのラベルを一覧表示](/rest/reference/issues#list-labels-for-an-issue) +* [Issueにラベルを追加](/rest/reference/issues#add-labels-to-an-issue) +* [Issueにラベルを設定](/rest/reference/issues#set-labels-for-an-issue) +* [Issueからすべてのラベルを削除](/rest/reference/issues#remove-all-labels-from-an-issue) +* [Issueからラベルを削除](/rest/reference/issues#remove-a-label-from-an-issue) +* [リポジトリのラベルを一覧表示](/rest/reference/issues#list-labels-for-a-repository) +* [ラベルを作成](/rest/reference/issues#create-a-label) +* [ラベルの取得](/rest/reference/issues#get-a-label) +* [ラベルの更新](/rest/reference/issues#update-a-label) +* [ラベルの削除](/rest/reference/issues#delete-a-label) +* [マイルストーン中のすべてのIssueのラベルを取得](/rest/reference/issues#list-labels-for-issues-in-a-milestone) ##### ライセンス -* [Get all commonly used licenses](/rest/reference/licenses#get-all-commonly-used-licenses) -* [Get a license](/rest/reference/licenses#get-a-license) +* [一般的に使用されるすべてのライセンスを取得](/rest/reference/licenses#get-all-commonly-used-licenses) +* [ライセンスを取得](/rest/reference/licenses#get-a-license) ##### Markdown -* [Render a Markdown document](/rest/reference/markdown#render-a-markdown-document) -* [Render a markdown document in raw mode](/rest/reference/markdown#render-a-markdown-document-in-raw-mode) +* [Markdownドキュメントをレンダリング](/rest/reference/markdown#render-a-markdown-document) +* [Markdownドキュメントをrawモードでレンダリング](/rest/reference/markdown#render-a-markdown-document-in-raw-mode) ##### メタ情報 @@ -383,551 +383,551 @@ While most of your API interaction should occur using your server-to-server inst ##### マイルストーン -* [List milestones](/rest/reference/issues#list-milestones) -* [Create a milestone](/rest/reference/issues#create-a-milestone) -* [Get a milestone](/rest/reference/issues#get-a-milestone) -* [Update a milestone](/rest/reference/issues#update-a-milestone) -* [Delete a milestone](/rest/reference/issues#delete-a-milestone) +* [マイルストーンの一覧表示](/rest/reference/issues#list-milestones) +* [マイルストーンの作成](/rest/reference/issues#create-a-milestone) +* [マイルストーンの取得](/rest/reference/issues#create-a-milestone) +* [マイルストーンの更新](/rest/reference/issues#update-a-milestone) +* [マイルストーンの削除](/rest/reference/issues#delete-a-milestone) -##### Organization Hooks +##### Organizationのフック -* [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) +* [Organizationのwebhookの一覧表示](/rest/reference/orgs#webhooks/#list-organization-webhooks) +* [Organizationのwebhookの作成](/rest/reference/orgs#webhooks/#create-an-organization-webhook) +* [Organizationのwebhookの取得](/rest/reference/orgs#webhooks/#get-an-organization-webhook) +* [Organizationのwebhookの更新](/rest/reference/orgs#webhooks/#update-an-organization-webhook) +* [Organizationのwebhookの削除](/rest/reference/orgs#webhooks/#delete-an-organization-webhook) +* [Organizationのwebhookのping](/rest/reference/orgs#webhooks/#ping-an-organization-webhook) {% if currentVersion == "free-pro-team@latest" %} -##### Organization Invitations +##### Organizationの招待 -* [List pending organization invitations](/rest/reference/orgs#list-pending-organization-invitations) -* [Create an organization invitation](/rest/reference/orgs#create-an-organization-invitation) -* [List organization invitation teams](/rest/reference/orgs#list-organization-invitation-teams) +* [保留中のOrganizationの招待の一覧表示](/rest/reference/orgs#list-pending-organization-invitations) +* [Organizationの招待の作成](/rest/reference/orgs#create-an-organization-invitation) +* [Organizationの招待Teamの一覧表示](/rest/reference/orgs#list-organization-invitation-teams) {% endif %} -##### Organization Members +##### Organizationのメンバー -* [List organization members](/rest/reference/orgs#list-organization-members) -* [Check organization membership for a user](/rest/reference/orgs#check-organization-membership-for-a-user) -* [Remove an organization member](/rest/reference/orgs#remove-an-organization-member) -* [Get organization membership for a user](/rest/reference/orgs#get-organization-membership-for-a-user) -* [Set organization membership for a user](/rest/reference/orgs#set-organization-membership-for-a-user) -* [Remove organization membership for a user](/rest/reference/orgs#remove-organization-membership-for-a-user) -* [List public organization members](/rest/reference/orgs#list-public-organization-members) -* [Check public organization membership for a user](/rest/reference/orgs#check-public-organization-membership-for-a-user) -* [Set public organization membership for the authenticated user](/rest/reference/orgs#set-public-organization-membership-for-the-authenticated-user) -* [Remove public organization membership for the authenticated user](/rest/reference/orgs#remove-public-organization-membership-for-the-authenticated-user) +* [Organizationのメンバーの一覧表示](/rest/reference/orgs#list-organization-members) +* [ユーザのOrganizationのメンバーシップのチェック](/rest/reference/orgs#check-organization-membership-for-a-user) +* [Organizationのメンバーの削除](/rest/reference/orgs#remove-an-organization-member) +* [ユーザのOrganizationのメンバーシップの取得](/rest/reference/orgs#get-organization-membership-for-a-user) +* [ユーザのOrganizationのメンバーシップの設定](/rest/reference/orgs#set-organization-membership-for-a-user) +* [ユーザのOrganizationのメンバーシップの削除](/rest/reference/orgs#remove-organization-membership-for-a-user) +* [パブリックなOrganizationのメンバーの一覧表示](/rest/reference/orgs#list-public-organization-members) +* [ユーザのパブリックなOrganizationのメンバーシップのチェック](/rest/reference/orgs#check-public-organization-membership-for-a-user) +* [認証されたユーザのパブリックなOrganizationのメンバーシップの設定](/rest/reference/orgs#set-public-organization-membership-for-the-authenticated-user) +* [認証されたユーザのOrganizationのメンバーシップの削除](/rest/reference/orgs#remove-public-organization-membership-for-the-authenticated-user) -##### Organization Outside Collaborators +##### Organizationの外部コラボレータ -* [List outside collaborators for an organization](/rest/reference/orgs#list-outside-collaborators-for-an-organization) -* [Convert an organization member to outside collaborator](/rest/reference/orgs#convert-an-organization-member-to-outside-collaborator) -* [Remove outside collaborator from an organization](/rest/reference/orgs#remove-outside-collaborator-from-an-organization) +* [OrganizationのOrganizationの外部コラボレータの一覧表示](/rest/reference/orgs#list-outside-collaborators-for-an-organization) +* [OrganizationのメンバーからOrganizationの外部コラボレータへの変換](/rest/reference/orgs#convert-an-organization-member-to-outside-collaborator) +* [OrganizationからのOrganizationの外部コラボレータの削除](/rest/reference/orgs#remove-outside-collaborator-from-an-organization) {% if enterpriseServerVersions contains currentVersion %} -##### Organization Pre Receive Hooks +##### Organization pre-receive フック -* [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) +* [Organizationのためのpre-receiveフックの一覧表示](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-an-organization) +* [Organizationのためのpre-receiveフックの取得](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-an-organization) +* [Organizationのためのpre-receiveフックの強制の更新](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-an-organization) +* [Organizationのためのpre-receiveフックの強制の削除](/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" or currentVersion == "github-ae@latest" %} -##### Organization Team Projects +##### OrganizationのTeamのプロジェクト -* [List team projects](/rest/reference/teams#list-team-projects) -* [Check team permissions for a project](/rest/reference/teams#check-team-permissions-for-a-project) -* [Add or update team project permissions](/rest/reference/teams#add-or-update-team-project-permissions) -* [Remove a project from a team](/rest/reference/teams#remove-a-project-from-a-team) +* [Teamプロジェクトの一覧表示](/rest/reference/teams#list-team-projects) +* [プロジェクトのTeamの権限のチェック](/rest/reference/teams#check-team-permissions-for-a-project) +* [Teamのプロジェクト権限の追加あるいは更新](/rest/reference/teams#add-or-update-team-project-permissions) +* [Teamからのプロジェクトの削除](/rest/reference/teams#remove-a-project-from-a-team) {% endif %} -##### Organization Team Repositories +##### OrganizationのTeamリポジトリ * [Team リポジトリの一覧表示](/rest/reference/teams#list-team-repositories) -* [Check team permissions for a repository](/rest/reference/teams#check-team-permissions-for-a-repository) -* [Add or update team repository permissions](/rest/reference/teams#add-or-update-team-repository-permissions) -* [Remove a repository from a team](/rest/reference/teams#remove-a-repository-from-a-team) +* [リポジトリのTeamの権限のチェック](/rest/reference/teams#check-team-permissions-for-a-repository) +* [Teamリポジトリ権限の追加あるいは更新](/rest/reference/teams#add-or-update-team-repository-permissions) +* [Teamからのリポジトリの削除](/rest/reference/teams#remove-a-repository-from-a-team) {% if currentVersion == "free-pro-team@latest" %} ##### Organization Team Sync -* [List idp groups for a team](/rest/reference/teams#list-idp-groups-for-a-team) -* [Create or update idp group connections](/rest/reference/teams#create-or-update-idp-group-connections) -* [List IdP groups for an organization](/rest/reference/teams#list-idp-groups-for-an-organization) +* [Teamのidpグループの一覧表示](/rest/reference/teams#list-idp-groups-for-a-team) +* [idpグループの接続の作成あるいは更新](/rest/reference/teams#create-or-update-idp-group-connections) +* [OrganizationのIdpグループの一覧表示](/rest/reference/teams#list-idp-groups-for-an-organization) {% endif %} -##### Organization Teams +##### Organization Team -* [List teams](/rest/reference/teams#list-teams) -* [Create a team](/rest/reference/teams#create-a-team) -* [Get a team by name](/rest/reference/teams#get-a-team-by-name) +* [Teamの一覧表示](/rest/reference/teams#list-teams) +* [Teamの作成](/rest/reference/teams#create-a-team) +* [名前でのTeamの取得](/rest/reference/teams#get-a-team-by-name) {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.21" %} -* [Get a team](/rest/reference/teams#get-a-team) +* [Teamの取得](/rest/reference/teams#get-a-team) {% endif %} -* [Update a team](/rest/reference/teams#update-a-team) -* [Delete a team](/rest/reference/teams#delete-a-team) +* [Teamの更新](/rest/reference/teams#update-a-team) +* [Teamの削除](/rest/reference/teams#delete-a-team) {% if currentVersion == "free-pro-team@latest" %} -* [List pending team invitations](/rest/reference/teams#list-pending-team-invitations) +* [保留中のTeamの招待の一覧表示](/rest/reference/teams#list-pending-team-invitations) {% endif %} -* [List team members](/rest/reference/teams#list-team-members) -* [Get team membership for a user](/rest/reference/teams#get-team-membership-for-a-user) -* [Add or update team membership for a user](/rest/reference/teams#add-or-update-team-membership-for-a-user) -* [Remove team membership for a user](/rest/reference/teams#remove-team-membership-for-a-user) -* [List child teams](/rest/reference/teams#list-child-teams) -* [List teams for the authenticated user](/rest/reference/teams#list-teams-for-the-authenticated-user) +* [Teamメンバーの一覧表示](/rest/reference/teams#list-team-members) +* [ユーザのTeamメンバーシップの取得](/rest/reference/teams#get-team-membership-for-a-user) +* [ユーザのTeamメンバーシップの追加あるいは更新](/rest/reference/teams#add-or-update-team-membership-for-a-user) +* [ユーザのTeamメンバーシップの削除](/rest/reference/teams#remove-team-membership-for-a-user) +* [子チームの一覧表示](/rest/reference/teams#list-child-teams) +* [認証されたユーザのTeamの一覧表示](/rest/reference/teams#list-teams-for-the-authenticated-user) ##### Organization -* [List organizations](/rest/reference/orgs#list-organizations) -* [Get an organization](/rest/reference/orgs#get-an-organization) -* [Update an organization](/rest/reference/orgs#update-an-organization) -* [List organization memberships for the authenticated user](/rest/reference/orgs#list-organization-memberships-for-the-authenticated-user) -* [Get an organization membership for the authenticated user](/rest/reference/orgs#get-an-organization-membership-for-the-authenticated-user) -* [Update an organization membership for the authenticated user](/rest/reference/orgs#update-an-organization-membership-for-the-authenticated-user) -* [List organizations for the authenticated user](/rest/reference/orgs#list-organizations-for-the-authenticated-user) -* [List organizations for a user](/rest/reference/orgs#list-organizations-for-a-user) +* [Organizationの一覧表示](/rest/reference/orgs#list-organizations) +* [Organizationの取得](/rest/reference/orgs#get-an-organization) +* [Organizationの更新](/rest/reference/orgs#update-an-organization) +* [認証されたユーザのOrganizationメンバーシップの一覧表示](/rest/reference/orgs#list-organization-memberships-for-the-authenticated-user) +* [認証されたユーザのOrganizationメンバーシップの取得](/rest/reference/orgs#get-an-organization-membership-for-the-authenticated-user) +* [認証されたユーザのOrganizationメンバーシップの更新](/rest/reference/orgs#update-an-organization-membership-for-the-authenticated-user) +* [認証されたユーザのOrganizationの一覧表示](/rest/reference/orgs#list-organizations-for-the-authenticated-user) +* [ユーザのOrganizationの一覧表示](/rest/reference/orgs#list-organizations-for-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Organizations Credential Authorizations +##### Organizationのクレデンシャルの認証 -* [List SAML SSO authorizations for an organization](/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization) -* [Remove a SAML SSO authorization for an organization](/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization) +* [OrganizationのSAML SSO認証の一覧表示](/rest/reference/orgs#list-saml-sso-authorizations-for-an-organization) +* [OrganizationのSAML SSO認証の削除](/rest/reference/orgs#remove-a-saml-sso-authorization-for-an-organization) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Organizations Scim - -* [List SCIM provisioned identities](/rest/reference/scim#list-scim-provisioned-identities) -* [Provision and invite a SCIM user](/rest/reference/scim#provision-and-invite-a-scim-user) -* [Get SCIM provisioning information for a user](/rest/reference/scim#get-scim-provisioning-information-for-a-user) -* [Set SCIM information for a provisioned user](/rest/reference/scim#set-scim-information-for-a-provisioned-user) -* [Update an attribute for a SCIM user](/rest/reference/scim#update-an-attribute-for-a-scim-user) -* [Delete a SCIM user from an organization](/rest/reference/scim#delete-a-scim-user-from-an-organization) +##### OrganizationのSCIM + +* [SCIMでプロビジョニングされたアイデンティティの一覧表示](/rest/reference/scim#list-scim-provisioned-identities) +* [SCIMユーザのプロビジョニングと招待](/rest/reference/scim#provision-and-invite-a-scim-user) +* [ユーザのSCIMプロビジョニング情報の取得](/rest/reference/scim#get-scim-provisioning-information-for-a-user) +* [プロビジョニングされたユーザのSCIM情報の設定](/rest/reference/scim#set-scim-information-for-a-provisioned-user) +* [SCIMユーザの属性の更新](/rest/reference/scim#update-an-attribute-for-a-scim-user) +* [OrganizationからのSCIMユーザの削除](/rest/reference/scim#delete-a-scim-user-from-an-organization) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### Source Imports - -* [Get an import status](/rest/reference/migrations#get-an-import-status) -* [Start an import](/rest/reference/migrations#start-an-import) -* [Update an import](/rest/reference/migrations#update-an-import) -* [Cancel an import](/rest/reference/migrations#cancel-an-import) -* [Get commit authors](/rest/reference/migrations#get-commit-authors) -* [Map a commit author](/rest/reference/migrations#map-a-commit-author) -* [Get large files](/rest/reference/migrations#get-large-files) -* [Update Git LFS preference](/rest/reference/migrations#update-git-lfs-preference) +##### ソースのインポート + +* [インポートステータスの取得](/rest/reference/migrations#get-an-import-status) +* [インポートの開始](/rest/reference/migrations#start-an-import) +* [インポートの更新](/rest/reference/migrations#update-an-import) +* [インポートのキャンセル](/rest/reference/migrations#cancel-an-import) +* [コミット作者の取得](/rest/reference/migrations#get-commit-authors) +* [コミット作者のマップ](/rest/reference/migrations#map-a-commit-author) +* [大きなファイルの取得](/rest/reference/migrations#get-large-files) +* [Git LFS環境設定の更新](/rest/reference/migrations#update-git-lfs-preference) {% endif %} -##### Project Collaborators +##### プロジェクトのコラボレータ -* [List project collaborators](/rest/reference/projects#list-project-collaborators) -* [Add project collaborator](/rest/reference/projects#add-project-collaborator) -* [Remove project collaborator](/rest/reference/projects#remove-project-collaborator) -* [Get project permission for a user](/rest/reference/projects#get-project-permission-for-a-user) +* [プロジェクトのコラボレータの一覧表示](/rest/reference/projects#list-project-collaborators) +* [プロジェクトのコラボレータの追加](/rest/reference/projects#add-project-collaborator) +* [プロジェクトのコラボレータの削除](/rest/reference/projects#remove-project-collaborator) +* [ユーザのプロジェクト権限の取得](/rest/reference/projects#get-project-permission-for-a-user) ##### プロジェクト -* [List organization projects](/rest/reference/projects#list-organization-projects) -* [Create an organization project](/rest/reference/projects#create-an-organization-project) -* [Get a project](/rest/reference/projects#get-a-project) -* [Update a project](/rest/reference/projects#update-a-project) -* [Delete a project](/rest/reference/projects#delete-a-project) -* [List project columns](/rest/reference/projects#list-project-columns) -* [Create a project column](/rest/reference/projects#create-a-project-column) -* [Get a project column](/rest/reference/projects#get-a-project-column) -* [Update a project column](/rest/reference/projects#update-a-project-column) -* [Delete a project column](/rest/reference/projects#delete-a-project-column) -* [List project cards](/rest/reference/projects#list-project-cards) -* [Create a project card](/rest/reference/projects#create-a-project-card) -* [Move a project column](/rest/reference/projects#move-a-project-column) -* [Get a project card](/rest/reference/projects#get-a-project-card) -* [Update a project card](/rest/reference/projects#update-a-project-card) -* [Delete a project card](/rest/reference/projects#delete-a-project-card) -* [Move a project card](/rest/reference/projects#move-a-project-card) -* [List repository projects](/rest/reference/projects#list-repository-projects) -* [Create a repository project](/rest/reference/projects#create-a-repository-project) - -##### Pull Comments - -* [List review comments on a pull request](/rest/reference/pulls#list-review-comments-on-a-pull-request) -* [Create a review comment for a pull request](/rest/reference/pulls#create-a-review-comment-for-a-pull-request) -* [List review comments in a repository](/rest/reference/pulls#list-review-comments-in-a-repository) -* [Get a review comment for a pull request](/rest/reference/pulls#get-a-review-comment-for-a-pull-request) -* [Update a review comment for a pull request](/rest/reference/pulls#update-a-review-comment-for-a-pull-request) -* [Delete a review comment for a pull request](/rest/reference/pulls#delete-a-review-comment-for-a-pull-request) - -##### Pull Request Review Events - -* [Dismiss a review for a pull request](/rest/reference/pulls#dismiss-a-review-for-a-pull-request) -* [Submit a review for a pull request](/rest/reference/pulls#submit-a-review-for-a-pull-request) - -##### Pull Request Review Requests - -* [List requested reviewers for a pull request](/rest/reference/pulls#list-requested-reviewers-for-a-pull-request) -* [Request reviewers for a pull request](/rest/reference/pulls#request-reviewers-for-a-pull-request) -* [Remove requested reviewers from a pull request](/rest/reference/pulls#remove-requested-reviewers-from-a-pull-request) - -##### Pull Request Reviews - -* [List reviews for a pull request](/rest/reference/pulls#list-reviews-for-a-pull-request) -* [Create a review for a pull request](/rest/reference/pulls#create-a-review-for-a-pull-request) -* [Get a review for a pull request](/rest/reference/pulls#get-a-review-for-a-pull-request) -* [Update a review for a pull request](/rest/reference/pulls#update-a-review-for-a-pull-request) -* [List comments for a pull request review](/rest/reference/pulls#list-comments-for-a-pull-request-review) - -##### Pulls - -* [List pull requests](/rest/reference/pulls#list-pull-requests) -* [Create a pull request](/rest/reference/pulls#create-a-pull-request) -* [Get a pull request](/rest/reference/pulls#get-a-pull-request) -* [Update a pull request](/rest/reference/pulls#update-a-pull-request) -* [List commits on a pull request](/rest/reference/pulls#list-commits-on-a-pull-request) -* [List pull requests files](/rest/reference/pulls#list-pull-requests-files) -* [Check if a pull request has been merged](/rest/reference/pulls#check-if-a-pull-request-has-been-merged) -* [Merge a pull request (Merge Button)](/rest/reference/pulls#merge-a-pull-request) +* [Organizationのプロジェクトの一覧表示](/rest/reference/projects#list-organization-projects) +* [Organizationのプロジェクトの作成](/rest/reference/projects#create-an-organization-project) +* [プロジェクトの取得](/rest/reference/projects#get-a-project) +* [プロジェクトの更新](/rest/reference/projects#update-a-project) +* [プロジェクトの削除](/rest/reference/projects#delete-a-project) +* [プロジェクトの列の一覧表示](/rest/reference/projects#list-project-columns) +* [プロジェクトの列の作成](/rest/reference/projects#create-a-project-column) +* [プロジェクトの列の取得](/rest/reference/projects#get-a-project-column) +* [プロジェクトの列の更新](/rest/reference/projects#update-a-project-column) +* [プロジェクトの列の削除](/rest/reference/projects#delete-a-project-column) +* [プロジェクトカードの一覧表示](/rest/reference/projects#list-project-cards) +* [プロジェクトカードの作成](/rest/reference/projects#create-a-project-card) +* [プロジェクトの列の移動](/rest/reference/projects#move-a-project-column) +* [プロジェクトカードの取得](/rest/reference/projects#get-a-project-card) +* [プロジェクトカードの更新](/rest/reference/projects#update-a-project-card) +* [プロジェクトカードの削除](/rest/reference/projects#delete-a-project-card) +* [プロジェクトカードの移動](/rest/reference/projects#move-a-project-card) +* [リポジトリプロジェクトの一覧表示](/rest/reference/projects#list-repository-projects) +* [リポジトリプロジェクトの作成](/rest/reference/projects#create-a-repository-project) + +##### Pull Requestのコメント + +* [Pull Requestのレビューコメントの一覧表示](/rest/reference/pulls#list-review-comments-on-a-pull-request) +* [Pull Requestのレビューコメントの作成](/rest/reference/pulls#create-a-review-comment-for-a-pull-request) +* [リポジトリのレビューコメントの一覧表示](/rest/reference/pulls#list-review-comments-in-a-repository) +* [Pull Requestのレビューコメントの取得](/rest/reference/pulls#get-a-review-comment-for-a-pull-request) +* [Pull Requestのレビューコメントの更新](/rest/reference/pulls#update-a-review-comment-for-a-pull-request) +* [Pull Requestのレビューコメントの削除](/rest/reference/pulls#delete-a-review-comment-for-a-pull-request) + +##### Pull Requestのレビューイベント + +* [Pull Requestのレビューの却下](/rest/reference/pulls#dismiss-a-review-for-a-pull-request) +* [Pull Requestのレビューのサブミット](/rest/reference/pulls#submit-a-review-for-a-pull-request) + +##### Pull Requestのレビューのリクエスト + +* [Pull Requestのリクエストされたレビューの一覧表示](/rest/reference/pulls#list-requested-reviewers-for-a-pull-request) +* [Pull Requestのレビュー担当者のリクエスト](/rest/reference/pulls#request-reviewers-for-a-pull-request) +* [Pull Requestからリクエストされたレビュー担当者を削除](/rest/reference/pulls#remove-requested-reviewers-from-a-pull-request) + +##### Pull Requestのレビュー + +* [Pull Requestのレビューの一覧表示](/rest/reference/pulls#list-reviews-for-a-pull-request) +* [Pull Requestのレビューの作成](/rest/reference/pulls#create-a-review-for-a-pull-request) +* [Pull Requestのレビューの取得](/rest/reference/pulls#get-a-review-for-a-pull-request) +* [Pull Requestのレビューの更新](/rest/reference/pulls#update-a-review-for-a-pull-request) +* [Pull Requestレビューのコメントの一覧表示](/rest/reference/pulls#list-comments-for-a-pull-request-review) + +##### Pull Request + +* [Pull Requestの一覧表示](/rest/reference/pulls#list-pull-requests) +* [Pull Requestの作成](/rest/reference/pulls#create-a-pull-request) +* [Pull Requestの取得](/rest/reference/pulls#get-a-pull-request) +* [Pull Requestの更新](/rest/reference/pulls#update-a-pull-request) +* [Pull Requestのコミットの一覧表示](/rest/reference/pulls#list-commits-on-a-pull-request) +* [Pull Requestのファイルの一覧表示](/rest/reference/pulls#list-pull-requests-files) +* [Pull Requestがマージされたかをチェック](/rest/reference/pulls#check-if-a-pull-request-has-been-merged) +* [Pull Requestをマージ（マージボタン）](/rest/reference/pulls#merge-a-pull-request) ##### リアクション -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %}* [Delete a reaction](/rest/reference/reactions#delete-a-reaction-legacy){% else %}* [Delete a reaction](/rest/reference/reactions#delete-a-reaction){% endif %} -* [List reactions for a commit comment](/rest/reference/reactions#list-reactions-for-a-commit-comment) -* [Create reaction for a commit comment](/rest/reference/reactions#create-reaction-for-a-commit-comment) -* [List reactions for an issue](/rest/reference/reactions#list-reactions-for-an-issue) -* [Create reaction for an issue](/rest/reference/reactions#create-reaction-for-an-issue) -* [List reactions for an issue comment](/rest/reference/reactions#list-reactions-for-an-issue-comment) -* [Create reaction for an issue comment](/rest/reference/reactions#create-reaction-for-an-issue-comment) -* [List reactions for a pull request review comment](/rest/reference/reactions#list-reactions-for-a-pull-request-review-comment) -* [Create reaction for a pull request review comment](/rest/reference/reactions#create-reaction-for-a-pull-request-review-comment) -* [List reactions for a team discussion comment](/rest/reference/reactions#list-reactions-for-a-team-discussion-comment) -* [Create reaction for a team discussion comment](/rest/reference/reactions#create-reaction-for-a-team-discussion-comment) -* [List reactions for a team discussion](/rest/reference/reactions#list-reactions-for-a-team-discussion) -* [Create reaction for a team discussion](/rest/reference/reactions#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} -* [Delete a commit comment reaction](/rest/reference/reactions#delete-a-commit-comment-reaction) -* [Delete an issue reaction](/rest/reference/reactions#delete-an-issue-reaction) -* [Delete a reaction to a commit comment](/rest/reference/reactions#delete-an-issue-comment-reaction) -* [Delete a pull request comment reaction](/rest/reference/reactions#delete-a-pull-request-comment-reaction) -* [Delete team discussion reaction](/rest/reference/reactions#delete-team-discussion-reaction) -* [Delete team discussion comment reaction](/rest/reference/reactions#delete-team-discussion-comment-reaction){% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %}* [Delete a reaction](/rest/reference/reactions#delete-a-reaction-legacy){% else %}* [リアクションの削除](/rest/reference/reactions#delete-a-reaction){% endif %} +* [コミットコメントへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-a-commit-comment) +* [コミットコメントへのリアクションの作成](/rest/reference/reactions#create-reaction-for-a-commit-comment) +* [Issueへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-an-issue) +* [Issueへのリアクションの作成](/rest/reference/reactions#create-reaction-for-an-issue) +* [Issueコメントへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-an-issue-comment) +* [Issueコメントへのリアクションの作成](/rest/reference/reactions#create-reaction-for-an-issue-comment) +* [Pull Requestのレビューコメントへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-a-pull-request-review-comment) +* [Pull Requestのレビューコメントへのリアクションの作成](/rest/reference/reactions#create-reaction-for-a-pull-request-review-comment) +* [Teamディスカッションコメントへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-a-team-discussion-comment) +* [Teamディスカッションコメントへのリアクションの作成](/rest/reference/reactions#create-reaction-for-a-team-discussion-comment) +* [Teamディスカッションへのリアクションの一覧表示](/rest/reference/reactions#list-reactions-for-a-team-discussion) +* [Teamディスカッションへのリアクションの作成](/rest/reference/reactions#create-reaction-for-a-team-discussion){% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} +* [コミットコメントへのリアクションの削除](/rest/reference/reactions#delete-a-commit-comment-reaction) +* [Issueへのリアクションの削除](/rest/reference/reactions#delete-an-issue-reaction) +* [コミットコメントへのリアクションの削除](/rest/reference/reactions#delete-an-issue-comment-reaction) +* [Pull Requestのコメントへのリアクションの削除](/rest/reference/reactions#delete-a-pull-request-comment-reaction) +* [Teamディスカッションへのリアクションの削除](/rest/reference/reactions#delete-team-discussion-reaction) +* [Team ディスカッションのコメントへのリアクションの削除](/rest/reference/reactions#delete-team-discussion-comment-reaction){% endif %} ##### リポジトリ * [Organization リポジトリの一覧表示](/rest/reference/repos#list-organization-repositories) -* [Create a repository for the authenticated user](/rest/reference/repos#create-a-repository-for-the-authenticated-user) -* [リポジトリの Get](/rest/reference/repos#get-a-repository) -* [Update a repository](/rest/reference/repos#update-a-repository) -* [Delete a repository](/rest/reference/repos#delete-a-repository) -* [Compare two commits](/rest/reference/repos#compare-two-commits) -* [List repository contributors](/rest/reference/repos#list-repository-contributors) -* [一覧表示のフォーク](/rest/reference/repos#list-forks) -* [Create a fork](/rest/reference/repos#create-a-fork) -* [List repository languages](/rest/reference/repos#list-repository-languages) -* [List repository tags](/rest/reference/repos#list-repository-tags) -* [List repository teams](/rest/reference/repos#list-repository-teams) -* [Transfer a repository](/rest/reference/repos#transfer-a-repository) -* [List public repositories](/rest/reference/repos#list-public-repositories) -* [List repositories for the authenticated user](/rest/reference/repos#list-repositories-for-the-authenticated-user) +* [認証されたユーザにリポジトリを作成](/rest/reference/repos#create-a-repository-for-the-authenticated-user) +* [リポジトリの取得](/rest/reference/repos#get-a-repository) +* [リポジトリの更新](/rest/reference/repos#update-a-repository) +* [リポジトリの削除](/rest/reference/repos#delete-a-repository) +* [2つのコミットの比較](/rest/reference/repos#compare-two-commits) +* [リポジトリのコントリビューターの一覧表示](/rest/reference/repos#list-repository-contributors) +* [フォークの一覧表示](/rest/reference/repos#list-forks) +* [フォークの作成](/rest/reference/repos#create-a-fork) +* [リポジトリの言語の一覧表示](/rest/reference/repos#list-repository-languages) +* [リポジトリのタグの一覧表示](/rest/reference/repos#list-repository-tags) +* [リポジトリのTeamの一覧表示](/rest/reference/repos#list-repository-teams) +* [リポジトリの移譲](/rest/reference/repos#transfer-a-repository) +* [パブリックリポジトリの一覧表示](/rest/reference/repos#list-public-repositories) +* [認証されたユーザのリポジトリの一覧表示](/rest/reference/repos#list-repositories-for-the-authenticated-user) * [ユーザのリポジトリの一覧表示](/rest/reference/repos#list-repositories-for-a-user) -* [Create repository using a repository template](/rest/reference/repos#create-repository-using-a-repository-template) +* [リポジトリのテンプレートを使ったリポジトリの作成](/rest/reference/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) +* [Starを付けたユーザの一覧表示](/rest/reference/activity#list-stargazers) +* [Watchしているユーザの一覧表示](/rest/reference/activity#list-watchers) +* [ユーザがStarしたリポジトリの一覧表示](/rest/reference/activity#list-repositories-starred-by-a-user) +* [認証されたユーザによってリポジトリがStarされているかをチェック](/rest/reference/activity#check-if-a-repository-is-starred-by-the-authenticated-user) +* [認証されたユーザのためにリポジトリをStar](/rest/reference/activity#star-a-repository-for-the-authenticated-user) +* [認証されたユーザのためにリポジトリをStar解除](/rest/reference/activity#unstar-a-repository-for-the-authenticated-user) * [ユーザが Watch しているリポジトリの一覧表示](/rest/reference/activity#list-repositories-watched-by-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Repository Automated Security Fixes +##### リポジトリの自動化されたセキュリティ修正 -* [Enable automated security fixes](/rest/reference/repos#enable-automated-security-fixes) -* [Disable automated security fixes](/rest/reference/repos#disable-automated-security-fixes) +* [自動化されたセキュリティ修正の有効化](/rest/reference/repos#enable-automated-security-fixes) +* [自動化されたセキュリティ修正の無効化](/rest/reference/repos#disable-automated-security-fixes) {% endif %} -##### Repository Branches - -* [List branches](/rest/reference/repos#list-branches) -* [Get a branch](/rest/reference/repos#get-a-branch) -* [Get branch protection](/rest/reference/repos#get-branch-protection) -* [Update branch protection](/rest/reference/repos#update-branch-protection) -* [Delete branch protection](/rest/reference/repos#delete-branch-protection) -* [Get admin branch protection](/rest/reference/repos#get-admin-branch-protection) -* [Set admin branch protection](/rest/reference/repos#set-admin-branch-protection) -* [Delete admin branch protection](/rest/reference/repos#delete-admin-branch-protection) -* [Get pull request review protection](/rest/reference/repos#get-pull-request-review-protection) -* [Update pull request review protection](/rest/reference/repos#update-pull-request-review-protection) -* [Delete pull request review protection](/rest/reference/repos#delete-pull-request-review-protection) -* [Get commit signature protection](/rest/reference/repos#get-commit-signature-protection) -* [Create commit signature protection](/rest/reference/repos#create-commit-signature-protection) -* [Delete commit signature protection](/rest/reference/repos#delete-commit-signature-protection) -* [Get status checks protection](/rest/reference/repos#get-status-checks-protection) -* [Update status check protection](/rest/reference/repos#update-status-check-protection) -* [Remove status check protection](/rest/reference/repos#remove-status-check-protection) -* [Get all status check contexts](/rest/reference/repos#get-all-status-check-contexts) -* [Add status check contexts](/rest/reference/repos#add-status-check-contexts) -* [Set status check contexts](/rest/reference/repos#set-status-check-contexts) -* [Remove status check contexts](/rest/reference/repos#remove-status-check-contexts) -* [Get access restrictions](/rest/reference/repos#get-access-restrictions) -* [Delete access restrictions](/rest/reference/repos#delete-access-restrictions) -* [List teams with access to the protected branch](/rest/reference/repos#list-teams-with-access-to-the-protected-branch) -* [Add team access restrictions](/rest/reference/repos#add-team-access-restrictions) -* [Set team access restrictions](/rest/reference/repos#set-team-access-restrictions) -* [Remove team access restriction](/rest/reference/repos#remove-team-access-restrictions) -* [List user restrictions of protected branch](/rest/reference/repos#list-users-with-access-to-the-protected-branch) -* [Add user access restrictions](/rest/reference/repos#add-user-access-restrictions) -* [Set user access restrictions](/rest/reference/repos#set-user-access-restrictions) -* [Remove user access restrictions](/rest/reference/repos#remove-user-access-restrictions) -* [Merge a branch](/rest/reference/repos#merge-a-branch) - -##### Repository Collaborators - -* [List repository collaborators](/rest/reference/repos#list-repository-collaborators) -* [Check if a user is a repository collaborator](/rest/reference/repos#check-if-a-user-is-a-repository-collaborator) -* [Add a repository collaborator](/rest/reference/repos#add-a-repository-collaborator) -* [Remove a repository collaborator](/rest/reference/repos#remove-a-repository-collaborator) -* [Get repository permissions for a user](/rest/reference/repos#get-repository-permissions-for-a-user) - -##### Repository Commit Comments - -* [List commit comments for a repository](/rest/reference/repos#list-commit-comments-for-a-repository) -* [Get a commit comment](/rest/reference/repos#get-a-commit-comment) -* [Update a commit comment](/rest/reference/repos#update-a-commit-comment) -* [Delete a commit comment](/rest/reference/repos#delete-a-commit-comment) -* [List commit comments](/rest/reference/repos#list-commit-comments) -* [Create a commit comment](/rest/reference/repos#create-a-commit-comment) - -##### Repository Commits - -* [List commits](/rest/reference/repos#list-commits) -* [Get a commit](/rest/reference/repos#get-a-commit) -* [List branches for head commit](/rest/reference/repos#list-branches-for-head-commit) -* [List pull requests associated with commit](/rest/reference/repos#list-pull-requests-associated-with-commit) - -##### Repository Community - -* [Get the code of conduct for a repository](/rest/reference/codes-of-conduct#get-the-code-of-conduct-for-a-repository) +##### リポジトリのブランチ + +* [ブランチの一覧表示](/rest/reference/repos#list-branches) +* [ブランチの取得](/rest/reference/repos#get-a-branch) +* [ブランチの保護の取得](/rest/reference/repos#get-branch-protection) +* [ブランチの保護の更新](/rest/reference/repos#update-branch-protection) +* [ブランチの保護の削除](/rest/reference/repos#delete-branch-protection) +* [管理ブランチの保護の取得](/rest/reference/repos#get-admin-branch-protection) +* [管理ブランチの保護の設定](/rest/reference/repos#set-admin-branch-protection) +* [管理ブランチの保護の削除](/rest/reference/repos#delete-admin-branch-protection) +* [Pull Requestのレビュー保護の取得](/rest/reference/repos#get-pull-request-review-protection) +* [Pull Requestのレビュー保護の更新](/rest/reference/repos#update-pull-request-review-protection) +* [Pull Requestのレビュー保護の削除](/rest/reference/repos#delete-pull-request-review-protection) +* [コミット署名の保護の取得](/rest/reference/repos#get-commit-signature-protection) +* [コミット署名の保護の作成](/rest/reference/repos#create-commit-signature-protection) +* [コミット署名の保護の削除](/rest/reference/repos#delete-commit-signature-protection) +* [ステータスチェックの保護の取得](/rest/reference/repos#get-status-checks-protection) +* [ステータスチェックの保護の更新](/rest/reference/repos#update-status-check-protection) +* [ステータスチェックの保護の削除](/rest/reference/repos#remove-status-check-protection) +* [すべてのステータスチェックのコンテキストの取得](/rest/reference/repos#get-all-status-check-contexts) +* [ステータスチェックのコンテキストの追加](/rest/reference/repos#add-status-check-contexts) +* [ステータスチェックのコンテキストの設定](/rest/reference/repos#set-status-check-contexts) +* [ステータスチェックのコンテキストの削除](/rest/reference/repos#remove-status-check-contexts) +* [アクセス制限の取得](/rest/reference/repos#get-access-restrictions) +* [アクセス制限の削除](/rest/reference/repos#delete-access-restrictions) +* [保護されたブランチへのアクセスを持つTeamの一覧表示](/rest/reference/repos#list-teams-with-access-to-the-protected-branch) +* [Teamのアクセス制限の追加](/rest/reference/repos#add-team-access-restrictions) +* [Teamのアクセス制限の設定](/rest/reference/repos#set-team-access-restrictions) +* [Teamのアクセス制限の削除](/rest/reference/repos#remove-team-access-restrictions) +* [保護されたブランチのユーザ制限の一覧表示](/rest/reference/repos#list-users-with-access-to-the-protected-branch) +* [ユーザアクセス制限の追加](/rest/reference/repos#add-user-access-restrictions) +* [ユーザアクセス制限の設定](/rest/reference/repos#set-user-access-restrictions) +* [ユーザアクセス制限の削除](/rest/reference/repos#remove-user-access-restrictions) +* [ブランチのマージ](/rest/reference/repos#merge-a-branch) + +##### リポジトリのコラボレータ + +* [リポジトリのコラボレータの一覧表示](/rest/reference/repos#list-repository-collaborators) +* [ユーザがリポジトリのコラボレータかをチェック](/rest/reference/repos#check-if-a-user-is-a-repository-collaborator) +* [リポジトリのコラボレータを追加](/rest/reference/repos#add-a-repository-collaborator) +* [リポジトリのコラボレータを削除](/rest/reference/repos#remove-a-repository-collaborator) +* [ユーザのリポジトリの権限を取得](/rest/reference/repos#get-repository-permissions-for-a-user) + +##### リポジトリのコミットコメント + +* [リポジトリのコミットコメントの一覧表示](/rest/reference/repos#list-commit-comments-for-a-repository) +* [コミットコメントの取得](/rest/reference/repos#get-a-commit-comment) +* [コミットコメントの更新](/rest/reference/repos#update-a-commit-comment) +* [コミットコメントの削除](/rest/reference/repos#delete-a-commit-comment) +* [コミットコメントの一覧表示](/rest/reference/repos#list-commit-comments) +* [コミットコメントの作成](/rest/reference/repos#create-a-commit-comment) + +##### リポジトリのコミット + +* [コミットの一覧表示](/rest/reference/repos#list-commits) +* [コミットの取得](/rest/reference/repos#get-a-commit) +* [headコミットのブランチの一覧表示](/rest/reference/repos#list-branches-for-head-commit) +* [コミットの関連づけられたPull Requestの一覧表示](/rest/reference/repos#list-pull-requests-associated-with-commit) + +##### リポジトリのコミュニティ + +* [リポジトリの行動規範の取得](/rest/reference/codes-of-conduct#get-the-code-of-conduct-for-a-repository) {% if currentVersion == "free-pro-team@latest" %} -* [Get community profile metrics](/rest/reference/repos#get-community-profile-metrics) +* [コミュニティプロフィールのメトリクスの取得](/rest/reference/repos#get-community-profile-metrics) {% endif %} -##### Repository Contents +##### リポジトリのコンテンツ -* [Download a repository archive](/rest/reference/repos#download-a-repository-archive) -* [Get repository content](/rest/reference/repos#get-repository-content) -* [Create or update file contents](/rest/reference/repos#create-or-update-file-contents) -* [Delete a file](/rest/reference/repos#delete-a-file) -* [Get a repository README](/rest/reference/repos#get-a-repository-readme) -* [Get the license for a repository](/rest/reference/licenses#get-the-license-for-a-repository) +* [リポジトリのアーカイブのダウンロード](/rest/reference/repos#download-a-repository-archive) +* [リポジトリのコンテンツの取得](/rest/reference/repos#get-repository-content) +* [ファイルコンテンツの作成もしくは更新](/rest/reference/repos#create-or-update-file-contents) +* [ファイルの削除](/rest/reference/repos#delete-a-file) +* [リポジトリのREADMEの取得](/rest/reference/repos#get-a-repository-readme) +* [リポジトリのライセンスの取得](/rest/reference/licenses#get-the-license-for-a-repository) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} -##### Repository Event Dispatches +##### リポジトリのイベントのディスパッチ -* [Create a repository dispatch event](/rest/reference/repos#create-a-repository-dispatch-event) +* [リポジトリディスパッチイベントの作成](/rest/reference/repos#create-a-repository-dispatch-event) {% endif %} -##### Repository Hooks +##### リポジトリのフック -* [List repository webhooks](/rest/reference/repos#list-repository-webhooks) -* [Create a repository webhook](/rest/reference/repos#create-a-repository-webhook) -* [Get a repository webhook](/rest/reference/repos#get-a-repository-webhook) -* [Update a repository webhook](/rest/reference/repos#update-a-repository-webhook) -* [Delete a repository webhook](/rest/reference/repos#delete-a-repository-webhook) -* [Ping a repository webhook](/rest/reference/repos#ping-a-repository-webhook) -* [Test the push repository webhook](/rest/reference/repos#test-the-push-repository-webhook) +* [リポジトリのwebhookの一覧表示](/rest/reference/repos#list-repository-webhooks) +* [リポジトリのwebhookの作成](/rest/reference/repos#create-a-repository-webhook) +* [リポジトリのwebhookの取得](/rest/reference/repos#get-a-repository-webhook) +* [リポジトリのwebhookの更新](/rest/reference/repos#update-a-repository-webhook) +* [リポジトリのwebhookの削除](/rest/reference/repos#delete-a-repository-webhook) +* [リポジトリのwebhookのping](/rest/reference/repos#ping-a-repository-webhook) +* [プッシュリポジトリのwebhookのテスト](/rest/reference/repos#test-the-push-repository-webhook) -##### Repository Invitations +##### リポジトリの招待 -* [List repository invitations](/rest/reference/repos#list-repository-invitations) -* [Update a repository invitation](/rest/reference/repos#update-a-repository-invitation) -* [Delete a repository invitation](/rest/reference/repos#delete-a-repository-invitation) -* [List repository invitations for the authenticated user](/rest/reference/repos#list-repository-invitations-for-the-authenticated-user) -* [Accept a repository invitation](/rest/reference/repos#accept-a-repository-invitation) -* [Decline a repository invitation](/rest/reference/repos#decline-a-repository-invitation) +* [リポジトリの招待の一覧表示](/rest/reference/repos#list-repository-invitations) +* [リポジトリの招待の更新](/rest/reference/repos#update-a-repository-invitation) +* [リポジトリの招待の削除](/rest/reference/repos#delete-a-repository-invitation) +* [認証を受けたユーザのリポジトリの招待の一覧表示](/rest/reference/repos#list-repository-invitations-for-the-authenticated-user) +* [リポジトリの招待の受諾](/rest/reference/repos#accept-a-repository-invitation) +* [リポジトリの招待の拒否](/rest/reference/repos#decline-a-repository-invitation) -##### Repository Keys +##### リポジトリのキー -* [List deploy keys](/rest/reference/repos#list-deploy-keys) -* [Create a deploy key](/rest/reference/repos#create-a-deploy-key) -* [Get a deploy key](/rest/reference/repos#get-a-deploy-key) -* [Delete a deploy key](/rest/reference/repos#delete-a-deploy-key) +* [デプロイキーの一覧表示](/rest/reference/repos#list-deploy-keys) +* [デプロイキーの作成](/rest/reference/repos#create-a-deploy-key) +* [デプロイキーの取得](/rest/reference/repos#get-a-deploy-key) +* [デプロイキーの削除](/rest/reference/repos#delete-a-deploy-key) -##### Repository Pages +##### リポジトリのPages -* [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) +* [GitHub Pagesのサイトの取得](/rest/reference/repos#get-a-github-pages-site) +* [GitHub Pagesのサイトの作成](/rest/reference/repos#create-a-github-pages-site) +* [GitHub Pagesのサイトに関する情報の更新](/rest/reference/repos#update-information-about-a-github-pages-site) +* [GitHub Pagesのサイトの削除](/rest/reference/repos#delete-a-github-pages-site) +* [GitHub Pagesのビルドの一覧表示](/rest/reference/repos#list-github-pages-builds) +* [GitHub Pagesのビルドのリクエスト](/rest/reference/repos#request-a-github-pages-build) +* [GitHub Pagesのビルドの取得](/rest/reference/repos#get-github-pages-build) +* [最新のPagesのビルドの取得](/rest/reference/repos#get-latest-pages-build) {% if enterpriseServerVersions contains currentVersion %} -##### Repository Pre Receive Hooks +##### リポジトリ pre-receive フック -* [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) +* [リポジトリのpre-receiveフックの一覧表示](/enterprise/user/rest/reference/enterprise-admin#list-pre-receive-hooks-for-a-repository) +* [リポジトリのpre-receiveフックの取得](/enterprise/user/rest/reference/enterprise-admin#get-a-pre-receive-hook-for-a-repository) +* [リポジトリのpre-receiveフックの強制の更新](/enterprise/user/rest/reference/enterprise-admin#update-pre-receive-hook-enforcement-for-a-repository) +* [リポジトリのpre-receiveフックの強制の削除](/enterprise/user/rest/reference/enterprise-admin#remove-pre-receive-hook-enforcement-for-a-repository) {% endif %} -##### Repository Releases +##### リポジトリのリリース * [リリースの一覧表示](/rest/reference/repos/#list-releases) -* [Create a release](/rest/reference/repos/#create-a-release) -* [Get a release](/rest/reference/repos/#get-a-release) +* [リリースの作成](/rest/reference/repos/#create-a-release) +* [リリースの取得](/rest/reference/repos/#get-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 - -* [Get the weekly commit activity](/rest/reference/repos#get-the-weekly-commit-activity) -* [Get the last year of commit activity](/rest/reference/repos#get-the-last-year-of-commit-activity) -* [Get all contributor commit activity](/rest/reference/repos#get-all-contributor-commit-activity) -* [Get the weekly commit count](/rest/reference/repos#get-the-weekly-commit-count) -* [Get the hourly commit count for each day](/rest/reference/repos#get-the-hourly-commit-count-for-each-day) +* [リリースの削除](/rest/reference/repos/#delete-a-release) +* [リリースアセットの一覧表示](/rest/reference/repos/#list-release-assets) +* [リリースアセットの取得](/rest/reference/repos/#get-a-release-asset) +* [リリースアセットの更新](/rest/reference/repos/#update-a-release-asset) +* [リリースアセットの削除](/rest/reference/repos/#delete-a-release-asset) +* [最新リリースの取得](/rest/reference/repos/#get-the-latest-release) +* [タグ名によるリリースの取得](/rest/reference/repos/#get-a-release-by-tag-name) + +##### リポジトリ統計 + +* [週間のコミットアクティビティの取得](/rest/reference/repos#get-the-weekly-commit-activity) +* [昨年のコミットアクティビティの取得](/rest/reference/repos#get-the-last-year-of-commit-activity) +* [すべてのコントリビューターのコミットアクティビティの取得](/rest/reference/repos#get-all-contributor-commit-activity) +* [週間のコミットカウントの取得](/rest/reference/repos#get-the-weekly-commit-count) +* [各日の毎時のコミットカウントの取得](/rest/reference/repos#get-the-hourly-commit-count-for-each-day) {% if currentVersion == "free-pro-team@latest" %} ##### リポジトリ脆弱性アラート -* [Enable vulnerability alerts](/rest/reference/repos#enable-vulnerability-alerts) -* [Disable vulnerability alerts](/rest/reference/repos#disable-vulnerability-alerts) +* [脆弱性アラートの有効化](/rest/reference/repos#enable-vulnerability-alerts) +* [脆弱性アラートの無効化](/rest/reference/repos#disable-vulnerability-alerts) {% endif %} ##### ルート * [ルートエンドポイント](/rest#root-endpoint) * [絵文字](/rest/reference/emojis#emojis) -* [Get rate limit status for the authenticated user](/rest/reference/rate-limit#get-rate-limit-status-for-the-authenticated-user) +* [認証を受けたユーザのレート制限のステータスの取得](/rest/reference/rate-limit#get-rate-limit-status-for-the-authenticated-user) ##### 検索 -* [Search code](/rest/reference/search#search-code) -* [Search commits](/rest/reference/search#search-commits) -* [Search labels](/rest/reference/search#search-labels) +* [コードの検索](/rest/reference/search#search-code) +* [コミットの検索](/rest/reference/search#search-commits) +* [ラベルの検索](/rest/reference/search#search-labels) * [リポジトリを検索](/rest/reference/search#search-repositories) -* [Search topics](/rest/reference/search#search-topics) -* [Search users](/rest/reference/search#search-users) +* [トピックの検索](/rest/reference/search#search-topics) +* [ユーザの検索](/rest/reference/search#search-users) ##### ステータス -* [Get the combined status for a specific reference](/rest/reference/repos#get-the-combined-status-for-a-specific-reference) -* [List commit statuses for a reference](/rest/reference/repos#list-commit-statuses-for-a-reference) -* [Create a commit status](/rest/reference/repos#create-a-commit-status) +* [特定のリファレンスの結合ステータスの取得](/rest/reference/repos#get-the-combined-status-for-a-specific-reference) +* [リファレンスのコミットステータスの一覧表示](/rest/reference/repos#list-commit-statuses-for-a-reference) +* [コミットステータスの作成](/rest/reference/repos#create-a-commit-status) -##### Team Discussions +##### Teamディスカッション -* [List discussions](/rest/reference/teams#list-discussions) -* [Create a discussion](/rest/reference/teams#create-a-discussion) -* [Get a discussion](/rest/reference/teams#get-a-discussion) -* [Update a discussion](/rest/reference/teams#update-a-discussion) -* [Delete a discussion](/rest/reference/teams#delete-a-discussion) -* [List discussion comments](/rest/reference/teams#list-discussion-comments) -* [Create a discussion comment](/rest/reference/teams#create-a-discussion-comment) -* [Get a discussion comment](/rest/reference/teams#get-a-discussion-comment) -* [Update a discussion comment](/rest/reference/teams#update-a-discussion-comment) -* [Delete a discussion comment](/rest/reference/teams#delete-a-discussion-comment) +* [ディスカッションの一覧表示](/rest/reference/teams#list-discussions) +* [ディスカッションの作成](/rest/reference/teams#create-a-discussion) +* [ディスカッションの取得](/rest/reference/teams#get-a-discussion) +* [ディスカッションの更新](/rest/reference/teams#update-a-discussion) +* [ディスカッションの削除](/rest/reference/teams#delete-a-discussion) +* [ディスカッションコメントの一覧表示](/rest/reference/teams#list-discussion-comments) +* [ディスカッションコメントの作成](/rest/reference/teams#create-a-discussion-comment) +* [ディスカッションコメントの取得](/rest/reference/teams#get-a-discussion-comment) +* [ディスカッションコメントの更新](/rest/reference/teams#update-a-discussion-comment) +* [ディスカッションコメントの削除](/rest/reference/teams#delete-a-discussion-comment) ##### Topics -* [Get all repository topics](/rest/reference/repos#get-all-repository-topics) -* [Replace all repository topics](/rest/reference/repos#replace-all-repository-topics) +* [すべてのリポジトリTopicsの取得](/rest/reference/repos#get-all-repository-topics) +* [すべてのリポジトリTopicsの置き換え](/rest/reference/repos#replace-all-repository-topics) {% if currentVersion == "free-pro-team@latest" %} ##### トラフィック -* [Get repository clones](/rest/reference/repos#get-repository-clones) -* [Get top referral paths](/rest/reference/repos#get-top-referral-paths) -* [Get top referral sources](/rest/reference/repos#get-top-referral-sources) -* [Get page views](/rest/reference/repos#get-page-views) +* [リポジトリのクローンの取得](/rest/reference/repos#get-repository-clones) +* [上位の参照パスの取得](/rest/reference/repos#get-top-referral-paths) +* [上位の参照ソースの取得](/rest/reference/repos#get-top-referral-sources) +* [ページビューの取得](/rest/reference/repos#get-page-views) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -##### User Blocking - -* [List users blocked by the authenticated user](/rest/reference/users#list-users-blocked-by-the-authenticated-user) -* [Check if a user is blocked by the authenticated user](/rest/reference/users#check-if-a-user-is-blocked-by-the-authenticated-user) -* [List users blocked by an organization](/rest/reference/orgs#list-users-blocked-by-an-organization) -* [Check if a user is blocked by an organization](/rest/reference/orgs#check-if-a-user-is-blocked-by-an-organization) -* [Block a user from an organization](/rest/reference/orgs#block-a-user-from-an-organization) -* [Unblock a user from an organization](/rest/reference/orgs#unblock-a-user-from-an-organization) -* [Block a user](/rest/reference/users#block-a-user) -* [Unblock a user](/rest/reference/users#unblock-a-user) +##### ユーザのブロック + +* [認証されたユーザによってブロックされたユーザの一覧表示](/rest/reference/users#list-users-blocked-by-the-authenticated-user) +* [認証されたユーザによってユーザがブロックされているかをチェック](/rest/reference/users#check-if-a-user-is-blocked-by-the-authenticated-user) +* [Organizationによってブロックされたユーザを一覧表示](/rest/reference/orgs#list-users-blocked-by-an-organization) +* [Organizationによってユーザがブロックされているかをチェック](/rest/reference/orgs#check-if-a-user-is-blocked-by-an-organization) +* [Organizationからユーザをブロック](/rest/reference/orgs#block-a-user-from-an-organization) +* [Oraganizationからのユーザのブロックを解除](/rest/reference/orgs#unblock-a-user-from-an-organization) +* [ユーザをブロック](/rest/reference/users#block-a-user) +* [ゆーざのブロックを解除](/rest/reference/users#unblock-a-user) {% endif %} {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -##### User Emails +##### ユーザのメール {% if currentVersion == "free-pro-team@latest" %} -* [Set primary email visibility for the authenticated user](/rest/reference/users#set-primary-email-visibility-for-the-authenticated-user) +* [認証されたユーザのプライマリメールの可視性を設定](/rest/reference/users#set-primary-email-visibility-for-the-authenticated-user) {% endif %} -* [List email addresses for the authenticated user](/rest/reference/users#list-email-addresses-for-the-authenticated-user) -* [Add email address(es)](/rest/reference/users#add-an-email-address-for-the-authenticated-user) -* [Delete email address(es)](/rest/reference/users#delete-an-email-address-for-the-authenticated-user) -* [List public email addresses for the authenticated user](/rest/reference/users#list-public-email-addresses-for-the-authenticated-user) +* [認証されたユーザのメールアドレスの一覧表示](/rest/reference/users#list-email-addresses-for-the-authenticated-user) +* [メールアドレスの追加](/rest/reference/users#list-email-addresses-for-the-authenticated-user) +* [メールアドレスの削除](/rest/reference/users#delete-an-email-address-for-the-authenticated-user) +* [認証されたユーザのパブリックなメールアドレスの一覧表示](/rest/reference/users#list-public-email-addresses-for-the-authenticated-user) {% endif %} -##### User Followers +##### ユーザのフォロワー -* [List followers of a user](/rest/reference/users#list-followers-of-a-user) -* [List the people a user follows](/rest/reference/users#list-the-people-a-user-follows) -* [Check if a person is followed by the authenticated user](/rest/reference/users#check-if-a-person-is-followed-by-the-authenticated-user) -* [Follow a user](/rest/reference/users#follow-a-user) -* [Unfollow a user](/rest/reference/users#unfollow-a-user) -* [Check if a user follows another user](/rest/reference/users#check-if-a-user-follows-another-user) +* [ユーザのフォロワーの一覧表示](/rest/reference/users#list-followers-of-a-user) +* [ユーザがフォローしている人の一覧表示](/rest/reference/users#list-the-people-a-user-follows) +* [認証されたユーザによって人がフォローされているかのチェック](/rest/reference/users#check-if-a-person-is-followed-by-the-authenticated-user) +* [ユーザのフォロー](/rest/reference/users#follow-a-user) +* [ユーザのフォロー解除](/rest/reference/users#unfollow-a-user) +* [ユーザが他のユーザにフォローされているかのチェック](/rest/reference/users#check-if-a-user-follows-another-user) -##### User Gpg Keys +##### ユーザのGPGキー -* [List GPG keys for the authenticated user](/rest/reference/users#list-gpg-keys-for-the-authenticated-user) -* [Create a GPG key for the authenticated user](/rest/reference/users#create-a-gpg-key-for-the-authenticated-user) -* [Get a GPG key for the authenticated user](/rest/reference/users#get-a-gpg-key-for-the-authenticated-user) -* [Delete a GPG key for the authenticated user](/rest/reference/users#delete-a-gpg-key-for-the-authenticated-user) -* [List gpg keys for a user](/rest/reference/users#list-gpg-keys-for-a-user) +* [認証されたユーザのGPGキーの一覧表示](/rest/reference/users#list-gpg-keys-for-the-authenticated-user) +* [認証されたユーザのGPGキーの作成](/rest/reference/users#create-a-gpg-key-for-the-authenticated-user) +* [認証されたユーザのGPGキーの取得](/rest/reference/users#get-a-gpg-key-for-the-authenticated-user) +* [認証されたユーザのGPGキーの削除](/rest/reference/users#delete-a-gpg-key-for-the-authenticated-user) +* [ユーザのGPGキーの一覧表示](/rest/reference/users#list-gpg-keys-for-a-user) -##### User Public Keys +##### ユーザの公開鍵 -* [List public SSH keys for the authenticated user](/rest/reference/users#list-public-ssh-keys-for-the-authenticated-user) -* [Create a public SSH key for the authenticated user](/rest/reference/users#create-a-public-ssh-key-for-the-authenticated-user) -* [Get a public SSH key for the authenticated user](/rest/reference/users#get-a-public-ssh-key-for-the-authenticated-user) -* [Delete a public SSH key for the authenticated user](/rest/reference/users#delete-a-public-ssh-key-for-the-authenticated-user) -* [List public keys for a user](/rest/reference/users#list-public-keys-for-a-user) +* [認証されたユーザの公開SSHキーの一覧表示](/rest/reference/users#list-public-ssh-keys-for-the-authenticated-user) +* [認証されたユーザの公開SSHキーの作成](/rest/reference/users#create-a-public-ssh-key-for-the-authenticated-user) +* [認証されたユーザの公開SSHキーの取得](/rest/reference/users#get-a-public-ssh-key-for-the-authenticated-user) +* [認証されたユーザの公開SSHキーの削除](/rest/reference/users#delete-a-public-ssh-key-for-the-authenticated-user) +* [ユーザの公開鍵の一覧表示](/rest/reference/users#list-public-keys-for-a-user) ##### ユーザ -* [Get the authenticated user](/rest/reference/users#get-the-authenticated-user) -* [List app installations accessible to the user access token](/rest/reference/apps#list-app-installations-accessible-to-the-user-access-token) +* [認証されたユーザの取得](/rest/reference/users#get-the-authenticated-user) +* [ユーザアクセストークンでアクセスできるアプリケーションのインストールの一覧表示](/rest/reference/apps#list-app-installations-accessible-to-the-user-access-token) {% if currentVersion == "free-pro-team@latest" %} * [認証されたユーザのサブスクリプションのリスト](/rest/reference/apps#list-subscriptions-for-the-authenticated-user) {% endif %} -* [List users](/rest/reference/users#list-users) -* [Get a user](/rest/reference/users#get-a-user) +* [ユーザの一覧表示](/rest/reference/users#list-users) +* [ユーザの取得](/rest/reference/users#get-a-user) {% if currentVersion == "free-pro-team@latest" %} -##### Workflow Runs - -* [List workflow runs for a repository](/rest/reference/actions#list-workflow-runs-for-a-repository) -* [Get a workflow run](/rest/reference/actions#get-a-workflow-run) -* [Cancel a workflow run](/rest/reference/actions#cancel-a-workflow-run) -* [Download workflow run logs](/rest/reference/actions#download-workflow-run-logs) -* [Delete workflow run logs](/rest/reference/actions#delete-workflow-run-logs) -* [Re run a workflow](/rest/reference/actions#re-run-a-workflow) -* [List workflow runs](/rest/reference/actions#list-workflow-runs) -* [Get workflow run usage](/rest/reference/actions#get-workflow-run-usage) +##### ワークフローラン + +* [リポジトリのワークフローランの一覧表示](/rest/reference/actions#list-workflow-runs-for-a-repository) +* [ワークフローランの取得](/rest/reference/actions#get-a-workflow-run) +* [ワークフローランのキャンセル](/rest/reference/actions#cancel-a-workflow-run) +* [ワークフローランのログのダウンロード](/rest/reference/actions#download-workflow-run-logs) +* [ワークフローランのログの削除](/rest/reference/actions#delete-workflow-run-logs) +* [ワークフローの再実行](/rest/reference/actions#re-run-a-workflow) +* [ワークフローランの一覧表示](/rest/reference/actions#list-workflow-runs) +* [ワークフローランの利用状況の取得](/rest/reference/actions#get-workflow-run-usage) {% endif %} {% if currentVersion == "free-pro-team@latest" %} ##### ワークフロー -* [List repository workflows](/rest/reference/actions#list-repository-workflows) -* [Get a workflow](/rest/reference/actions#get-a-workflow) -* [Get workflow usage](/rest/reference/actions#get-workflow-usage) +* [リポジトリワークフローの一覧表示](/rest/reference/actions#list-repository-workflows) +* [ワークフローの取得](/rest/reference/actions#get-a-workflow) +* [ワークフロー利用状況の取得](/rest/reference/actions#get-workflow-usage) {% endif %} 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 25e7b8ee8dd6..5fcb1c41f540 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 @@ -52,11 +52,11 @@ $ git clone https://github.com/github-developer/github-app-template.git ローカルのマシンをインターネットに公開することなく、GitHubがwebhookを送信するのを支援するために、Smeeというツールが利用できます。 まず https://smee.io にアクセスして、**Start a new channel**をクリックしてください。 [ngrok](https://dashboard.ngrok.com/get-started)や[localtunnel](https://localtunnel.github.io/www/)のような、ローカルマシンをインターネットに公開してくれる他のツールに慣れているなら、それらを使ってもかまいません。 -![The Smee new channel button](/assets/images/smee-new-channel.png) +![Smeeの新規チャンネルボタン](/assets/images/smee-new-channel.png) 新しいSmeeのチャンネルを起動すると、GitHubがwebhookペイロードを送信できるユニークなドメインが作成されます。 次のステップで必要なので、このドメインを知っておく必要があります。 ユニークなドメインの例は`https://smee.io/qrfeVRbFbffd6vD`といったものです。 -![A Smee unique channel](/assets/images/smee-unique-domain.png) +![Smeeのユニークなチャンネル](/assets/images/smee-unique-domain.png) 次に、ターミナルに戻って以下のステップに従い、Smeeのコマンドラインインターフェース（CLI）クライアントを実行してください。 @@ -93,7 +93,7 @@ $ git clone https://github.com/github-developer/github-app-template.git まだGitHubのアカウントを持っていないなら、ここが[参加する時です](https://github.com/join)。 続行する前にメールを確認するのを忘れないようにしてください! 新しいアプリケーションを登録するには、自分のGitHubのプロフィール内の[アプリケーション設定ペー委](https://github.com/settings/apps)にアクセスし、**New GitHub App**をクリックしてください。 -![GitHub website, showing the **New App**](/assets/images/new-app.png) +![**New App**を表示しているGitHubのWebサイト](/assets/images/new-app.png) 表示されるフォームで、アプリケーションの詳細を入力できます。 このページのフィールドに関する一般的な情報については「[GitHub Appの作成](/apps/building-github-apps/creating-a-github-app/)」を参照してください。 このガイドについては、いくつかのフィールドに特定のデータを入力する必要があります。 @@ -105,21 +105,21 @@ $ git clone https://github.com/github-developer/github-app-template.git * "Homepage URL（ホームページのURL）"には、Smeeが発行したドメインを使用してください。 例: - ![Form with Smee domain filled in for homepage URL](/assets/images/homepage-url.png) + ![ホームページURLにSmeeのドメインが入力されたフォーム](/assets/images/homepage-url.png) * "Webhook URL（webhookのURL）"には、やはりSmeeが発行したドメインを使ってください。 例: - ![Form with Smee domain filled in for webhook URL](/assets/images/webhook-url.png) + ![webhookURLにSmeeのドメインが入力されたフォーム](/assets/images/webhook-url.png) * "Webhook secret（webhookのシークレット）"には、webhookのエンドポイントを保護するパスワードを作成してください。 これは、あなた（そしてこのフォームを介してGitHub）だけが知っているものにするべきです。 パブリックなインターネットから受信したペイロードで、webhookの送信者を検証するのに使われるので、このシークレットは重要です。 GitHub Appの設定ではこのwebhookのシークレットはオプションとなっており、これはほとんどの場合正しいですが、このテンプレートのアプリケーションコードを動作させるためには、webhookのシークレットは設定しなければなりません。 - ![Form with webhook secret filled in](/assets/images/webhook-secret.png) + ![webhookのシークレットが入力されたフォーム](/assets/images/webhook-secret.png) * Permissions & Webhooks（権限とwebhook）ページでは、アプリケーションの権限セットを指定できます。これによって、アプリケーションがどれだけのデータにアクセスできるかが決まります。 このページはデフォルト値のままにしておいてください。 このテンプレートアプリケーションを拡張することにしたら、後でこれらの権限を更新できます。 * Permissions & Webhooks（権限とwebhook）ページの下部で、これがプライベートのアプリケーションなのか、パブリックのアプリケーションなのかを指定してください。 これは、アプリケーションを誰がインストールできるのか、すなわちあなただけなのか、誰でもできるのかを指します。 この時点では、**Only on this account（このアカウントのみ）**を選択して、アプリケーションをプライベートのままにしておいてください。 - ![GitHub App privacy](/assets/images/create_app.png) + ![GitHub Appのプライバシー](/assets/images/create_app.png) **Create GitHub App（GitHub Appの作成）**をクリックして、アプリケーションを作成してください! @@ -129,11 +129,11 @@ $ git clone https://github.com/github-developer/github-app-template.git * **アプリケーションの秘密鍵の生成。**これは後でアプリケーションを認証するために必要です。 ページをスクロールダウンして、**Generate a private key（秘密鍵の生成）**をクリックしてください。 生成されたPEMファイル（_`app-name`_-_`date`_-private-key.pemというような名前）を、また見つけられるディレクトリに保存してください。 - ![The private key generation dialog](/assets/images/private_key.png) + ![秘密鍵の生成ダイアログ](/assets/images/private_key.png) * **GitHubがアプリケーションに割り当てたApp IDを記録してください。**これは、ランタイム環境を準備するのに必要になります。 - Your app's ID number + アプリケーションのID番号 ### ステップ 4. ランタイム環境の準備 @@ -284,15 +284,15 @@ def authenticate_app end ``` -The code above generates a [JSON Web Token (JWT)](https://jwt.io/introduction) and uses it (along with your app's private key) to initialize the Octokit client. GitHub checks a request's authentication by verifying the token with the app's stored public key. To learn more about how this code works, see "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)." +このコードは[JSON Webトークン（JWT）](https://jwt.io/introduction)を生成し、それを（アプリケーションの秘密鍵とともに）使ってOctokitクライアントを初期化します。 GitHubは、保存されたアプリケーションの公開鍵でトークンを検証することによって、リクエストの認証を確認します。 このコードの動作についてさらに学ぶには、「[GitHub Appとして認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)」を参照してください。 ##### インストールとして認証を行う -_インストレーション_とは、アプリケーションをインストールしたユーザまたは Organization のアカウントを指します。 Even if someone installs the app on more than one repository, it only counts as one installation because it's within the same account. The last helper method `authenticate_installation` initializes an [Octokit client](http://octokit.github.io/octokit.rb/Octokit/Client.html) authenticated as an installation. This Octokit client is what you'd use to make authenticated API calls. +_インストール_とは、アプリケーションをインストールしたユーザまたは Organization のアカウントを指します。 ある人がアプリケーションを複数のリポジトリにインストールした場合でも、それらは同じアカウント内なので1つのインストールとしかカウントされません。 最後のヘルパーメソッドである`authenticate_installation`は、インストールとして認証された[Octokitクライアント](http://octokit.github.io/octokit.rb/Octokit/Client.html)を初期化します。 このOctokitクライアントは、認証されたAPI呼び出しを行うために使われます。 ``` ruby -# Instantiate an Octokit client authenticated as an installation of a -# GitHub App to run API operations. +# GitHub Appのインストールとして認証されたOctokitクライアントを、 +# API操作を実行するために初期化する。 def authenticate_installation(payload) installation_id = payload['installation']['id'] installation_token = @app_client.create_app_installation_access_token(installation_id)[:token] @@ -300,40 +300,40 @@ def authenticate_installation(payload) end ``` -The [`create_app_installation_access_token`](http://octokit.github.io/octokit.rb/Octokit/Client/Apps.html#create_app_installation_access_token-instance_method) Octokit method creates an installation token. This method accepts two arguments: +Octokitの[`create_app_installation_access_token`](http://octokit.github.io/octokit.rb/Octokit/Client/Apps.html#create_app_installation_access_token-instance_method)メソッドは、インストールトークンを作成します。 このメソッドは、2つの引数を取ります。 -* Installation (integer): The ID of a GitHub App installation -* Options (hash, defaults to `{}`): A customizable set of options +* Installation (integer): GitHub AppのインストールのID +* Options (hash、デフォルトは`{}`): カスタマイズ可能なオプションのセット -Any time a GitHub App receives a webhook, it includes an `installation` object with an `id`. Using the client authenticated as a GitHub App, you pass this ID to the `create_app_installation_access_token` method to generate an access token for each installation. Since you're not passing any options to the method, the options default to an empty hash. If you look back at [the docs](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation), you can see the response for `create_app_installation_access_token` includes two fields: `token` and `expired_at`. The template code selects the token in the response and initializes an installation client. +いつでもGitHub Appがwebhookを受け取ると、その中には`id`付きの`installation`オブジェクトが含まれています。 GitHub Appとして認証されたクライアントを使い、このIDを`create_app_installation_access_token`メソッドに渡してインストールごとのアクセストークンを生成します。 メソッドにはオプションを渡していないので、オプションはデフォルトの空のハッシュになります。 [ドキュメント](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)を見返してみれば、`create_app_installation_access_token`のレスポンスには`token`と`expired_at`という2つのフィールドが含まれていることが分かります。 テンプレートのコードはレスポンス中のトークンを選択し、インストールクライアントを初期化します。 -With this method in place, each time your app receives a new webhook payload, it creates a client for the installation that triggered the event. This authentication process enables your GitHub App to work for all installations on any account. +このメソッドを利用して、アプリケーションは新しいwebhookのペイロードを受信するたびに、そのイベントをトリガーしたインストールのためのクライアントを作成します。 この認証プロセスによって、GitHub Appは任意のアカウントのすべてのインストールで動作できます。 -Now you're ready to start making API calls! +これでAPI呼び出しを発行する準備ができました! ### ステップ 6. サーバーの起動 -Your app doesn't _do_ anything yet, but at this point, you can get it running on the server. +このアプリケーションはまだなにも_行い_ませんが、この時点でサーバー上で動作させることができます。 -Keep Smee running in the current tab in your Terminal. Open a new tab and `cd` into the directory where you [cloned the template app code](#prerequisites). The Ruby code in this repository will start up a [Sinatra](http://sinatrarb.com/) web server. This code has a few dependencies. You can install these by running: +Smeeは、ターミナルの現在のタブで動作させ続けておいてください。 新しいタブを開き、[テンプレートアプリケーションのコードをクローンした](#prerequisites)ディレクトリに`cd`してください。 このリポジトリのRubyのコードは、[Sinatra](http://sinatrarb.com/) Webサーバーを起動します。 このコードにはいくつかの依存関係があります。 それらは以下のようにしてインストールできます。 ```shell $ gem install bundler ``` -Followed by: +続いて ```shell $ bundle install ``` -With the dependencies installed, you can start the server: +依存関係をインストールしたら、サーバーを起動できます。 ```shell $ ruby template_server.rb ``` -You should see a response like: +次のようなレスポンスが返されるはずです。 ```shell > == Sinatra (v2.0.3) has taken the stage on 3000 for development with backup from Puma @@ -345,25 +345,25 @@ You should see a response like: > Use Ctrl-C to stop ``` -If you see an error, make sure you've created the `.env` file in the directory that contains `template_server.rb`. +エラーが出た場合は、`template_server.rb`があるディレクトリに`.env`ファイルを作成したかを確かめてください。 -Once the server is running, you can test it by going to `http://localhost:3000` in your browser. If the app works as expected, you'll see a helpful error page: +サーバーが動作したら、ブラウザで`http://localhost:3000`にアクセスしてテストしてください。 アプリケーションが期待どおりに動作していれば、役に立つエラーページが表示されます。 -Sinatra's 404 error page +Sinatraの404エラーページ -This is good! Even though it's an error page, it's a _Sinatra_ error page, which means your app is connected to the server as expected. You're seeing this message because you haven't given the app anything else to show. +うまくいっています! これはエラーページではありますが、_Sinatra_のエラーページであり、期待どおりにアプリケーションがサーバーに接続されているということです。 このメッセージが表示されているのは、他に表示するものを何もアプリケーションに加えていないからです。 ### ステップ 7. アカウントへのアプリケーションのインストール -You can test that the server is listening to your app by triggering an event for it to receive. A simple event you can test is installing the app on your GitHub account, which should send the [`installation`](/webhooks/event-payloads/#installation) event. If the app receives it, you should see some output in the Terminal tab where you started `template_server.rb`. +サーバーがアプリケーションを待ち受けているかは、受信するイベントをトリガーすればテストできます。 テストできるシンプルなイベントは、自分のGitHubアカウントにアプリケーションをインストールしてみることで、そうすれば[`installation`](/webhooks/event-payloads/#installation)イベントが送信されます。 アプリケーションがそれを受信すれば、`template_server.rb`を起動したターミナルのタブに、何か出力されるでしょう。 -To install the app, visit the [app settings page](https://github.com/settings/apps), choose your app, and click **Install App** in the sidebar. Next to your username, click **Install**. +アプリケーションをインストールするには、[アプリケーションの設定ページ](https://github.com/settings/apps)にアクセスし、アプリケーションを選択し、サイドバーの**Install App（アプリケーションのインストール）**をクリックしてください。 ユーザ名の隣の** Install（インストール）**をクリックしてください。 -You'll be asked whether to install the app on all repositories or selected repositories. If you don't want to install the app on _all_ of your repositories, that's okay! You may want to create a sandbox repository for testing purposes and install your app there. +アプリケーションをすべてのリポジトリにインストールするか、選択したリポジトリにインストールするかを尋ねられます。 アプリケーションを自分の_すべての_リポジトリにインストールしたいなら、それで問題ありません! テスト用にサンドボックスリポジトリを作成し、そこにアプリケーションをインストールしても良いでしょう。 アプリケーションのインストール権限 -After you click **Install**, look at the output in your Terminal. You should see something like this: +**Install（インストール）**をクリックして、ターミナルの出力を見てみてください。 以下のように出力されているでしょう。 ```shell > D, [2018-06-29T15:45:43.773077 #30488] DEBUG -- : ---- received event integration_installation @@ -374,31 +374,31 @@ After you click **Install**, look at the output in your Terminal. You should see > 192.30.252.39 - - [29/Jun/2018:15:45:43 -0400] "POST / HTTP/1.1" 200 2 0.0019 ``` -This is good news! It means your app received a notification that it was installed on your GitHub account. If you see something like this, your app is running on the server as expected. 🙌 +うまくいっています! これは、GitHubアカウントにアプリケーションがインストールされたという通知をアプリケーションが受信したということです。 このような出力があれば、アプリケーションはサーバー上で期待どおりに動作しています。 🙌 -If you don't see the output, make sure Smee is running correctly in another Terminal tab. If you need to restart Smee, note that you'll also need to _uninstall_ and _reinstall_ the app to send the `installation` event to your app again and see the output in Terminal. If Smee isn't the problem, see the "[Troubleshooting](#troubleshooting)" section for other ideas. +この出力がなければ、別のターミナルタブでSmeeが正しく動作していることを確認してください。 Smeeを再起動しなければならない場合は、アプリケーションに`installation`を再度送信してターミナルの出力を見るために、アプリケーションを_アンインストール_してから_インストールしなおさなければ_ならないことに注意してください。 Smeeが問題ではない場合は、他の原因を[トラブルシューティング](#troubleshooting)セクションで参照してください。 -If you're wondering where the Terminal output above is coming from, it's written in the [app template code](#prerequisites) in `template_server.rb`. +上記のターミナルの出力がどこから来るのか疑問に思うなら、それは`template_server.rb`中の[アプリケーションのテンプレートコード](#prerequisites)に書かれています。 ### トラブルシューティング -Here are a few common problems and some suggested solutions. If you run into any other trouble, you can ask for help or advice in the {% data variables.product.prodname_support_forum_with_url %}. +以下は、いくつかの一般的な問題と推奨される解決策です。 他の問題が生じた場合は、{% data variables.product.prodname_support_forum_with_url %}で助けやアドバイスを求めることができます。 -* **Q:** When I try to install the Smee command-line client, I get the following error: +* **Q:** Smeeのコマンドラインクライアントをインストールしようとすると、以下のエラーが返されます。 ```shell > npm: command not found ``` - **A:** Looks like you don't have npm installed. The best way to install it is to download the Node.js package at https://nodejs.org and follow the installation instructions for your system. npm will be installed alongside Node.js. + **A:** npmがインストールされていないようです。 npmをインストールする最もよい方法は、https://nodejs.orgからNode.jsパッケージをダウンロードし、使っているシステムのためのインストールの指示に従うことです。 npmはNode.jsと併せてインストールされます。 -* **Q:** When I run the server, I get the following error: +* **Q:** サーバーを実行すると、以下のエラーが返されます。 ```shell > server.rb:38:in `initialize': Neither PUB key nor PRIV key: header too long (OpenSSL::PKey::RSAError) ``` - **A:** You probably haven't set up your private key environment variable quite right. Your `GITHUB_PRIVATE_KEY` variable should look like this: + **A:** おそらく秘密鍵の環境変数が正しく設定セットアップされていません。 `GITHUB_PRIVATE_KEY`変数は、以下のようになっていなければなりません。 ``` PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY----- @@ -408,26 +408,26 @@ Here are a few common problems and some suggested solutions. If you run into any -----END RSA PRIVATE KEY-----" ``` - Double-check that you've copied the correct public key into your `.env` file. + `.env`ファイルに正しい公開鍵がコピーされているかを再確認してください。 -* **Q:** When I run the server, it crashes with this error: +* **Q:** サーバーを動作させると、以下のエラーでクラッシュします。 ```shell > Octokit::Unauthorized ... 401 - Bad credentials` ``` - **A:** You may be authenticated as a GitHub App but not as an installation. Make sure you follow all the steps under "[Authenticate as an installation](#authenticating-as-an-installation)," and use the `@installation_client` instance variable (authenticated with an installation access token) for your API operations, not the `@app_client` instance variable (authenticated with a JWT). The `@app_client` can only retrieve high-level information about your app and obtain installation access tokens. It can't do much else in the API. + **A:** インストールとしてではなく、GitHub Appとして認証されている可能性があります。 [インストールとして認証](#authenticating-as-an-installation)以下のすべてのステップに従ったことを確認し、API操作ではインスタンス変数の`@app_client`（JWTでの認証）ではなく、`@installation_client`を使って（インストールアクセストークンで認証を受ける）ください。 `@app_client`はアプリケーションに関する高レベルの情報だけを取得でき、インストールアクセストークンを取得できます。 それ以外のことをAPIで行うことはあまりできません。 -* **Q:** My server isn't listening to events! The Smee client is running in a Terminal window, and I'm installing the app on a repository on GitHub, but I don't see any output in the Terminal window where I'm running the server. +* **Q:** サーバーがイベントを待ち受けていません! Smeeクライアントはターミナルウィンドウで動作していて、アプリケーションをGitHubのリポジトリにインストールしていますが、サーバーを動作させているターミナルウィンドウに出力がありません。 - **A:** You may not be running the Smee client, or you may not have the correct Smee domain in your GitHub App settings. First check to make sure the Smee client is running in a Terminal tab. If that's not the problem, visit your [app settings page](https://github.com/settings/apps) and check the fields shown in "[Step 2. Register a new GitHub App](#step-2-register-a-new-github-app)." Make sure the domain in those fields matches the domain you used in your `smee -u ` command in "[Step 1. 新しいSmeeチャンネルの開始](#step-1-start-a-new-smee-channel)"でwebhookのペイロードをリダイレクトしたポートと一致させます。 + **A:** Smeeクライアントを動作させていないか、GitHub Appの設定に正しいSmeeのドメインがないかもしれません。 まず、ターミナルのタブでSmeeのクライアントが動作しているかを確認してください。 もしそれが問題ではないなら、「[アプリケーションの設定ページ](https://github.com/settings/apps)にアクセスし、[ステップ2 新しいGitHub Appの登録](#step-2-register-a-new-github-app)」で示されているフィールドを確認してください。 それらのフィールド内のドメインが「[ステップ1 新しいSmeeチャンネルの開始](#step-1-start-a-new-smee-channel)"の`smee -u ` コマンドで使ったドメインと一致することを確認してください。 -* **Q:** I'm getting an `Octokit::NotFound` 404 error in my debug output: +* **Q:** デバッグ出力に`Octokit::NotFound` 404エラーが出ます。 ``` 2018-12-06 15:00:56 - Octokit::NotFound - POST https://api.github.com/app/installations/500991/access_tokens: 404 - Not Found // See: /v3/apps/#create-a-new-installation-token: ``` - **A:** Ensure the variables in your `.env` file are correct. Make sure that you have not set identical variables in any other environment variable files like `bash_profile`. You can check the environment variables your app is using by adding `puts` statements to your app code and re-running the code. For example, to ensure you have the correct private key set, you could add `puts PRIVATE_KEY` to your app code: + **A:** `.env`ファイル内の変数が正しいことを確認してください。 `bash_profile`のような他の環境変数ファイルで同じ変数を設定していないことを確認してください。 アプリケーションが使用している環境変数は、アプリケーションのコードに`puts`文を追加して実行し直すことで確認できます。 たとえば、正しい秘密鍵が設定されているかを確認するには、アプリケーションのコードに`puts PRIVATE_KEY`を追加できます。 ``` PRIVATE_KEY = OpenSSL::PKey::RSA.new(ENV['GITHUB_PRIVATE_KEY'].gsub('\n', "\n")) @@ -436,14 +436,14 @@ Here are a few common problems and some suggested solutions. If you run into any ### おわりに -After walking through this guide, you've learned the basic building blocks for developing GitHub Apps! To review, you: +このガイドを見終えれば、GitHub Appを開発するための基本的なビルディングブロックを学んだことになります! 振り返ると、以下を行いました。 -* Registered a new GitHub App -* Used Smee to receive webhook payloads -* Ran a simple web server via Sinatra -* Authenticated as a GitHub App -* Authenticated as an installation +* 新しいGitHub Appの登録 +* Smeeを使ってwebhookのペイロードを受信 +* SinatraでシンプルなWebサーバーを実行 +* GitHub Appとして認証 +* インストールとして認証 ### 次のステップ -You now have a GitHub App running on a server. It doesn't do anything special yet, but check out some of the ways you can customize your GitHub App template in the other [quickstart guides](/apps/quickstart-guides/). +これでGitHub Appをサーバー上で動作させることができました。 まだこれは特別なことは何もしていませんが、他の[クイックスタートガイド](/apps/quickstart-guides/)でGitHub Appテンプレートをカスタマイズする方法を調べてみてください。 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 962e058f9b1d..34e856a44457 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 @@ -1,5 +1,5 @@ --- -title: Suspending a GitHub App installation +title: GitHub Appのインストールのサスペンド intro: '{% data reusables.shortdesc.suspending_a_github_app %}' redirect_from: - /apps/managing-github-apps/suspending-a-github-app-installation @@ -7,24 +7,22 @@ versions: free-pro-team: '*' --- -{% 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 +### GitHub Appのサスペンド -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). +GitHub Appを所有・管理するインテグレーター、すなわちGitHub Appのオーナーは、インストールしたGitHub AppをREST APIを使用してJWTでサスペンドまたはサスペンド解除できます。 詳しい情報については、[GitHub App REST API](/rest/reference/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/)」を参照してください。 +GitHub Appをインストールしたユーザ、すなわちインストールオーナーは、アプリケーションのインストール設定からのみGitHub Appをサスペンドまたはサスペンド解除できます。 インストールオーナーは、インストールしたアプリケーションを、APIを使用してサスペンドまたはサスペンド解除することはできません。 インストールしたGitHub Appをユーザがサスペンドするには、GitHub Appのオーナーがベータリリースにオプトインしている必要があります。 詳しい情報については「[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. {% data variables.product.prodname_github_app %} you want to suspend. +4. サスペンドする{% data variables.product.prodname_github_app %}を選択します。 ![アプリケーションの選択](/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) +6. インストールのサスペンド設定の隣にある、[**Suspend**]または[**Unsuspend**]をクリックします。 ![GitHub Appのサスペンド](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/ja-JP/content/developers/apps/transferring-ownership-of-a-github-app.md b/translations/ja-JP/content/developers/apps/transferring-ownership-of-a-github-app.md index 7ed06990bbba..ac56986cb7c0 100644 --- a/translations/ja-JP/content/developers/apps/transferring-ownership-of-a-github-app.md +++ b/translations/ja-JP/content/developers/apps/transferring-ownership-of-a-github-app.md @@ -1,5 +1,5 @@ --- -title: Transferring ownership of a GitHub App +title: GitHub Appの所有権を移譲する intro: '{% data reusables.shortdesc.transferring_ownership_of_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/transferring-ownership-of-a-github-app/ @@ -13,9 +13,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 ownership you want to transfer. ![アプリケーションの選択](/assets/images/github-apps/github_apps_select-app.png) +4. 所有権を移譲するGitHub Appを選択します。 ![アプリケーションの選択](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} -6. Click **Transfer ownership**. ![Button to transfer ownership](/assets/images/github-apps/github_apps_transfer_ownership.png) -7. Type the name of the GitHub App you want to transfer. ![Field to enter the name of the app to transfer](/assets/images/github-apps/github_apps_transfer_app_name.png) -8. Type the name of the user or organization you want to transfer the GitHub App to. ![Field to enter the user or org to transfer to](/assets/images/github-apps/github_apps_transfer_new_owner.png) -9. Click **Transfer this GitHub App**. ![Button to confirm the transfer of a GitHub App](/assets/images/github-apps/github_apps_transfer_integration.png) +6. [**Transfer ownership**]をクリックします。 ![所有権を移譲するボタン](/assets/images/github-apps/github_apps_transfer_ownership.png) +7. 移譲するGitHub Appの名前を入力します。 ![移譲するアプリケーションの名前を入力するフィールド](/assets/images/github-apps/github_apps_transfer_app_name.png) +8. GitHub Appの移譲先のユーザまたはOrganizationの名前を入力します。 ![移譲先のユーザまたはOrganizationの名前を入力するフィールド](/assets/images/github-apps/github_apps_transfer_new_owner.png) +9. [**Transfer this GitHub App**]をクリックします。 ![GitHub Appの移譲を確認するボタン](/assets/images/github-apps/github_apps_transfer_integration.png) diff --git a/translations/ja-JP/content/developers/apps/transferring-ownership-of-an-oauth-app.md b/translations/ja-JP/content/developers/apps/transferring-ownership-of-an-oauth-app.md index 27618d667552..0593c5bd0a43 100644 --- a/translations/ja-JP/content/developers/apps/transferring-ownership-of-an-oauth-app.md +++ b/translations/ja-JP/content/developers/apps/transferring-ownership-of-an-oauth-app.md @@ -1,5 +1,5 @@ --- -title: Transferring ownership of an OAuth App +title: OAuth App の所有権を移譲する intro: '{% data reusables.shortdesc.transferring_ownership_of_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/transferring-ownership-of-an-oauth-app/ @@ -14,7 +14,7 @@ versions: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} 4. 変更する {% data variables.product.prodname_oauth_app %} を選択します。 ![アプリケーションの選択](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) -5. Click **Transfer ownership**. ![Button to transfer ownership](/assets/images/oauth-apps/oauth_apps_transfer_ownership.png) -6. Type the name of the {% data variables.product.prodname_oauth_app %} you want to transfer. ![Field to enter the name of the app to transfer](/assets/images/oauth-apps/oauth_apps_transfer_oauth_name.png) -7. Type the name of the user or organization you want to transfer the {% data variables.product.prodname_oauth_app %} to. ![Field to enter the user or org to transfer to](/assets/images/oauth-apps/oauth_apps_transfer_new_owner.png) -8. Click **Transfer this application**. ![Button to transfer the application](/assets/images/oauth-apps/oauth_apps_transfer_application.png) +5. [**Transfer ownership**]をクリックします。 ![所有権を移譲するボタン](/assets/images/oauth-apps/oauth_apps_transfer_ownership.png) +6. 移譲する {% data variables.product.prodname_oauth_app %} の名前を入力します。 ![移譲するアプリケーションの名前を入力するフィールド](/assets/images/oauth-apps/oauth_apps_transfer_oauth_name.png) +7. {% data variables.product.prodname_oauth_app %} を移譲するユーザまたは Organization の名前を入力します。 ![移譲先のユーザまたはOrganizationの名前を入力するフィールド](/assets/images/oauth-apps/oauth_apps_transfer_new_owner.png) +8. [**Transfer this application**] をクリックします。 ![アプリケーションを移譲するボタン](/assets/images/oauth-apps/oauth_apps_transfer_application.png) diff --git a/translations/ja-JP/content/developers/apps/troubleshooting-authorization-request-errors.md b/translations/ja-JP/content/developers/apps/troubleshooting-authorization-request-errors.md index ff6624c958c7..b815c5eeb77f 100644 --- a/translations/ja-JP/content/developers/apps/troubleshooting-authorization-request-errors.md +++ b/translations/ja-JP/content/developers/apps/troubleshooting-authorization-request-errors.md @@ -1,5 +1,5 @@ --- -title: Troubleshooting authorization request errors +title: 認可リクエストエラーのトラブルシューティング intro: '{% data reusables.shortdesc.troubleshooting_authorization_request_errors_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/troubleshooting-authorization-request-errors/ @@ -10,35 +10,35 @@ versions: github-ae: '*' --- -### Application suspended +### アプリケーションのサスペンド -If the OAuth App you set up has been suspended (due to reported abuse, spam, or a mis-use of the API), GitHub will redirect to the registered callback URL using the following parameters to summarize the error: +設定した OAuth Appが (不正利用の報告、スパム、APIの誤用により) サスペンドされた場合、GitHubは以下のパラメータを使用して、エラーを手短に説明する、登録されたコールバックURLにリダイレクトします。 http://your-application.com/callback?error=application_suspended &error_description=Your+application+has+been+suspended.+Contact+support@github.com. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23application-suspended &state=xyz -To solve issues with suspended applications, please contact {% data variables.contact.contact_support %}. +サスペンドされたアプリケーションに関する問題を解決するには、{% data variables.contact.contact_support %} までご連絡ください。 -### Redirect URI mismatch +### リダイレクトURIの不一致 -If you provide a `redirect_uri` that doesn't match what you've registered with your application, GitHub will redirect to the registered callback URL with the following parameters summarizing the error: +指定した`redirect_uri`がアプリケーションで登録したものと一致しない場合、GitHubは以下のパラメータを使用して、エラーを手短に説明する、登録されたコールバックURLにリダイレクトします。 http://your-application.com/callback?error=redirect_uri_mismatch &error_description=The+redirect_uri+MUST+match+the+registered+callback+URL+for+this+application. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23redirect-uri-mismatch &state=xyz -To correct this error, either provide a `redirect_uri` that matches what you registered or leave out this parameter to use the default one registered with your application. +このエラーを修正するには、登録したものと一致する`redirect_uri`を指定するか、アプリケーションで登録されているデフォルトのURIを使用するためパラメータを省略します。 -#### Access denied +#### アクセス拒否 -If the user rejects access to your application, GitHub will redirect to the registered callback URL with the following parameters summarizing the error: +If the ユーザがアプリケーションへのアクセスを拒否している場合、GitHubは以下のパラメータを使用して、エラーを手短に説明する、登録されたコールバックURLにリダイレクトします。 http://your-application.com/callback?error=access_denied &error_description=The+user+has+denied+your+application+access. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23access-denied &state=xyz -There's nothing you can do here as users are free to choose not to use your application. More often than not, users will just close the window or press back in their browser, so it is likely that you'll never see this error. +このような場合、あなたにできることは何もありません。ユーザには、あなたのアプリケーションを使用しない自由があります。 ユーザはウインドウを閉じるかブラウザで戻ることが多いため、このエラーをあなたが見ることはないかもしれません。 diff --git a/translations/ja-JP/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md b/translations/ja-JP/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md index c38a7f4ca121..bbb70bc696d5 100644 --- a/translations/ja-JP/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md +++ b/translations/ja-JP/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md @@ -1,5 +1,5 @@ --- -title: Troubleshooting OAuth App access token request errors +title: OAuth Appアクセストークンのリクエストエラーのトラブルシューティング intro: '{% data reusables.shortdesc.troubleshooting_access_token_reques_errors_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/ @@ -12,13 +12,13 @@ versions: {% note %} -**Note:** These examples only show JSON responses. +**注釈:** この例ではJSONのレスポンスのみ示しています。 {% endnote %} -### Incorrect client credentials +### 不正なクライアント認識情報 -If the client\_id and or client\_secret you pass are incorrect you will receive this error response. +渡した client\_id や client\_secret が正しくない場合は、以下のエラーレスポンスを受け取ります。 ```json { @@ -28,11 +28,11 @@ If the client\_id and or client\_secret you pass are incorrect you will receive } ``` -To solve this error, make sure you have the correct credentials for your {% data variables.product.prodname_oauth_app %}. Double check the `client_id` and `client_secret` to make sure they are correct and being passed correctly to {% data variables.product.product_name %}. +このエラーを解決するには、{% data variables.product.prodname_oauth_app %} の正しい認証情報を持っているかを確認します。 `client_id` と `client_secret` が間違っていないか、また {% data variables.product.product_name %} に正しく渡されているかを再確認してください。 -### Redirect URI mismatch +### リダイレクトURIの不一致 -If you provide a `redirect_uri` that doesn't match what you've registered with your {% data variables.product.prodname_oauth_app %}, you'll receive this error message: +指定した `redirect_uri` が {% data variables.product.prodname_oauth_app %} で登録したものと一致しない場合、次のエラーメッセージが表示されます。 ```json { @@ -42,9 +42,9 @@ If you provide a `redirect_uri` that doesn't match what you've registered with y } ``` -To correct this error, either provide a `redirect_uri` that matches what you registered or leave out this parameter to use the default one registered with your application. +このエラーを修正するには、登録したものと一致する`redirect_uri`を指定するか、アプリケーションで登録されているデフォルトのURIを使用するためパラメータを省略します。 -### Bad verification code +### 不正な検証コード ```json { @@ -55,7 +55,7 @@ To correct this error, either provide a `redirect_uri` that matches what you reg } ``` -If the verification code you pass is incorrect, expired, or doesn't match what you received in the first request for authorization you will receive this error. +渡した検証コードが間違っている、有効期限切れ、または最初の認可リクエストで受け取ったものと一致しない場合、このエラーを受信します。 ```json { @@ -65,4 +65,4 @@ If the verification code you pass is incorrect, expired, or doesn't match what y } ``` -To solve this error, start the [OAuth authorization process again](/apps/building-oauth-apps/authorizing-oauth-apps/) and get a new code. +この問題を解決するには、[OAuth Appの認可](/apps/building-oauth-apps/authorizing-oauth-apps/)のプロセスを再び開始し、新しいコードを取得します。 diff --git a/translations/ja-JP/content/developers/apps/using-content-attachments.md b/translations/ja-JP/content/developers/apps/using-content-attachments.md index 61a61a2d3995..5f950ebf09bc 100644 --- a/translations/ja-JP/content/developers/apps/using-content-attachments.md +++ b/translations/ja-JP/content/developers/apps/using-content-attachments.md @@ -1,6 +1,6 @@ --- -title: Using content attachments -intro: Content attachments allow a GitHub App to provide more information in GitHub for URLs that link to registered domains. GitHub renders the information provided by the app under the URL in the body or comment of an issue or pull request. +title: 添付コンテンツを使用する +intro: 添付コンテンツを使うと、GitHub Appは登録されたドメインにリンクするURLに対し、GitHub内でより多くの情報を提供できます。 GitHubは、アプリケーションから提供された情報を、IssueやPull Requestのボディやコメント内のURLの下に表示します。 redirect_from: - /apps/using-content-attachments versions: @@ -11,32 +11,32 @@ versions: {% data reusables.pre-release-program.content-attachments-public-beta %} -### About content attachments +### 添付コンテンツについて -A GitHub App can register domains that will trigger `content_reference` events. When someone includes a URL that links to a registered domain in the body or comment of an issue or pull request, the app receives the [`content_reference` webhook](/webhooks/event-payloads/#content_reference). You can use content attachments to visually provide more context or data for the URL added to an issue or pull request. The URL must be a fully-qualified URL, starting with either `http://` or `https://`. URLs that are part of a markdown link are ignored and don't trigger the `content_reference` event. +GitHub Appは、`content_reference`イベントをトリガーするドメインを登録できます。 Issueまたはプルリクエストの、ボディまたはコメントに、登録されたドメインにリンクするURLが含まれている場合、アプリケーションは[`content_reference` webhook](/webhooks/event-payloads/#content_reference)を受け取ります。 添付コンテンツを使用して、Issueまたはプルリクエストに追加したURLについてのコンテキストやデータを視覚的に追加できます。 URLは、`http://`または`https://`から始まる、完全修飾URLである必要があります。 Markdownリンクの一部であるURLは無視され、`content_reference`イベントをトリガーしません。 -Before you can use the {% data variables.product.prodname_unfurls %} API, you'll need to configure content references for your GitHub App: -* Give your app `Read & write` permissions for "Content references." -* Register up to 5 valid, publicly accessible domains when configuring the "Content references" permission. Do not use IP addresses when configuring content reference domains. You can register a domain name (example.com) or a subdomain (subdomain.example.com). -* Subscribe your app to the "Content reference" event. +{% data variables.product.prodname_unfurls %} APIを使用する前に、以下を行ってGitHub Appのコンテンツ参照を設定する必要があります。 +* アプリケーションに、[Content references] に対する`Read & write`権限を付与します。 +* [Content references] 権限を設定する際に、一般にアクセス可能なドメインを5つまで登録します。 コンテンツ参照ドメインを設定する際は、IPアドレスは使用しないでください。 ドメイン名 (example.com) またはサブドメイン (subdomain.example.com) を登録できます。 +* アプリケーションを [Content reference] イベントにサブスクライブします。 -Once your app is installed on a repository, issue or pull request comments in the repository that contain URLs for your registered domains will generate a content reference event. アプリケーションは、コンテンツ参照URLがポストされてから6時間以内に添付コンテンツを作成しなければなりません。 +アプリケーションがリポジトリにインストールされると、登録されたドメインへのURLが含まれるIssueまたはプルリクエストのコメントでは、コンテンツ参照イベントが生成されます。 アプリケーションは、コンテンツ参照URLがポストされてから6時間以内に添付コンテンツを作成しなければなりません。 -Content attachments will not retroactively update URLs. It only works for URLs added to issues or pull requests after you configure the app using the requirements outlined above and then someone installs the app on their repository. +添付コンテンツが、URLを遡って更新することはありません。 上記でまとめた要件に従ってアプリケーションを設定した後に、ユーザがリポジトリにアプリケーションをインストールしてから、Issueまたはプルリクエストに追加したURLに対してのみ機能します。 -See "[Creating a GitHub App](/apps/building-github-apps/creating-a-github-app/)" or "[Editing a GitHub App's permissions](/apps/managing-github-apps/editing-a-github-app-s-permissions/)" for the steps needed to configure GitHub App permissions and event subscriptions. +GitHub App の権限やイベントのサブスクリプションを設定するために必要なステップに関する詳しい情報については、「<[GitHub App を作成する](/apps/building-github-apps/creating-a-github-app/)」または「[GitHub App の権限を編集する](/apps/managing-github-apps/editing-a-github-app-s-permissions/)」を参照してください。 -### Implementing the content attachment flow +### 添付コンテンツフローを実装する -The content attachment flow shows you the relationship between the URL in the issue or pull request, the `content_reference` webhook event, and the REST API endpoint you need to call to update the issue or pull request with additional information: +添付コンテンツのフローは、IssueもしくはPull Request中のURL、`content_reference` webhookイベント、追加情報でIssueもしくはPull Requestを更新するために呼ぶ必要があるREST APIエンドポイント間の関係を示します。 -**Step 1.** Set up your app using the guidelines outlined in [About content attachments](#about-content-attachments). You can also use the [Probot App example](#example-using-probot-and-github-app-manifests) to get started with content attachments. +**ステップ 1.** [添付コンテンツについて](#about-content-attachments)に記載されているガイドラインに従ってアプリケーションを設定します。 添付コンテンツを使い始めるには、[Probotアプリケーションのサンプル](#example-using-probot-and-github-app-manifests)を使うこともできます。 -**Step 2.** Add the URL for the domain you registered to an issue or pull request. You must use a fully qualified URL that starts with `http://` or `https://`. +**ステップ2。**IssueもしくはPull Requestに登録したドメインのURLを追加します。 `http://`もしくは`https://`で始まる完全修飾URLを使わなければなりません。 -![URL added to an issue](/assets/images/github-apps/github_apps_content_reference.png) +![Issueに追加されたURL](/assets/images/github-apps/github_apps_content_reference.png) -**Step 3.** Your app will receive the [`content_reference` webhook](/webhooks/event-payloads/#content_reference) with the action `created`. +**ステップ3。**アプリケーションは`created`アクション付きで[`content_reference` webhook](/webhooks/event-payloads/#content_reference)を受信します。 ``` json { @@ -55,12 +55,12 @@ The content attachment flow shows you the relationship between the URL in the is } ``` -**Step 4.** The app uses the `content_reference` `id`, to [Create a content attachment](/rest/reference/apps#create-a-content-attachment) using the REST API. You'll also need the `installation` `id` to authenticate as a [GitHub App installation](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation). +**ステップ4。**アプリケーションはREST APIを使って[添付コンテンツを作成する](/rest/reference/apps#create-a-content-attachment)ために`content_reference` `id`を使います。 [GitHub Appのインストール](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)として認証を受けるために、`installation` `id`も必要になります。 {% data reusables.pre-release-program.corsair-preview %} {% data reusables.pre-release-program.api-preview-warning %} -The `body` parameter can contain markdown: +`body`パラメータにはMarkdownが含まれていることがあります。 ```shell curl -X POST \ @@ -73,14 +73,14 @@ The `body` parameter can contain markdown: }' ``` -For more information about creating an installation token, see "[Authenticating as a GitHub App](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." +インストールトークンの作成に関する詳しい情報については「[GitHub Appとして認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)」を参照してください。 -**Step 5.** You'll see the new content attachment appear under the link in a pull request or issue comment: +**ステップ5。** Pull RequestもしくはIssueコメント内のリンクの下に、新しい添付コンテンツが表示されます。 -![Content attached to a reference in an issue](/assets/images/github-apps/github_apps_content_reference_attachment.png) +![Issueのリファレンスに添付されたコンテンツ](/assets/images/github-apps/github_apps_content_reference_attachment.png) -### Using content attachments in GraphQL -We provide the `node_id` in the [`content_reference` webhook](/webhooks/event-payloads/#content_reference) event so you can refer to the `createContentAttachment` mutation in the GraphQL API. +### GraphQLでの添付コンテンツの利用 +[`content_reference` webhook](/webhooks/event-payloads/#content_reference)イベント中で`node_id`を提供しているので、GraphQL APIの`createContentAttachment`ミューテーションを参照できます。 {% data reusables.pre-release-program.corsair-preview %} {% data reusables.pre-release-program.api-preview-warning %} @@ -104,7 +104,7 @@ mutation { } } ``` -Example cURL: +cURLの例: ```shell curl -X "POST" "https://api.github.com/graphql" \ @@ -116,25 +116,25 @@ curl -X "POST" "https://api.github.com/graphql" \ }' ``` -For more information on `node_id`, see "[Using Global Node IDs](/graphql/guides/using-global-node-ids)." +`node_id`の詳しい情報については「[グローバルノードIDの利用](/graphql/guides/using-global-node-ids)」を参照してください。 -### Example using Probot and GitHub App Manifests +### ProbotとGitHub Appマニフェストの利用例 -To quickly setup a GitHub App that can use the {% data variables.product.prodname_unfurls %} API, you can use [Probot](https://probot.github.io/). See "[Creating GitHub Apps from a manifest](/apps/building-github-apps/creating-github-apps-from-a-manifest/)" to learn how Probot uses GitHub App Manifests. +{% data variables.product.prodname_unfurls %} APIを使用できるGitHub Appを手早くセットアップするには、[Probot](https://probot.github.io/)が利用できます。 ProbotがどのようにGitHub Appのマニフェストを使用するかを学ぶには、「[マニフェストからのGitHub Appの作成](/apps/building-github-apps/creating-github-apps-from-a-manifest/)」を参照してください。 -To create a Probot App, follow these steps: +Probotアプリケーションを作成するには、以下のステップに従ってください。 1. [新しい GitHub App を作成](https://probot.github.io/docs/development/#generating-a-new-app)します。 -2. 作成したプロジェクトを開き、 `app.yml` ファイルの設定をカスタマイズします。 Subscribe to the `content_reference` event and enable `content_references` write permissions: +2. 作成したプロジェクトを開き、 `app.yml` ファイルの設定をカスタマイズします。 `content_reference`イベントをサブスクライブし、`content_references`の書き込み権限を有効化してください。 ``` yml default_events: - content_reference - # The set of permissions needed by the GitHub App. The format of the object uses - # the permission name for the key (for example, issues) and the access type for - # the value (for example, write). - # Valid values are `read`, `write`, and `none` + # GitHub Appが必要とする権限セット。 このオブジェクトのフォーマットは、 + # キーの権限名（たとえばissues）と値のためのアクセスの + # 種類（たとえばwrite）を使います。 + # 取り得る値は `read`、`write`、`none` default_permissions: content_references: write @@ -145,34 +145,34 @@ To create a Probot App, follow these steps: value: example.org ``` -3. Add this code to the `index.js` file to handle `content_reference` events and call the REST API: +3. このコードを`index.js` ファイルに追加して、`content_reference`を処理してREST APIを呼ぶようにします。 ``` javascript module.exports = app => { - // Your code here + // ここにコードを書く app.log('Yay, the app was loaded!') app.on('content_reference.created', async context => { console.log('Content reference created!', context.payload) - // Call the "Create a content reference" REST endpoint + // "Create a content reference" RESTエンドポイントを呼ぶ await context.github.request({ method: 'POST', headers: { accept: 'application/vnd.github.corsair-preview+json' }, url: `/content_references/${context.payload.content_reference.id}/attachments`, - // Parameters + // パラメータ title: '[A-1234] Error found in core/models.py file', body: 'You have used an email that already exists for the user_email_uniq field.\n ## DETAILS:\n\nThe (email)=(Octocat@github.com) already exists.\n\n The error was found in core/models.py in get_or_create_user at line 62.\n\nself.save()' }) }) - } + }body ``` -4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to [localhost:3000](http://localhost:3000), and click the **Register GitHub App** button: +4. [GitHub Appをローカルで動作させます](https://probot.github.io/docs/development/#running-the-app-locally)。 `http://localhost:3000`にアクセスして、**Register GitHub App**ボタンをクリックしてください。 ![Probot GitHub App の登録](/assets/images/github-apps/github_apps_probot-registration.png) -5. Install the app on a test repository. -6. Create an issue in your test repository. -7. Add a comment to the issue you opened that includes the URL you configured in the `app.yml` file. -8. Take a look at the issue comment and you'll see an update that looks like this: +5. テストリポジトリにアプリケーションをインストールしてください。 +6. テストリポジトリでIssueを作成してください。 +7. オープンしたIssueに`app.yml`ファイルで設定したURLを含むコメントを追加してください。 +8. Issueのコメントを見ると、以下のように更新されています。 - ![Content attached to a reference in an issue](/assets/images/github-apps/github_apps_content_reference_attachment.png) + ![Issueのリファレンスに添付されたコンテンツ](/assets/images/github-apps/github_apps_content_reference_attachment.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 226c8991f9c7..a74b5b8fee9e 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 @@ -1,6 +1,6 @@ --- -title: Using the GitHub API in your app -intro: Learn how to set up your app to listen for events and use the Octokit library to perform REST API operations. +title: アプリケーションでのGitHub APIの利用 +intro: イベントを待ち受けるアプリケーションのセットアップと、Octokitライブラリを使ったREST APIの操作の方法を学んでください。 redirect_from: - /apps/building-your-first-github-app/ - /apps/quickstart-guides/using-the-github-api-in-your-app @@ -13,16 +13,16 @@ 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. +このガイドは、GitHub Appをビルドしてサーバー上で実行するのに役立ちます。 ビルドするアプリケーションは、アプリケーションがインストールされたリポジトリでオープンされたすべての新しいIssueにラベルを付けます。 -This project will walk you through the following: +このプロジェクトでは、以下を見ていきます。 -* Programming your app to listen for events -* Using the Octokit.rb library to do REST API operations +* イベントを待ち受けるアプリケーションのプログラミング +* Octokit.rbライブラリを使ったREST APIの操作の実行 {% data reusables.apps.app-ruby-guides %} -Once you've worked through the steps, you'll be ready to develop other kinds of integrations using the full suite of GitHub APIs. {% if currentVersion == "free-pro-team@latest" %} アプリケーションの成功例は、[GitHub Marketplace](https://github.com/marketplace)や[Works with GitHub](https://github.com/works-with)で調べることができます。{% endif %} +以下のステップを行っていけば、GitHub APIの完全な一式を使って他の種類のインテグレーションを開発する準備が整います。 {% if currentVersion == "free-pro-team@latest" %} アプリケーションの成功例は、[GitHub Marketplace](https://github.com/marketplace)や[Works with GitHub](https://github.com/works-with)で調べることができます。{% endif %} ### 必要な環境 @@ -36,60 +36,60 @@ Once you've worked through the steps, you'll be ready to develop other kinds of とはいえ、経験のレベルにかかわらず見ていくことはできます。 その過程で必要な情報にはリンクしていきます！ -Before you begin, you'll need to do the following: +始める前に、以下を行っておく必要があります。 -1. Clone the [Using the GitHub API in your app](https://github.com/github-developer/using-the-github-api-in-your-app) repository. +1. [Using the GitHub API in your app](https://github.com/github-developer/using-the-github-api-in-your-app)リポジトリのクローン。 ```shell $ git clone https://github.com/github-developer/using-the-github-api-in-your-app.git ``` ディレクトリの中には、このクイックスタートで使用する `template_server.rb` ファイルと、完成したプロジェクトコードである `server.rb` ファイルがあります。 -1. Follow the steps in the [Setting up your development environment](/apps/quickstart-guides/setting-up-your-development-environment/) quickstart to configure and run the `template_server.rb` app server. If you've previously completed a GitHub App quickstart other than [Setting up your development environment](/apps/quickstart-guides/setting-up-your-development-environment/), you should register a _new_ GitHub App and start a new Smee channel to use with this quickstart. +1. [開発環境のセットアップ](/apps/quickstart-guides/setting-up-your-development-environment/)クイックスタート中のステップに従い、`template_server.rb`アプリケーションサーバーを設定し、実行してください。 [開発環境のセットアップ](/apps/quickstart-guides/setting-up-your-development-environment/)以外のGitHub Appクイックスタートを完了させたことがあるなら、_新しい_GitHub Appを登録して、このクイックスタートで使う新しいSmeeチャンネルを開始してください。 - This quickstart includes the same `template_server.rb` code as the [Setting up your development environment](/apps/quickstart-guides/setting-up-your-development-environment/) quickstart. **Note:** As you follow along with the [Setting up your development environment](/apps/quickstart-guides/setting-up-your-development-environment/) quickstart, make sure to use the project files included in the [Using the GitHub API in your app](https://github.com/github-developer/using-the-github-api-in-your-app) repository. + このクイックスタートには、[開発環境のセットアップ](/apps/quickstart-guides/setting-up-your-development-environment/)クイックスタートと同じ`template_server.rb`コードが含まれています。 **ノート:** [開発環境のセットアップ](/apps/quickstart-guides/setting-up-your-development-environment/)クイックスタートを見ていく際には、必ず[Using the GitHub API in your app](https://github.com/github-developer/using-the-github-api-in-your-app)リポジトリに含まれているプロジェクトをファイルを使ってください。 - See the [Troubleshooting](/apps/quickstart-guides/setting-up-your-development-environment/#troubleshooting) section if you are running into problems setting up your template GitHub App. + テンプレートのGitHub Appのセットアップで問題が生じた場合は、[トラブルシューティング](/apps/quickstart-guides/setting-up-your-development-environment/#troubleshooting)のセクションを参照してください。 -### Building the app +### アプリケーションのビルド -Now that you're familiar with the `template_server.rb` code, you're going to create code that automatically adds the `needs-response` label to all issues opened in the repository where the app is installed. +`template_server.rb`のコードに馴染んだところで、アプリケーションがインストールされたリポジトリでオープンされたすべてのIssueに自動的に`needs-response`ラベルを追加するコードを作成しましょう。 -The `template_server.rb` file contains app template code that has not yet been customized. In this file, you'll see some placeholder code for handling webhook events and some other code for initializing an Octokit.rb client. +`template_server.rb`ファイルには、まだカスタマイズされていないアプリケーションのテンプレートコードが含まれています。 このファイルには、webhookイベントを処理するためのプレースホルダーのコードや、Octokit.rbクライアントを初期化する他のコードが含まれています。 {% note %} -**Note:** `template_server.rb` contains many code comments that complement this guide and explain additional technical details. You may find it helpful to read through the comments in that file now, before continuing with this section, to get an overview of how the code works. +**ノート:** `template_server.rb`には、このガイドを補完し、追加の技術的な詳細を説明する多くのコードコメントが含まれています。 このセクションの先に進む前に、コードの動作の概要をつかむために、この時点でこのファイル中のコメントを読み通しておくと役立つかもしれません。 -The final customized code that you'll create by the end of this guide is provided in [`server.rb`](https://github.com/github-developer/using-the-github-api-in-your-app/blob/master/server.rb). Try waiting until the end to look at it, though! +このガイドの終わりに作成することになるカスタマイズされた最終のコードは、[`server.rb`](https://github.com/github-developer/using-the-github-api-in-your-app/blob/master/server.rb)にあります。 とはいえ、最後までそれを見るのは待ってみてください! {% endnote %} -These are the steps you'll complete to create your first GitHub App: +以下が、最初のGitHub Appを作成するまでに行うステップです。 -1. [Update app permissions](#step-1-update-app-permissions) -2. [Add event handling](#step-2-add-event-handling) -3. [Create a new label](#step-3-create-a-new-label) -4. [Add label handling](#step-4-add-label-handling) +1. [アプリケーションの権限の更新](#step-1-update-app-permissions) +2. [イベント処理の追加](#step-2-add-event-handling) +3. [新しいラベルの作成](#step-3-create-a-new-label) +4. [ラベルの処理の追加](#step-4-add-label-handling) -### ステップ 1. Update app permissions +### ステップ 1. アプリケーションの権限の更新 -[最初にアプリケーションを登録](/apps/quickstart-guides/setting-up-your-development-environment/#step-2-register-a-new-github-app)した際は、デフォルトの権限を受け入れています。これは、アプリケーションがほとんどのリソースにアクセスできないことを意味します。 For this example, your app will need permission to read issues and write labels. +[最初にアプリケーションを登録](/apps/quickstart-guides/setting-up-your-development-environment/#step-2-register-a-new-github-app)した際は、デフォルトの権限を受け入れています。これは、アプリケーションがほとんどのリソースにアクセスできないことを意味します。 この例においては、アプリケーションはIssueを読み、ラベルを書く権限を必要とします。 アプリケーションの権限を更新するには、以下の手順に従います。 -1. [アプリケーションの設定ページ](https://github.com/settings/apps)からアプリケーションを選択肢、サイドバーの [**Permissions & Webhooks**] をクリックします。 -1. In the "Permissions" section, find "Issues," and select **Read & Write** in the "Access" dropdown next to it. The description says this option grants access to both issues and labels, which is just what you need. -1. In the "Subscribe to events" section, select **Issues** to subscribe to the event. +1. [アプリケーションの設定ページ](https://github.com/settings/apps)からアプリケーションを選択し、サイドバーの [**Permissions & Webhooks**] をクリックします。 +1. "Permissions（権限）"セクションで"Issues"を見つけ、隣の"Access（アクセス）"ドロップダウンで**Read & Write（読み書き）**を選択してください。 このオプションはIssueとラベルの両方へのアクセスを許可するものと説明されており、これはまさに必要なことです。 +1. "Subscribe to events（イベントのサブスクライブ）"セクションで、**Issues**を選択してこのイベントをサブスクライブしてください。 {% data reusables.apps.accept_new_permissions_steps %} -これでうまくいきました。 アプリケーションは必要なタスクを実行する権限を所有しています。 Now you can add the code to make it work. +これでうまくいきました。 アプリケーションは必要なタスクを実行する権限を所有しています。 これで、アプリケーションを動作させるコードを追加できるようになりました。 -### ステップ 2. Add event handling +### ステップ 2. イベント処理の追加 -The first thing your app needs to do is listen for new issues that are opened. Now that you've subscribed to the **Issues** event, you'll start receiving the [`issues`](/webhooks/event-payloads/#issues) webhook, which is triggered when certain issue-related actions occur. You can filter this event type for the specific action you want in your code. +アプリケーションが最初にやらなければならないのは、オープンされた新しいIssueを待ち受けることです。 **Issues**イベントにサブスクライブしたので、[`issues`](/webhooks/event-payloads/#issues) webhookを受信し始めることになります。このイベントは、特定のIssueに関連するアクションが生じたときにトリガーされます。 コード中にほしい特定のアクションに対してこのイベントの種類をフィルターできます。 -GitHub は webhook ペイロードを `POST` リクエストとして送信します。 Because you forwarded your Smee webhook payloads to `http://localhost/event_handler:3000`, your server will receive the `POST` request payloads in the `post '/event_handler'` route. +GitHub は webhook ペイロードを `POST` リクエストとして送信します。 Smeeのwebhookペイロードは`http://localhost/event_handler:3000`に転送しているので、サーバーはこの`POST`リクエストのペイロードを`post '/event_handler'`ルートで受け取ります。 空の `post '/event_handler'` ルートは、[必要な環境](#prerequisites)セクションでダウンロードした `template_server.rb` ファイルに既に含まれています。 空のルートは次のようになっています。 @@ -104,7 +104,7 @@ GitHub は webhook ペイロードを `POST` リクエストとして送信し end ``` -Use this route to handle the `issues` event by adding the following code: +以下のコードを追加することで、このルートを使って`issues`イベントを処理してください。 ``` ruby case request.env['HTTP_X_GITHUB_EVENT'] @@ -115,9 +115,9 @@ when 'issues' end ``` -GitHub が送信する全てのイベントには、`HTTP_X_GITHUB_EVENT` というリクエストヘッダが含まれており、これは `POST` リクエストのイベントの型を示します。 Right now, you're only interested in `issues` event types. 各イベントには、アクションをトリガーしたイベントのタイプを示す `action` フィールドが付いています。 For `issues`, the `action` field can be `assigned`, `unassigned`, `labeled`, `unlabeled`, `opened`, `edited`, `milestoned`, `demilestoned`, `closed`, or `reopened`. +GitHub が送信する全てのイベントには、`HTTP_X_GITHUB_EVENT` というリクエストヘッダが含まれており、これは `POST` リクエストのイベントの型を示します。 この時点では、関心があるのは`issues`というイベントの種類だけです。 各イベントには、アクションをトリガーしたイベントのタイプを示す `action` フィールドが付いています。 `issues`の場合、`action`フィールドは`assigned`、`unassigned`、`labeled`、`unlabeled`、`opened`、`edited`、`milestoned`、`demilestoned`、`closed`、`reopened`のいずれかです。 -To test your event handler, try adding a temporary helper method. You'll update later when you [Add label handling](#step-4-add-label-handling). For now, add the following code inside the `helpers do` section of the code. You can put the new method above or below any of the other helper methods. Order doesn't matter. +イベントハンドラをテストするには、一時的なヘルパーメソッドを追加してみてください。 後で[ラベルの処理を追加](#step-4-add-label-handling)するときに更新します。 この時点では、以下のコードを`helpers do`セクションの中に追加してください。 他の任意のヘルパーメソッドの前後に新しいメソッドを追加できます。 順序は問題ではありません。 ``` ruby def handle_issue_opened_event(payload) @@ -125,37 +125,37 @@ def handle_issue_opened_event(payload) end ``` -This method receives a JSON-formatted event payload as an argument. This means you can parse the payload in the method and drill down to any specific data you need. You may find it helpful to inspect the full payload at some point: try changing `logger.debug 'An issue was opened!` to `logger.debug payload`. The payload structure you see should match what's [shown in the `issues` webhook event docs](/webhooks/event-payloads/#issues). +このメソッドはJSON形式のイベントペイロードを引数として受け取ります。 これは、メソッド中でペイロードをパースして、任意の必要なデータへとドリルダウンしていけるということです。 どこかの時点でペイロード全体を調べると役立つかもしれません。`logger.debug 'An issue was opened!`を`logger.debug payload`に変更してみてください。 出力されるペイロードの構造は、[`issues` webhookイベントのドキュメントに示されている](/webhooks/event-payloads/#issues)ものと一致しているはずです。 -これでうまくいきました。 It's time to test the changes. +これでうまくいきます! 変更をテストしてみましょう。 {% data reusables.apps.sinatra_restart_instructions %} -In your browser, visit the repository where you installed your app. Open a new issue in this repository. The issue can say anything you like. It's just for testing. +ブラウザで、アプリケーションをインストールしたリポジトリにアクセスしてください。 そのリポジトリで新しいIssueをオープンしてください。 そのIssueは好きな内容でかまいません。 これは単にテストにすぎません。 -When you look back at your Terminal, you should see a message in the output that says, `An issue was opened!` Congrats! You've added an event handler to your app. 💪 +ターミナルを見直してみれば、`An issue was opened!`というメッセージが出力にあるはずです。おめでとうございます! アプリケーションにイベントハンドラを追加できました。 💪 -### ステップ 3. Create a new label +### ステップ 3. 新しいラベルの作成 -Okay, your app can tell when issues are opened. Now you want it to add the label `needs-response` to any newly opened issue in a repository the app is installed in. +これで、アプリケーションはIssueがオープンされたときを示せるようになりました。 今度は、アプリケーションがインストールされたリポジトリのあらゆる新しくオープンされたIssueに`needs-response`というラベルを追加しましょう。 -Before the label can be _added_ anywhere, you'll need to _create_ the custom label in your repository. You'll only need to do this one time. For the purposes of this guide, create the label manually on GitHub. In your repository, click **Issues**, then **Labels**, then click **New label**. Name the new label `needs-response`. +ラベルをどこでも_追加_できるようにするには、リポジトリでカスタムラベルを_作成_しなければなりません。 これをする必要があるのは一度だけです。 このガイドのためには、ラベルをGitHub上で手動で作成します。 リポジトリで**Issues**をクリックして、続いて**Labels**を、そして**New label（新規ラベル）**をクリックしてください。 新しいラベルの名前を`needs-response`にしてください。 {% tip %} -**Tip**: Wouldn't it be great if your app could create the label programmatically? [It can](/rest/reference/issues#create-a-label)! Try adding the code to do that on your own after you finish the steps in this guide. +**Tip**: アプリケーションがラベルをプログラムから作成できたら素晴らしいのではないでしょうか？ [できます](/rest/reference/issues#create-a-label)! このガイドのステップを終えた後に、自分でそのためのコードを追加してみてください。 {% endtip %} -Now that the label exists, you can program your app to use the REST API to [add the label to any newly opened issue](/rest/reference/issues#add-labels-to-an-issue). +これでラベルができたので、REST APIを使って[新しくオープンされたすべてのIssueにラベルを追加する](/rest/reference/issues#add-labels-to-an-issue)ようにアプリケーションをプログラムできます。 -### ステップ 4. Add label handling +### ステップ 4. ラベルの処理の追加 -Congrats—you've made it to the final step: adding label handling to your app. For this task, you'll want to use the [Octokit.rb Ruby library](http://octokit.github.io/octokit.rb/). +おめでとうございます。最後のステップである、アプリケーションへのラベル処理の追加にまで来ました。 このタスクのためには、[Octokit.rb Rubyライブラリ](http://octokit.github.io/octokit.rb/)を使いましょう。 -In the Octokit.rb docs, find the list of [label methods](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html). The method you'll want to use is [`add_labels_to_an_issue`](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html#add_labels_to_an_issue-instance_method). +Octokit.rbのドキュメントで、[ラベルメソッド](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html)のリストを見つけてください。 使うメソッドは[`add_labels_to_an_issue`](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html#add_labels_to_an_issue-instance_method)です。 -Back in `template_server.rb`, find the method you defined previously: +`template_server.rb`に戻って、以前に定義したメソッドを見つけてください。 ``` ruby def handle_issue_opened_event(payload) @@ -163,16 +163,16 @@ def handle_issue_opened_event(payload) end ``` -The [`add_labels_to_an_issue`](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html#add_labels_to_an_issue-instance_method) docs show you'll need to pass three arguments to this method: +[`add_labels_to_an_issue`](http://octokit.github.io/octokit.rb/Octokit/Client/Labels.html#add_labels_to_an_issue-instance_method)のドキュメントには、このメソッドに3つの引数を渡さなければならないとあります。 -* Repo (string in `"owner/name"` format) -* Issue number (integer) +* Repo (`"owner/name"`という形式のstring) +* Issue number(integer) * Labels (array) -You can parse the payload to get both the repo and the issue number. Since the label name will always be the same (`needs-response`), you can pass it as a hardcoded string in the labels array. Putting these pieces together, your updated method might look like this: +ペイロードをパースすれば、リポジトリとIssue番号を取得できます。 ラベル名は常に同じ(`needs-response`)なので、labels配列にハードコードした文字列で渡せます。 これらのピースをまとめると、更新されたメソッドは以下のようになるでしょう。 ``` ruby -# When an issue is opened, add a label +# Issueがオープンされたらラベルを追加 def handle_issue_opened_event(payload) repo = payload['repository']['full_name'] issue_number = payload['issue']['number'] @@ -180,56 +180,56 @@ def handle_issue_opened_event(payload) end ``` -Try opening a new issue in your test repository and see what happens! If nothing happens right away, try refreshing. +新しいIssueをテストのリポジトリでオープンして、何が起こるか見てみてください! もしすぐには何も起こらなければ、リフレッシュしてみてください。 -You won't see much in the Terminal, _but_ you should see that a bot user has added a label to the issue. +ターミナルにはあまり表示されませんが、_とはいえ_ボットユーザがラベルをIssueに追加したことはわかります。 {% note %} -**Note:** When GitHub Apps take actions via the API, such as adding labels, GitHub shows these actions as being performed by _bot_ accounts. For more information, see "[Machine vs. bot accounts](/apps/differences-between-apps/#machine-vs-bot-accounts)." +**ノート:** GitHub AppがAPIを介してラベルの追加といったアクションを起こした場合、GitHubはそれらのアクションを_ボット_アカウントが行ったものと示します。 詳しい情報については「[マシン対ボットアカウント](/apps/differences-between-apps/#machine-vs-bot-accounts)」を参照してください。 {% endnote %} -If so, congrats! You've successfully built a working app! 🎉 +そうなっていたら、おめでとうございます! 動作するアプリケーションの構築に成功しました! 🎉 -You can see the final code in `server.rb` in the [app template repository](https://github.com/github-developer/using-the-github-api-in-your-app). +`server.rb`の最終のコードは[アプリケーションのテンプレートリポジトリ](https://github.com/github-developer/using-the-github-api-in-your-app)にあります。 -See "[Next steps](#next-steps)" for ideas about where you can go from here. +ここから進む先に関するアイデアについては「[次のステップ](#next-steps)」を参照してください。 ### トラブルシューティング -Here are a few common problems and some suggested solutions. If you run into any other trouble, you can ask for help or advice in the {% data variables.product.prodname_support_forum_with_url %}. +以下は、いくつかの一般的な問題と推奨される解決策です。 他の問題が生じた場合は、{% data variables.product.prodname_support_forum_with_url %}で助けやアドバイスを求めることができます。 -* **Q:** My server isn't listening to events! The Smee client is running in a Terminal window, and I'm sending events on GitHub.com by opening new issues, but I don't see any output in the Terminal window where I'm running the server. +* **Q:** サーバーがイベントを待ち受けていません! Smeeクライアントはターミナルウィンドウで動作していて、新しいIssueをオープンしてGitHub.com上でイベントを送信していますが、サーバーを動作させているターミナルウィンドウに出力がありません。 - **A:** You may not have the correct Smee domain in your app settings. Visit your [app settings page](https://github.com/settings/apps) and double-check the fields shown in "[Register a new app with GitHub](/apps/quickstart-guides/setting-up-your-development-environment/#step-2-register-a-new-github-app)." Make sure the domain in those fields matches the domain you used in your `smee -u ` command in "[Start a new Smee channel](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel)." + **A:** アプリケーション設定のSmeeドメインが正しくないかもしれません。 [アプリケーション設定ページ](https://github.com/settings/apps)にアクセスし、[Register a new app with GitHub（GitHubに新しいアプリケーションを登録）](/apps/quickstart-guides/setting-up-your-development-environment/#step-2-register-a-new-github-app)にあるフィイールドをダブルチェックしてください。 それらのフィールドのドメインが、「[新しいSmeeチャンネルの開始](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel)」の`smee -u `で使ったドメインと一致していることを確認してください。 -* **Q:** My app doesn't work! I opened a new issue, but even after refreshing, no label has been added to it. +* **Q:** アプリケーションが動きません! 新しいIssueをオープンしましたが、リフレッシュしてもラベルが追加されません。 - **A:** Make sure all of the following are true: + **A:** 以下のようになっていることをすべて確認してください。 - * You [installed the app](/apps/quickstart-guides/setting-up-your-development-environment/#step-7-install-the-app-on-your-account) on the repository where you're opening the issue. - * Your [Smee client is running](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel) in a Terminal window. - * Your [web server is running](/apps/quickstart-guides/setting-up-your-development-environment/#step-6-start-the-server) with no errors in another Terminal window. - * Your app has [read & write permissions on issues and is subscribed to issue events](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel). - * You [checked your email](#step-1-update-app-permissions) after updating the permissions and accepted the new permissions. + * Issueをオープンしているリポジトリに[アプリケーションをインストールした](/apps/quickstart-guides/setting-up-your-development-environment/#step-7-install-the-app-on-your-account)こと。 + * ターミナルウィンドウで[Smeeクライアントが動作している](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel)こと。 + * 他のターミナルウィンドウで[Webサーバーが動作している](/apps/quickstart-guides/setting-up-your-development-environment/#step-6-start-the-server)こと。 + * アプリケーションが[Issueの読み書き権限を持っており、issueイベントをサブスクライブしている](/apps/quickstart-guides/setting-up-your-development-environment/#step-1-start-a-new-smee-channel)こと。 + * 権限を更新した後に[メールを確認して](#step-1-update-app-permissions)新しい権限を承認したこと。 ### おわりに -After walking through this guide, you've learned the basic building blocks for developing GitHub Apps! To review, you: +このガイドを見終えれば、GitHub Appを開発するための基本的なビルディングブロックを学んだことになります! 振り返ると、以下を行いました。 -* Programmed your app to listen for events -* Used the Octokit.rb library to do REST API operations +* イベントを待ち受けるようにアプリケーションをプログラム +* Octokit.rbライブラリを使ったREST APIの操作 ### 次のステップ -Here are some ideas for what you can do next: +以下は、次に行えることのいくつかのアイデアです。 -* [Rewrite your app using GraphQL](https://developer.github.com/changes/2018-04-30-graphql-supports-github-apps/)! -* Rewrite your app in Node.js using [Probot](https://github.com/probot/probot)! -* Have the app check whether the `needs-response` label already exists on the issue, and if not, add it. -* When the bot successfully adds the label, show a message in the Terminal. (Hint: compare the `needs-response` label ID with the ID of the label in the payload as a condition for your message, so that the message only displays when the relevant label is added and not some other label.) -* Add a landing page to your app and hook up a [Sinatra route](https://github.com/sinatra/sinatra#routes) for it. -* Move your code to a hosted server (like Heroku). Don't forget to update your app settings with the new domain. -* Share your project or get advice in the {% data variables.product.prodname_support_forum_with_url %}{% if currentVersion == "free-pro-team@latest" %} -* Have you built a shiny new app you think others might find useful? [Add it to GitHub Marketplace](/apps/marketplace/creating-and-submitting-your-app-for-approval/)!{% endif %} +* [GraphQLを使ってアプリケーションを書き直す](https://developer.github.com/changes/2018-04-30-graphql-supports-github-apps/)! +* [ Probot](https://github.com/probot/probot)を使ってNode.jsでアプリケーションを書き直す! +* アプリケーションが`needs-response`ラベルがIssueにすでに付いているかを確認して、なければ追加するようにする。 +* ボットがラベルを追加できたら、ターミナルにメッセージを表示する。 （ヒント: `needs-response`ラベルのIDをペイロード中のラベルのIDと比較してメッセージの条件とし、他のラベルではなく関連するラベルが追加されたときにのみメッセージを表示してください） +* アプリケーションにランディングページを追加し、[Sinatraのルート](https://github.com/sinatra/sinatra#routes)をそこに接続する。 +* コードをホストされたサーバー（Herokuのような）に移す。 新しいドメインでアプリケーションの設定を更新するのを忘れないようにしてください。 +* {% data variables.product.prodname_support_forum_with_url %}でプロジェクトを共有したりアドバイスをもらったりする。{% if currentVersion == "free-pro-team@latest" %} +* 他の人の役に立つかもと思うような、新しい輝くアプリケーションを構築しましたか？ [GitHub Marketplaceに追加してください](/apps/marketplace/creating-and-submitting-your-app-for-approval/)!{% endif %} diff --git a/translations/ja-JP/content/developers/github-marketplace/about-github-marketplace.md b/translations/ja-JP/content/developers/github-marketplace/about-github-marketplace.md index 962a7f114f60..5769e9435a3e 100644 --- a/translations/ja-JP/content/developers/github-marketplace/about-github-marketplace.md +++ b/translations/ja-JP/content/developers/github-marketplace/about-github-marketplace.md @@ -1,6 +1,6 @@ --- title: GitHub Marketplaceについて -intro: 'Learn about {% data variables.product.prodname_marketplace %} where you can share your apps and actions publicly with all {% data variables.product.product_name %} users.' +intro: 'アプリケーションやアクションを全{% data variables.product.product_name %}ユーザと共有できる{% data variables.product.prodname_marketplace %}について学びましょう。' redirect_from: - /apps/marketplace/getting-started/ - /marketplace/getting-started @@ -14,41 +14,41 @@ versions: {% data reusables.actions.actions-not-verified %} -To learn about publishing {% data variables.product.prodname_actions %} in {% data variables.product.prodname_marketplace %}, see "[Publishing actions in GitHub Marketplace](/actions/creating-actions/publishing-actions-in-github-marketplace)." +{% data variables.product.prodname_marketplace %}における{% data variables.product.prodname_actions %}の公開について学ぶには、 「[アクションをGitHub Marketplaceで公開する](/actions/creating-actions/publishing-actions-in-github-marketplace)」を参照してください。 ### アプリケーション -Anyone can share their apps with other users on {% data variables.product.prodname_marketplace %} but only listings that are verified by {% data variables.product.company_short %} can include paid plans. For more information, see "[About verified creators](/developers/github-marketplace/about-verified-creators)." +誰でも他のユーザと{% data variables.product.prodname_marketplace %}でアプリケーションを共有できますが、有料プランを含めることができるのは{% data variables.product.company_short %}に検証されたユーザのみです。 詳しい情報については、「[検証済みの作者について](/developers/github-marketplace/about-verified-creators)」を参照してください。 -If you're interested in creating an app for {% data variables.product.prodname_marketplace %}, but you're new to {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" or "[Building {% data variables.product.prodname_oauth_app %}s](/developers/apps/building-oauth-apps)." +{% data variables.product.prodname_marketplace %}のアプリケーション作成に関心があり、{% data variables.product.prodname_github_apps %}や{% data variables.product.prodname_oauth_app %}に慣れていない場合は、「[{% data variables.product.prodname_github_apps %}を構築する](/developers/apps/building-github-apps)」や「[{% data variables.product.prodname_oauth_app %}を構築する](/developers/apps/building-oauth-apps)」を参照してください。 -{% data reusables.marketplace.github_apps_preferred %}、{% data variables.product.prodname_marketplace %}ではOAuthと{% data variables.product.prodname_github_app %}をどちらもリストできます。 For more information, see "[Differences between {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_app %}s](/apps/differences-between-apps/)" and "[Migrating {% data variables.product.prodname_oauth_app %}s to {% data variables.product.prodname_github_apps %}](/apps/migrating-oauth-apps-to-github-apps/)." +{% data reusables.marketplace.github_apps_preferred %}、{% data variables.product.prodname_marketplace %}ではOAuthと{% data variables.product.prodname_github_app %}をどちらもリストできます。 詳しい情報については、「[{% data variables.product.prodname_github_apps %}と{% data variables.product.prodname_oauth_app %}の違い](/apps/differences-between-apps/)」および「[{% data variables.product.prodname_oauth_app %}を{% data variables.product.prodname_github_apps %}に移行する](/apps/migrating-oauth-apps-to-github-apps/)」を参照してください。 {% data variables.product.prodname_marketplace %}に関する質問がある場合は、{% data variables.contact.contact_support %}に直接お問い合わせください。 -### Publishing an app to {% data variables.product.prodname_marketplace %} +### アプリケーションを{% data variables.product.prodname_marketplace %}に公開する -When you have finished creating your app, you can share it with other users by publishing it to {% data variables.product.prodname_marketplace %}. In summary, the process is: +アプリケーションを作成したら、{% data variables.product.prodname_marketplace %}に公開して他のユーザと共有できます。 その手順を要約すると以下の通りです。 -1. Review your app carefully to ensure that it will behave as expected in other repositories and that it follows best practice guidelines. For more information, see "[Security best practices for apps](/developers/github-marketplace/security-best-practices-for-apps)" and "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app#best-practice-for-customer-experience)." +1. 他のリポジトリで期待通りに動作するよう、またベストプラクティスのガイドラインに沿うよう、アプリケーションをよく確認します。 詳しい情報については、「[アプリケーションのセキュリティにおけるベストプラクティス](/developers/github-marketplace/security-best-practices-for-apps)」および「[アプリケーションを載せるための要件](/developers/github-marketplace/requirements-for-listing-an-app#best-practice-for-customer-experience)」を参照してください。 -1. Add webhook events to the app to track user billing requests. For more information about the {% data variables.product.prodname_marketplace %} API, webhook events, and billing requests, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +1. ユーザの支払いリクエストを追跡するため、アプリケーションにwebhookイベントを追加します。 {% data variables.product.prodname_marketplace %} API、webhookイベント、および支払いリクエストの詳しい情報については、「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -1. Create a draft {% data variables.product.prodname_marketplace %} listing. For more information, see "[Drafting a listing for your app](/developers/github-marketplace/drafting-a-listing-for-your-app)." +1. ドラフトの{% data variables.product.prodname_marketplace %}リストを作成します。 詳しい情報については、「[アプリケーションのリストのドラフト](/developers/github-marketplace/drafting-a-listing-for-your-app)」を参照してください。 -1. Add a pricing plan. For more information, see "[Setting pricing plans for your listing](/developers/github-marketplace/setting-pricing-plans-for-your-listing)." +1. 価格プランを追加します。 詳しい情報については、「[リストに対する価格プランの設定](/developers/github-marketplace/setting-pricing-plans-for-your-listing)」を参照してください。 -1. Check whether your app meets the requirements for listing on {% data variables.product.prodname_marketplace %} as a free or a paid app. For more information, see "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)." +1. 無料または有料アプリケーションとして{% data variables.product.prodname_marketplace %}に掲載するための要件を満たしているかどうか確認します。 詳しい情報については、「[アプリケーションを載せるための要件](/developers/github-marketplace/requirements-for-listing-an-app)」を参照してください。 -1. Read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)." +1. 「[{% data variables.product.prodname_marketplace %}開発者同意書](/articles/github-marketplace-developer-agreement/)」の条項を読み、同意します。 -1. Submit your listing for publication in {% data variables.product.prodname_marketplace %}, requesting verification if you want to sell the app. For more information, see "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication)." +1. {% data variables.product.prodname_marketplace %}に掲載するリストをサブミットし、アプリケーションを販売したい場合は検証をリクエストします。 詳しい情報については、「[公開するリストをサブミットする](/developers/github-marketplace/submitting-your-listing-for-publication)」を参照してください。 -An onboarding expert will contact you with any questions or further steps. For example, if you have added a paid plan, you will need to complete the verification process and complete financial onboarding. As soon as your listing is approved the app is published to {% data variables.product.prodname_marketplace %}. +質問や追加の手順について、オンボーディング担当者がご連絡します。 たとえば、有料プランを追加した場合は、検証プロセスを完了し、財務的オンボーディングを完了させる必要があります。 リストが承認されると、アプリケーションはただちに{% data variables.product.prodname_marketplace %}で公開されます。 -### Seeing how your app is performing +### アプリケーションの実績を確認する -You can access metrics and transactions for your listing. 詳しい情報については、以下を参照してください。 +掲載されているアプリケーションのメトリクスや取引情報にアクセスできます。 詳しい情報については、以下を参照してください。 -- "[Viewing metrics for your listing](/developers/github-marketplace/viewing-metrics-for-your-listing)" -- "[Viewing transactions for your listing](/developers/github-marketplace/viewing-transactions-for-your-listing)" +- [リストのメトリクスの参照](/developers/github-marketplace/viewing-metrics-for-your-listing) +- [リストの取引の表示](/developers/github-marketplace/viewing-transactions-for-your-listing) diff --git a/translations/ja-JP/content/developers/github-marketplace/about-verified-creators.md b/translations/ja-JP/content/developers/github-marketplace/about-verified-creators.md index 6b550e6b19e3..67f52f5e8659 100644 --- a/translations/ja-JP/content/developers/github-marketplace/about-verified-creators.md +++ b/translations/ja-JP/content/developers/github-marketplace/about-verified-creators.md @@ -1,43 +1,43 @@ --- -title: About verified creators -intro: 'Each organization that wants to sell apps on {% data variables.product.prodname_marketplace %} must follow a verification process. Their identity is checked and their billing process reviewed.' +title: 検証済みの作者について +intro: 'アプリケーションを{% data variables.product.prodname_marketplace %}で販売したいOrganizationは、検証プロセスに従う必要があります。 検証プロセスでは、身元確認や支払いプロセスの確認を行います。' versions: free-pro-team: '*' --- -### About verified creators +### 検証済みの作者について -A verified creator is an organization that {% data variables.product.company_short %} has checked. Anyone can share their apps with other users on {% data variables.product.prodname_marketplace %} but only organizations that are verified by {% data variables.product.company_short %} can sell apps. For more information about organizations, see "[About organizations](/github/setting-up-and-managing-organizations-and-teams/about-organizations)." +検証済みの作者とは、{% data variables.product.company_short %}が確認したOrganizationのことです。 誰でも他のユーザと{% data variables.product.prodname_marketplace %}でアプリケーションを共有できますが、アプリケーションを販売できるのは{% data variables.product.company_short %}に検証されたOrganizationのみです。 Organizationに関する詳細な情報については、「[Organizationについてorganizations](/github/setting-up-and-managing-organizations-and-teams/about-organizations)」を参照してください。 -The verification process aims to protect users. For example, it verifies the seller's identity, checks that their {% data variables.product.product_name %} organization is set up securely, and that they can be contacted for support. +検証プロセスは、ユーザの保護を目的としています。 このプロセスでは、販売者の身元、{% data variables.product.product_name %} Organization が安全に設定されていること、サポートのために連絡が取れることなどを確認します。 -After passing the verification checks, any apps that the organization lists on {% data variables.product.prodname_marketplace %} are shown with a verified creator badge {% octicon "verified" aria-label="Verified creator badge" %}. The organization can now add paid plans to any of their apps. Each app with a paid plan also goes through a financial onboarding process to check that it's set up to handle billing correctly. +検証確認に合格すると、そのOrganizationが{% data variables.product.prodname_marketplace %}で掲載するすべてのアプリケーションに検証済みの作者バッジ{% octicon "verified" aria-label="Verified creator badge" %}が表示されます。 この状態になると、Organizationは有料プランを任意のアプリケーションに追加できます。 有料プランのある各アプリケーションについては、支払いの処理が正しく設定されていることを確認するため、財務オンボーディングプロセスも実施します。 -![verified creator badges](/assets/images/marketplace/marketplace_verified_creator_badges_apps.png) +![検証済み作者のバッジ](/assets/images/marketplace/marketplace_verified_creator_badges_apps.png) -In addition to the verified creator badge, you'll also see badges for unverified and verified apps. These apps were published using the old method for verifying individual apps. +検証済みの作者バッジの他に、未検証および検証済みのアプリケーションのバッジも表示されます。 これらのアプリケーションは、以前の方法を用いて、個々のアプリケーションを検証して公開されたものです。 ![検証済みの緑と未検証の灰色のバッジ](/assets/images/marketplace/marketplace_verified_badges.png) -For information on finding apps to use, see "[Searching {% data variables.product.prodname_marketplace %}](/github/searching-for-information-on-github/searching-github-marketplace)." +使用するアプリケーションの探し方に関する情報については、「[{% data variables.product.prodname_marketplace %}の検索](/github/searching-for-information-on-github/searching-github-marketplace)」を参照してください。 -### About the verification process +### 検証プロセスについて -The first time you request verification for a listing of one of your apps, you will enter the verification process. An onboarding expert will guide you through the process. This includes checking: +アプリケーションの1つのリストに関する検証を初めてリクエストすると、検証プロセスが始まります。 オンボーディングの専門家が、プロセスを案内してくれます。 これには以下のチェックが含まれます。 -- Profile information - The basic profile information is populated accurately and appropriately. -- Security - The organization has enabled two-factor authentication. -- Verified domain - The organization has verified the domain of the site URL. -- Purchase webhook event - The event is handled correctly by the app. +- プロフィール情報 - 基本的なプロフィール情報が正しく適切に展開されていること。 +- セキュリティ - Organizationが2要素認証を有効化していること。 +- 検証ドメイン - OrganizationがサイトのURLのドメインを検証していること。 +- 購入webhookイベント - イベントがアプリケーションによって正しく処理されること。 -When your organization is verified, all your apps are shown with a verified creator badge. You are now able to offer paid plans for any of your apps. +Organizationが検証されると、アプリケーションは検証済み作者のバッジ付きで表示されます。 これで、アプリケーションに有料プランを提供できるようになります。 -For more information about the requirements for listing an app on {% data variables.product.prodname_marketplace %}, see "[Requirements for listing an app on {% data variables.product.prodname_marketplace %}](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)." +{% data variables.product.prodname_marketplace %}でアプリケーションをリストするための要件に関する情報については、「[{% data variables.product.prodname_marketplace %}上にアプリケーションをリストするための要件](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)」を参照してください。 -{% data reusables.marketplace.app-transfer-to-org-for-verification %} For information on how to do this, see: "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)." +{% data reusables.marketplace.app-transfer-to-org-for-verification %} これを行う方法については「[公開のためのリストのサブミット](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)」を参照してください。 {% note %} -**Note:** This verification process for apps replaces the previous process where individual apps were verified. The current process is similar to the verification process for actions. If you have apps that were verified under the old process, these will not be affected by the changes. The {% data variables.product.prodname_marketplace %} team will contact you with details of how to migrate to organization-based verification. +**ノート:** アプリケーションのためのこの検証プロセスは、個々のアプリケーションが検証された以前のプロセスを置き換えます。 現在のプロセスは、Actionsのための検証プロセスに似ています。 旧プロセスの下で検証されたアプリケションを持っている場合、それらはこの変更には影響されません。 {% data variables.product.prodname_marketplace %}チームは、Organizationベースの検証への移行方法の詳細について、お客様に連絡します。 {% endnote %} diff --git a/translations/ja-JP/content/developers/github-marketplace/billing-customers.md b/translations/ja-JP/content/developers/github-marketplace/billing-customers.md index 1beeed54f5bb..befa428f1989 100644 --- a/translations/ja-JP/content/developers/github-marketplace/billing-customers.md +++ b/translations/ja-JP/content/developers/github-marketplace/billing-customers.md @@ -13,17 +13,17 @@ versions: ### 支払いを理解する -顧客は、アプリケーションの購入時に月次あるいは年次の支払いサイクルを選択できます。 顧客が行う支払いサイクルとプランの選択に対するすべての変更は、`marketplace_purchase`イベントを発生させます。 `marketplace_purchase` webhookのペイロードを参照すれば、顧客がどの支払いサイクルを選択したのか、そして次の支払日がいつ始まるのか（`effective_date`）を知ることができます。 For more information about webhook payloads, see "[Webhook events for the {% data variables.product.prodname_marketplace %} API](/developers/github-marketplace/webhook-events-for-the-github-marketplace-api)." +顧客は、アプリケーションの購入時に月次あるいは年次の支払いサイクルを選択できます。 顧客が行う支払いサイクルとプランの選択に対するすべての変更は、`marketplace_purchase`イベントを発生させます。 `marketplace_purchase` webhookのペイロードを参照すれば、顧客がどの支払いサイクルを選択したのか、そして次の支払日がいつ始まるのか（`effective_date`）を知ることができます。 webhookのペイロードに関する情報については、「[{% data variables.product.prodname_marketplace %} APIのwebhookイベント](/developers/github-marketplace/webhook-events-for-the-github-marketplace-api)」を参照してください。 ### アプリケーションのUIにおける支払いサービスの提供 -Customers should be able to perform the following actions from your app's website: -- Customers should be able to modify or cancel their {% data variables.product.prodname_marketplace %} plans for personal and organizational accounts separately. +アプリケーションのWebサイトからは、顧客が以下のアクションを行えなければなりません。 +- 顧客は、個人とOrganizationのアカウントで別々に{% data variables.product.prodname_marketplace %}のプランを変更したり、キャンセルしたりできなければなりません。 {% data reusables.marketplace.marketplace-billing-ui-requirements %} ### アップグレード、ダウングレード、キャンセルのための支払いサービス -明確で一貫性のある支払いプロセスを保つために、アップグレード、ダウングレード、キャンセルについて以下のガイドラインに従ってください。 For more detailed instructions about the {% data variables.product.prodname_marketplace %} purchase events, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +明確で一貫性のある支払いプロセスを保つために、アップグレード、ダウングレード、キャンセルについて以下のガイドラインに従ってください。 {% data variables.product.prodname_marketplace %}の購入イベントに関する詳細な指示については、「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 `marketplace_purchase` webhookの`effective_date`キーを使えば、プランの変更がいつ生じるのかを確認し、定期的に[プランのアカウントのリスト](/rest/reference/apps#list-accounts-for-a-plan)を同期できます。 @@ -33,7 +33,7 @@ Customers should be able to perform the following actions from your app's websit {% data reusables.marketplace.marketplace-failed-purchase-event %} -For information about building upgrade and downgrade workflows into your app, see "[Handling plan changes](/developers/github-marketplace/handling-plan-changes)." +アプリケーションでのアップグレード及びダウングレードワークフローの構築に関する情報については、「[プラン変更の処理](/developers/github-marketplace/handling-plan-changes)」を参照してください。 #### ダウングレードとキャンセル @@ -45,4 +45,4 @@ For information about building upgrade and downgrade workflows into your app, se {% data reusables.marketplace.cancellation-clarification %} - 顧客が後でプランを継続したくなった場合には、GitHubを通じてプランをアップグレードできるようにします。 -For information about building cancellation workflows into your app, see "[Handling plan cancellations](/developers/github-marketplace/handling-plan-cancellations)." +アプリケーションでのキャンセルのワークフローの構築に関する情報については、「[プランのキャンセルの処理](/developers/github-marketplace/handling-plan-cancellations)」を参照してください。 diff --git a/translations/ja-JP/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/ja-JP/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index 22a14d8619e6..2035e11f5525 100644 --- a/translations/ja-JP/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/ja-JP/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -4,6 +4,5 @@ intro: '{% data variables.product.prodname_marketplace %}で利用する、開 mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/ja-JP/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md b/translations/ja-JP/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md index 4107fa4427f4..00130c6e0316 100644 --- a/translations/ja-JP/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md +++ b/translations/ja-JP/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md @@ -1,20 +1,20 @@ --- -title: Customer experience best practices for apps -intro: 'Guidelines for creating an app that will be easy to use and understand.' -shortTitle: Customer experience best practice +title: アプリケーションの顧客体験のベストプラクティス +intro: '使いやすく、分かりやすいアプリケーションを作成するためのガイドライン。' +shortTitle: 顧客体験のベストプラクティス versions: free-pro-team: '*' --- -If you follow these best practices it will help you to provide a good customer experience. +以下のベストプラクティスに従えば、優れた顧客体験を提供するための役に立つでしょう。 -### Customer communication +### 顧客とのコミュニケーション -- Marketing materials for the app should accurately represent the app's behavior. -- Apps should include links to user-facing documentation that describe how to set up and use the app. -- Customers should be able to see what type of plan they have in the billing, profile, or account settings section of the app. -- Customers should be able to install and use your app on both a personal account and an organization account. They should be able to view and manage the app on those accounts separately. +- アプリケーションのためのマーケティング資料は、アプリケーションの動作を正確に表現していなければなりません。 +- アプリケーションは、アプリケーションのセットアップと利用の方法を述べたユーザ向けのドキュメンテーションへのリンクを含まなければなりません。 +- 顧客はアプリケーションの支払い、プロフィール、アカウント設定のセクションで、どういったプランがあるのかを見ることができなければなりません。 +- 顧客は個人アカウントとOrganizationアカウントの両方でアプリケーションをインストールして利用できなければなりません。 顧客はそれらのアカウントで、別々にアプリケーションを見て管理できなければなりません。 -### Plan management +### プランの管理 {% data reusables.marketplace.marketplace-billing-ui-requirements %} 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 0921fa228c7a..b2a1e030e022 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 @@ -60,8 +60,8 @@ versions: ### アプリケーションのサブミット -{% data variables.product.prodname_marketplace %}リストが完成したら、**Overview（概要）**ページからレビューのためにリストをサブミットできます。 「[{% data variables.product.prodname_marketplace %}の開発者契約](/articles/github-marketplace-developer-agreement/)」を読んで同意しなければなりません。続いて**Submit for review（レビューのためにサブミット）**をクリックできます。 After you submit your app for review, an onboarding expert will contact you with additional information about the onboarding process. オンボーディングとセキュリティレビューのプロセスに関する詳細については「[{% data variables.product.prodname_marketplace %}を使い始める](/marketplace/getting-started/)」を参照してください。 +{% data variables.product.prodname_marketplace %}リストが完成したら、**Overview（概要）**ページからレビューのためにリストをサブミットできます。 「[{% data variables.product.prodname_marketplace %}の開発者契約](/articles/github-marketplace-developer-agreement/)」を読んで同意しなければなりません。続いて**Submit for review（レビューのためにサブミット）**をクリックできます。 レビューのためにアプリケーションをサブミットした後、のオンボーディングの専門家から、オンボーディングのプロセスに関する追加情報と併せて連絡が来ます。 オンボーディングとセキュリティレビューのプロセスに関する詳細については「[{% data variables.product.prodname_marketplace %}を使い始める](/marketplace/getting-started/)」を参照してください。 ### {% data variables.product.prodname_marketplace %}リストの削除 -If you no longer want to list your app in {% data variables.product.prodname_marketplace %}, contact {% data variables.contact.contact_support %} to remove your listing. +アプリケーションを{% data variables.product.prodname_marketplace %}のリストに載せたくなくなったなら、リストを削除するために{% data variables.contact.contact_support %}に連絡してください。 diff --git a/translations/ja-JP/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md b/translations/ja-JP/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md index ac9edbac20f4..99cbf9b735bf 100644 --- a/translations/ja-JP/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md +++ b/translations/ja-JP/content/developers/github-marketplace/handling-new-purchases-and-free-trials.md @@ -28,7 +28,7 @@ versions: `marketplace_purchase` webhookから`effective_date`と`marketplace_purchase`を読み取り、顧客が購入したプラン、支払いサイクルの開始時点、次の支払いサイクルの開始時点を判断してください。 -アプリケーションが無料トライアルを提供しているなら、webhookから`marketplace_purchase[on_free_trial]`属性を読んでください。 この値が`true`なら、アプリケーションは無料トライアルの開始日(`effective_date`)と、無料トライアルの終了日(`free_trial_ends_on`)を追跡しなければなりません。 アプリケーションのUIに無料トライアルの残日数を表示するのには、`free_trial_ends_on`の日付を使ってください。 これはバナーか、[支払いUI](/marketplace/selling-your-app/billing-customers-in-github-marketplace/#providing-billing-services-in-your-apps-ui)のいずれでも行えます。 To learn how to handle cancellations before a free trial ends, see "[Handling plan cancellations](/developers/github-marketplace/handling-plan-cancellations)." See "[Handling plan changes](/developers/github-marketplace/handling-plan-changes)" to find out how to transition a free trial to a paid plan when a free trial expires. +アプリケーションが無料トライアルを提供しているなら、webhookから`marketplace_purchase[on_free_trial]`属性を読んでください。 この値が`true`なら、アプリケーションは無料トライアルの開始日(`effective_date`)と、無料トライアルの終了日(`free_trial_ends_on`)を追跡しなければなりません。 アプリケーションのUIに無料トライアルの残日数を表示するのには、`free_trial_ends_on`の日付を使ってください。 これはバナーか、[支払いUI](/marketplace/selling-your-app/billing-customers-in-github-marketplace/#providing-billing-services-in-your-apps-ui)のいずれでも行えます。 無料トライアルの終了前のキャンセルの処理方法を学ぶには、「[プランのキャンセルの処理](/developers/github-marketplace/handling-plan-cancellations)」を参照してください。 無料トライアルの終了時点での無料トライアルから有料プランへの移行方法を知るには、「[プランの変更の処理](/developers/github-marketplace/handling-plan-changes)」を参照してください。 `marketplace_purchase`イベントペイロードの例については「[{% data variables.product.prodname_marketplace %} webhookイベント](/marketplace/integrating-with-the-github-marketplace-api/github-marketplace-webhook-events/)」を参照してください。 diff --git a/translations/ja-JP/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/ja-JP/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index 5761c00a224e..268f6840ef1d 100644 --- a/translations/ja-JP/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/ja-JP/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -10,9 +10,9 @@ versions: -{% data variables.product.prodname_marketplace %} pricing plans can be free, flat rate, or per-unit. Prices are set, displayed, and processed in US dollars. Paid plans are restricted to verified listings. +{% data variables.product.prodname_marketplace %}の価格プランは、無料、定額料金、ユニット単位にできます。 価格は米ドルで設定、表示、処理されます。 有料プランは、検証済みのリストに限られます。 -Customers purchase your app using a payment method attached to their {% data variables.product.product_name %} account, without having to leave {% data variables.product.prodname_dotcom_the_website %}. You don't have to write code to perform billing transactions, but you will have to handle events from the {% data variables.product.prodname_marketplace %} API. For more information, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +顧客は{% data variables.product.prodname_dotcom_the_website %}を離れることなく、{% data variables.product.product_name %}アカウントに添付された支払い方法を使ってアプリケーションを購入します。 支払いトランザクションを実行するためにコードを書く必要はありませんが、{% data variables.product.prodname_marketplace %} APIからのイベントは処理しなければなりません。 詳しい情報については「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 {% data variables.product.prodname_marketplace %}上でリストしているアプリケーションが複数のプランのオプションを持っているなら、対応する価格プランをセットアップできます。 たとえばアプリケーションが2つのプランの選択肢としてオープンソースプランとプロプランを持っているなら、オープンソースプランに対して無料価格プランを、そしてプロプランに対して定額料金プランをセットアップできます。 それぞれの{% data variables.product.prodname_marketplace %}リストには、リストされたすべてのプランに対して年間及び月間の価格がなければなりません。 @@ -22,33 +22,33 @@ Customers purchase your app using a payment method attached to their {% data var ### 価格プランの種類 -#### Free pricing plans +#### 無料プラン {% data reusables.marketplace.free-apps-encouraged %} -Free plans are completely free for users. 無料プランをセットアップした場合、アプリケーションを利用するために無料プランを選択したユーザに課金することはできません。 リストでは無料と有料のプランをどちらも作成できます。 +無料プランは、ユーザに対してまったく無料です。 無料プランをセットアップした場合、アプリケーションを利用するために無料プランを選択したユーザに課金することはできません。 リストでは無料と有料のプランをどちらも作成できます。 -All apps need to handle events for new purchases and cancellations. Apps that only have free plans do not need to handle events for free trials, upgrades, and downgrades. For more information, see: "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +すべてのアプリケーションは、新規の購入とキャンセルのイベントを処理しなければなりません。 無料プランだけを持つアプリケーションは、無料トライアル、アップグレード、ダウングレードのイベントを処理する必要はありません。 詳しい情報については「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -If you add a paid plan to an app that you've already listed in {% data variables.product.prodname_marketplace %} as a free service, you'll need to request verification for the app and go through financial onboarding. +{% data variables.product.prodname_marketplace %}に無料のサービスとしてリスト済みのアプリケーションに有料プランを追加する場合、アプリケーションの検証をリクエストし、金銭のオンボーディングを通さなければなりません。 -#### Paid pricing plans +#### 有料プラン -There are two types of paid pricing plan: +有料プランには2つの種類があります。 -- Flat rate pricing plans charge a set fee on a monthly and yearly basis. +- 定額プランは、月単位及び年単位で設定された料金を課金します。 -- Per-unit pricing plans charge a set fee on either a monthly or yearly basis for a unit that you specify. 「ユニット」には好きなもの（たとえばユーザ、シート、あるいは人）を指定できます。 +- ユニット単位の価格プランは、月単位あるいは年単位で、指定したユニットに基づいて設定された料金を課金します。 「ユニット」には好きなもの（たとえばユーザ、シート、あるいは人）を指定できます。 -You may also want to offer free trials. These provide free, 14-day trials of OAuth or GitHub Apps to customers. When you set up a Marketplace pricing plan, you can select the option to provide a free trial for flat-rate or per-unit pricing plans. +無料トライアルを提供したいこともあるでしょう。 無料トライアルは、OAuthもしくはGitHub Appsを無料の14日間のトライアルとして顧客に提供します。 Marketplaceの価格プランをセットアップする際に、定額あるいはユニット単位の価格プランに対する無料トライアルを提供するオプションを選択できます。 ### 無料トライアル -Customers can start a free trial for any paid plan on a Marketplace listing that includes free trials. However, customers cannot create more than one free trial per marketplace product. +顧客は、無料トライアルを含むMarketplaceリスト上の任意の有料プランに対して、無料トライアルを開始できます。 ただし、顧客はMarketplaceの製品ごとに複数の無料トライアルを作成することはできません。 無料トライアルの期間は固定の14日間です。 顧客はトライアル期間の終了の4日前（無料トライアルの11日目）に、プランがアップグレードされるという通知を受け取ります。 顧客は、キャンセルしないかぎり、無料トライアルの終わりにトライアルを行っていたプランに自動的に登録されます。 -For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)." +詳しい情報については「[新規の購入と無料トライアルの処理](/developers/github-marketplace/handling-new-purchases-and-free-trials/)」を参照してください。 {% note %} diff --git a/translations/ja-JP/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/ja-JP/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index 87b9392e1233..8f76f1f89c0f 100644 --- a/translations/ja-JP/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/ja-JP/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -13,8 +13,14 @@ versions: -{% data variables.product.prodname_marketplace %}のリストが作成され、承認されたあと、オンボーディングプロセスの一環として{% data variables.product.product_name %}への支払いの詳細を提供します。 +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -1ヶ月の収益が$500米ドルに達すると、 {% data variables.product.product_name %}から販売価格の75%の電子支払いを受け取ります。 +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/ja-JP/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/ja-JP/content/developers/github-marketplace/requirements-for-listing-an-app.md index fa8fb924d200..0251e8c7850b 100644 --- a/translations/ja-JP/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/ja-JP/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -1,6 +1,6 @@ --- title: アプリケーションのリストのための要件 -intro: 'Apps on {% data variables.product.prodname_marketplace %} must meet the requirements outlined on this page before the listing can be published.' +intro: '{% data variables.product.prodname_marketplace %}上のアプリケーションは、リストを公開する前にこのページに概要がある要件を満たさなければなりません。' redirect_from: - /apps/adding-integrations/listing-apps-on-github-marketplace/requirements-for-listing-an-app-on-github-marketplace/ - /apps/marketplace/listing-apps-on-github-marketplace/requirements-for-listing-an-app-on-github-marketplace/ @@ -14,60 +14,60 @@ versions: -The requirements for listing an app on {% data variables.product.prodname_marketplace %} vary according to whether you want to offer a free or a paid app. +{% data variables.product.prodname_marketplace %}上にアプリケーションをリストするための要件は、提供するのが無料なのか有料アプリケーションなのかによって変わります。 -### Requirements for all {% data variables.product.prodname_marketplace %} listings +### すべての{% data variables.product.prodname_marketplace %}リストの要件 -All listings on {% data variables.product.prodname_marketplace %} should be for tools that provide value to the {% data variables.product.product_name %} community. When you submit your listing for publication, you must read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)." +{% data variables.product.prodname_marketplace %}上のすべてのリストは、{% data variables.product.product_name %}コミュニティに価値を提供するツールのためのものでなければなりません。 公開のためにリストをサブミットする際には、[{% data variables.product.prodname_marketplace %}開発者契約](/articles/github-marketplace-developer-agreement/)の条項を読んで同意しなければなりません。 -#### User experience requirements for all apps +#### すべてのアプリケーションに対するユーザ体験の要件 -All listings should meet the following requirements, regardless of whether they are for a free or paid app. +すべてのリストは、無料のアプリケーションのためのものか、有料アプリケーションのためのものであるかにかかわらず、以下の要件を満たさなければなりません。 -- Listings must not actively persuade users away from {% data variables.product.product_name %}. -- Listings must include valid contact information for the publisher. -- Listings must have a relevant description of the application. -- Listings must specify a pricing plan. +- リストはユーザを積極的に{% data variables.product.product_name %}から離れさせようとしてはなりません。 +- リストは、パブリッシャーの有効な連絡先の情報を含んでいなければなりません。 +- リストには、アプリケーションの適切な説明がなければなりません。 +- リストは価格プランを指定しなければなりません。 - アプリケーションは顧客に価値を提供し、認証以外の方法でプラットフォームと統合されていなければなりません - アプリケーションケーションは{% data variables.product.prodname_marketplace %}で公開されなければならず、ベータや招待のみでの利用であってはなりません。 -- Apps must have webhook events set up to notify the publisher of any plan changes or cancellations using the {% data variables.product.prodname_marketplace %} API. For more information, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +- アプリケーションは、{% data variables.product.prodname_marketplace %} APIを使ってプランの変更やキャンセルがあったことをパブリッシャーに知らせるために、webhookイベントがセットアップされていなければなりません。 詳しい情報については「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -For more information on providing a good customer experience, see "[Customer experience best practices for apps](/developers/github-marketplace/customer-experience-best-practices-for-apps)." +優れた顧客体験を提供することに関する詳細な情報については、「[アプリケーションの顧客体験のベストプラクティス](/developers/github-marketplace/customer-experience-best-practices-for-apps)」を参照してください。 -#### Brand and listing requirements for all apps +#### すべてのアプリケーションに対するブランドとリストの要件 -- Apps that use GitHub logos must follow the {% data variables.product.company_short %} guidelines. For more information, see "[{% data variables.product.company_short %} Logos and Usage](https://github.com/logos)." +- GitHubのログを使用するアプリケーションは、{% data variables.product.company_short %}ガイドラインに従わなければなりません。 詳しい情報については「[{% data variables.product.company_short %}ロゴと利用](https://github.com/logos)」を参照してください。 - アプリケーションは、「[{% data variables.product.prodname_marketplace %}リストの説明の作成](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/)」にある推奨事項を満たすロゴ、機能カード、スクリーンショット画像を持っていなければなりません。 - リストには、十分に書かれた文法上の誤りがない説明が含まれていなければなりません。 リストの作成のガイダンスとしては、「[{% data variables.product.prodname_marketplace %}リストの説明の作成](/marketplace/listing-on-github-marketplace/writing-github-marketplace-listing-descriptions/)」を参照してください。 -To protect your customers, we recommend that you also follow security best practices. For more information, see "[Security best practices for apps](/developers/github-marketplace/security-best-practices-for-apps)." +顧客を保護するために、セキュリティのベストプラクティスにも従うことをおすすめします。 詳しい情報については「[アプリケーションのセキュリティのベストプラクティス](/developers/github-marketplace/security-best-practices-for-apps)」を参照してください。 -### Considerations for free apps +### 無料アプリケーションに関する留意点 {% data reusables.marketplace.free-apps-encouraged %} -### Requirements for paid apps +### 有料アプリケーションの要件 -In addition to the requirements for all apps above, each app that you offer as a paid service on {% data variables.product.prodname_marketplace %} must also meet the following requirements: +上記のすべてのアプリケーションに関する要件に加え、{% data variables.product.prodname_marketplace %}上で有料サービスとして提供するアプリケーションは、以下の要件も満たさなければなりません。 - {% data variables.product.prodname_github_app %}は、最低でも100個のインストールが必要です。 - {% data variables.product.prodname_oauth_app %}は最低200ユーザが必要です。 -- All paid apps must handle {% data variables.product.prodname_marketplace %} purchase events for new purchases, upgrades, downgrades, cancellations, and free trials. For more information, see "[Billing requirements for paid apps](#billing-requirements-for-paid-apps)" below. -- Publishing organizations must have a verified domain and must enable two-factor authentication. 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.") +- すべての有料アプリケーションは、新規購入、アップグレード、ダウングレード、キャンセル、無料トライアルの{% data variables.product.prodname_marketplace %}購入イベントを処理できなければなりません。 詳しい情報については、以下の「[有料アプリケーションの支払い要件](#billing-requirements-for-paid-apps)」を参照してください。 +- 公開するOrganizationは、検証済みドメインを持っていなければならず、2要素認証を有効化しなければなりません。 詳しい情報については [Organization で 2 要素認証を要求する](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)を参照してください。 -When you are ready to publish the app on {% data variables.product.prodname_marketplace %} you must request verification for the listing. +アプリケーションを{% data variables.product.prodname_marketplace %}上で公開する準備ができたら、リストのための検証をリクエストしなければなりません。 {% note %} -The verification process is open to organizations. {% data reusables.marketplace.app-transfer-to-org-for-verification %} For information on how to do this, see: "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)." +検証プロセスは、Organizationに対して開かれています。 {% data reusables.marketplace.app-transfer-to-org-for-verification %} これを行う方法については「[公開のためのリストのサブミット](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)」を参照してください。 {% endnote %} -### Billing requirements for paid apps +### 有料アプリケーションの支払い要件 -Your app does not need to handle payments but does need to use {% data variables.product.prodname_marketplace %} purchase events to manage new purchases, upgrades, downgrades, cancellations, and free trials. For information about how integrate these events into your app, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +アプリケーションは支払いを処理する必要はありませんが、{% data variables.product.prodname_marketplace %}購入イベントを使って新規の購入、アップグレード、ダウングレード、キャンセル、無料トライアルを管理できなければなりません。 これらのイベントをアプリケーションに統合する方法については、「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -Using GitHub's billing API allows customers to purchase an app without leaving GitHub and to pay for the service with the payment method already attached to their {% data variables.product.product_name %} account. +GitHubの支払いAPIを使えば、顧客はGitHubを離れることなくアプリケーションを購入し、自分の{% data variables.product.product_name %}アカウントにすでに結合されている支払い方法でサービスに対する支払いを行えます。 - アプリケーションは、有料のサブスクリプションの購入について、月次及び年次の支払いをサポートしなければなりません。 - リストは、無料及び有料プランの任意の組み合わせを提供できます。 無料プランはオプションですが、推奨されます。 詳しい情報については「[{% data variables.product.prodname_marketplace %}リストの価格プランの設定](/marketplace/listing-on-github-marketplace/setting-a-github-marketplace-listing-s-pricing-plan/)」を参照してください。 diff --git a/translations/ja-JP/content/developers/github-marketplace/security-best-practices-for-apps.md b/translations/ja-JP/content/developers/github-marketplace/security-best-practices-for-apps.md index 69965cb611ca..645c1560359a 100644 --- a/translations/ja-JP/content/developers/github-marketplace/security-best-practices-for-apps.md +++ b/translations/ja-JP/content/developers/github-marketplace/security-best-practices-for-apps.md @@ -1,42 +1,42 @@ --- -title: Security best practices for apps -intro: 'Guidelines for preparing a secure app to share on {% data variables.product.prodname_marketplace %}.' +title: アプリケーションのセキュリティベストプラクティス +intro: '{% data variables.product.prodname_marketplace %}上でセキュアなアプリケーションを共有する準備のガイドライン' redirect_from: - /apps/marketplace/getting-started/security-review-process/ - /marketplace/getting-started/security-review-process - /developers/github-marketplace/security-review-process-for-submitted-apps -shortTitle: Security best practice +shortTitle: セキュリティベストプラクティス versions: free-pro-team: '*' --- -If you follow these best practices it will help you to provide a secure user experience. +以下のベストプラクティスに従えば、セキュアなユーザ体験を提供するための役に立つでしょう。 ### 認可、認証、アクセスコントロール -We recommend creating a GitHub App rather than an OAuth App. {% data reusables.marketplace.github_apps_preferred %}. 詳細については、「[GitHub AppsとOAuth Appsの違い](/apps/differences-between-apps/)」を参照してください。 -- Apps should use the principle of least privilege and should only request the OAuth scopes and GitHub App permissions that the app needs to perform its intended functionality. For more information, see [Principle of least privilege](https://en.wikipedia.org/wiki/Principle_of_least_privilege) in Wikipedia. -- Apps should provide customers with a way to delete their account, without having to email or call a support person. +OAuth AppよりもGitHub Appを作成することをおすすめします。 {% data reusables.marketplace.github_apps_preferred %}. 詳細については、「[GitHub AppsとOAuth Appsの違い](/apps/differences-between-apps/)」を参照してください。 +- アプリケーションは、最小権限の原則を用い、アプリケーションが意図された機能を実行するために必要なOAuthのスコープとGitHub Appの権限だけをリクエストすべきです。 詳しい情報については、Wikipediaで[最小権限の原則](https://ja.wikipedia.org/wiki/最小権限の原則)を参照してください。 +- アプリケーションは、サポート担当者にメールや連絡をすることなく、顧客が自分のアカウントを削除する方法を提供しなければなりません。 - アプリケーションは、異なる実装間でトークンを共有してはなりません。 たとえば、デスクトップのアプリケーションはWebベースのアプリケーションとは別のトークンを持つべきです。 個々のトークンを使うことで、それぞれのアプリケーションはGitHubのリソースに必要なアクセスを個別にリクエストできます。 - ユーザの種類に応じて求められる機能によって、様々なユーザのロールを持たせてアプリケーションを設計してください。 たとえば、標準的なユーザは管理機能を利用できるべきではなく、支払いマネージャーはリポジトリのコードにプッシュアクセスできるべきではありません。 -- Apps should not share service accounts such as email or database services to manage your SaaS service. +- アプリケーションは、SaaSサービスを管理するためのメールやデータベースサービスのようなサービスアカウントを共有するべきではありません。 - アプリケーションで使用されるすべてのサービスは、固有のログインとパスワードクレデンシャルを持たなければなりません。 - プロダクションのホスティングインフラストラクチャへの管理権限でのアクセスは、管理業務を持つエンジニアや従業員にのみ与えられるべきです。 -- Apps should not use personal access tokens to authenticate and should authenticate as an [OAuth App](/apps/about-apps/#about-oauth-apps) or a [GitHub App](/apps/about-apps/#about-github-apps): - - OAuth Apps should authenticate using an [OAuth token](/apps/building-oauth-apps/authorizing-oauth-apps/). - - GitHub Apps should authenticate using either a [JSON Web Token (JWT)](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app), [OAuth token](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/), or [installation access token](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation). +- アプリケーションは、認証に個人アクセストークンを使うべきではなく、[OAuth App](/apps/about-apps/#about-oauth-apps)あるいは[GitHub App](/apps/about-apps/#about-github-apps)として認証されなければなりません。 + - OAuth Appsは、[OAuthトークン](/apps/building-oauth-apps/authorizing-oauth-apps/)を使って認証を受けるべきです。 + - GitHub Appは、[JSON Webトークン (JWT)](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)、[OAuthトークン](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/)、[インストールアクセストークン](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)のいずれかで認証を受けるべきです。 ### データの保護 -- Apps should encrypt data transferred over the public internet using HTTPS, with a valid TLS certificate, or SSH for Git. -- Apps should store client ID and client secret keys securely. それらは[環境変数](http://en.wikipedia.org/wiki/Environment_variable#Getting_and_setting_environment_variables)に保存することをおすすめします。 -- Apps should delete all GitHub user data within 30 days of receiving a request from the user, or within 30 days of the end of the user's legal relationship with GitHub. -- Apps should not require the user to provide their GitHub password. +- アプリケーションは、パブリックなインターネット上で転送されるデータを、有効なTLS証明書を用いたHTTPSもしくはSSH for Gitで暗号化すべきです。 +- アプリケーションは、クライアントIDとクライアントシークレットキーをセキュアに保存すべきです。 それらは[環境変数](http://en.wikipedia.org/wiki/Environment_variable#Getting_and_setting_environment_variables)に保存することをおすすめします。 +- アプリケーションは、ユーザからの要求を受けてから30日以内、あるいはユーザのGitHubとの法的な関係が終了してから30日以内に、すべてのGitHubユーザデータを削除すべきです。 +- アプリケーションは、ユーザにGitHubパスワードの提供を求めるべきではありません。 - アプリケーションは、トークン、クライアントID、クライアントシークレットを暗号化すべきです。 ### ロギング及びモニタリング -Apps should have logging and monitoring capabilities. App logs should be retained for at least 30 days and archived for at least one year. セキュリティログは以下を含まなければなりません。 +アプリケーションは、ロギング及びモニタリングの機能を持つべきです。 アプリケーションのログは最低でも30日間保存され、最低でも1年間アーカイブされるべきです。 セキュリティログは以下を含まなければなりません。 - 認証及び認可イベント - サービス設定の変更 @@ -48,12 +48,12 @@ Apps should have logging and monitoring capabilities. App logs should be retaine ### インシデントレスポンスのワークフロー -To provide a secure experience for users, you should have a clear incident response plan in place before listing your app. サードパーティのベンダを利用するよりは、自社内にセキュリティ及び運用インシデントレスポンスチームを持つことをおすすめします。 You should have the capability to notify {% data variables.product.product_name %} within 24 hours of a confirmed incident. +ユーザのセキュアな体験を提供するためには、アプリケーションをリストする前に明確なインシデントレスポンスプランを用意しておくべきです。 サードパーティのベンダを利用するよりは、自社内にセキュリティ及び運用インシデントレスポンスチームを持つことをおすすめします。 インシデントの確認から24時間以内に{% data variables.product.product_name %}に通知する機能を持っていなければなりません。 -For an example of an incident response workflow, see the "Data Breach Response Policy" on the [SANS Institute website](https://www.sans.org/information-security-policy/). A short document with clear steps to take in the event of an incident is more valuable than a lengthy policy template. +インシデントレスポンスのワークフローの例としては、[SANS Institute website](https://www.sans.org/information-security-policy/)の"Data Breach Response Policy"を参照してください。 インシデントが生じた際に取るべき明確なステップを記した短いドキュメントは、長いポリシーテンプレートよりも価値があります。 ### 脆弱性管理とパッチ適用ワークフロー プロダクションインフラストラクチャーの定期的な脆弱性スキャンを行わなければなりません。 脆弱性スキャンの結果をトリアージし、脆弱性の修正までの期間を定義して同意しなければなりません。 -If you are not ready to set up a full vulnerability management program, it's useful to start by creating a patching process. For guidance in creating a patch management policy, see this TechRepublic article "[Establish a patch management policy](https://www.techrepublic.com/blog/it-security/establish-a-patch-management-policy-87756/)." +完全な脆弱性管理のプログラムをセットアップする準備ができていない場合は、パッチ適用のプロセスを作成することから始めると役立ちます。 パッチ管理ポリシーを作成するためのガイダンスとしては、TechRepublicの記事「[Establish a patch management policy](https://www.techrepublic.com/blog/it-security/establish-a-patch-management-policy-87756/)」を参照してください。 diff --git a/translations/ja-JP/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md b/translations/ja-JP/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md index 3f3d779875c6..475644e02dba 100644 --- a/translations/ja-JP/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md +++ b/translations/ja-JP/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md @@ -1,6 +1,6 @@ --- title: リストに対する価格プランの設定 -intro: 'When you list your app on {% data variables.product.prodname_marketplace %}, you can choose to provide your app as a free service or sell your app. アプリケーションを販売することを計画するなら、様々な機能レベルに対して異なる価格プランを作成できます。' +intro: 'アプリケーションを{% data variables.product.prodname_marketplace %}上でリストする際に、アプリケーションを無料のサービスとして提供するか、アプリケーションを販売するかを選択できます。 アプリケーションを販売することを計画するなら、様々な機能レベルに対して異なる価格プランを作成できます。' redirect_from: - /apps/adding-integrations/managing-pricing-and-payments-for-a-github-marketplace-listing/setting-a-github-marketplace-listing-s-pricing-plan/ - /apps/marketplace/managing-pricing-and-payments-for-a-github-marketplace-listing/setting-a-github-marketplace-listing-s-pricing-plan/ @@ -17,52 +17,52 @@ versions: free-pro-team: '*' --- -### About setting pricing plans +### 価格プランの設定について -If you want to sell an app on {% data variables.product.prodname_marketplace %}, you need to request verification when you publish the listing for your app. During the verification process, an onboarding expert checks the organization's identity and security settings. The onboarding expert will also take the organization through financial onboarding. For more information, see: "[Requirements for listing an app on {% data variables.product.prodname_marketplace %}](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)." +アプリケーションを{% data variables.product.prodname_marketplace %}で販売したい場合は、アプリケーションのリストを公開する際に検証をリクエストしなければなりません。 検証プロセスの過程で、オンボーディングの専門家がOrganizationのアイデンティティとセキュリティの設定をチェックします。 オンボーディングの専門家は、Organizationに財務的なオンボーディングも受けさせます。 詳しい情報については、「[{% data variables.product.prodname_marketplace %}にアプリケーションをリストするための要件](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)」を参照してください。 -{% data reusables.marketplace.app-transfer-to-org-for-verification %} For information on how to do this, see: "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)." +{% data reusables.marketplace.app-transfer-to-org-for-verification %} これを行う方法については「[公開のためのリストのサブミット](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)」を参照してください。 -{% data variables.product.prodname_marketplace %} offers several different types of pricing plan. For detailed information, see "[Pricing plans for {% data variables.product.prodname_marketplace %}](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)." +{% data variables.product.prodname_marketplace %}は、いくつかの種類の価格プランを提供します。 詳細にな情報については「[{% data variables.product.prodname_marketplace %}の価格プラン](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)」を参照してください。 -### About saving pricing plans +### 価格プランの保存について -You can save pricing plans in a draft or published state. If you haven't submitted your {% data variables.product.prodname_marketplace %} listing for approval, a published plan will function in the same way as a draft plan until your listing is approved and shown on {% data variables.product.prodname_marketplace %}. Draft plans allow you to create and save new pricing plans without making them available on your {% data variables.product.prodname_marketplace %} listing page. Once you publish a pricing plan on a published listing, it's available for customers to purchase immediately. 最大で10の価格プランを公開できます。 +価格プランは、ドラフトもしくは公開状態で保存できます。 {% data variables.product.prodname_marketplace %}リストを承認のためにサブミットしていないなら、リストが承認されるまでは公開されたプランはドラフトのプランと同じように機能し、{% data variables.product.prodname_marketplace %}上に表示されます。 ドラフトプランを利用すると、新しい価格プランを{% data variables.product.prodname_marketplace %}リストページ上で利用できるようにすることなく作成し、保存できます。 公開リスト上で価格プランを公開すると、顧客はすぐにそれを利用して購入できるようになります。 最大で10の価格プランを公開できます。 -For guidelines on billing customers, see "[Billing customers](/developers/github-marketplace/billing-customers)." +顧客への課金のガイドラインについては、「[顧客への課金](/developers/github-marketplace/billing-customers)」を参照してください。 ### 価格プランの作成 -{% data variables.product.prodname_marketplace %}リストの価格プランを作成するには、[{% data variables.product.prodname_marketplace %}リストページ](https://github.com/marketplace/manage)の左のサイドバーで**Plans and pricing（プラント価格）**をクリックしてください。 For more information, see "[Creating a draft {% data variables.product.prodname_marketplace %} listing](/marketplace/listing-on-github-marketplace/creating-a-draft-github-marketplace-listing/)." +{% data variables.product.prodname_marketplace %}リストの価格プランを作成するには、[{% data variables.product.prodname_marketplace %}リストページ](https://github.com/marketplace/manage)の左のサイドバーで**Plans and pricing（プランと価格）**をクリックしてください。 詳しい情報については「[ドラフトの{% data variables.product.prodname_marketplace %}リストの作成](/marketplace/listing-on-github-marketplace/creating-a-draft-github-marketplace-listing/)」を参照してください。 **New draft plan（新規ドラフトプラン）**をクリックすると、価格プランをカスタマイズできるフォームが表示されます。 価格プランを作成するには、以下のフィールドを設定しなければなりません。 -- **Plan name** - Your pricing plan's name will appear on your {% data variables.product.prodname_marketplace %} app's landing page. You can customize the name of your pricing plan to align with the plan's resources, the size of the company that will use the plan, or anything you'd like. +- **Plan name（プラン名）** - プラン名は、{% data variables.product.prodname_marketplace %}アプリケーションのランディングページに表示されます。 価格名はカスタマイズして、プランのリソース、そのプランを利用する企業の規模、あるいはその他好きなことにあわせることができます。 -- **Pricing models** - There are three types of pricing plan: free, flat-rate, and per-unit. All plans require you to process new purchase and cancellation events from the marketplace API. In addition, for paid plans: +- **Pricing models（価格モデル）** - 価格モデルには、無料、定額、ユニット単位の3種類があります。 すべてのプランで、Marketplace APIからの新規の購入とキャンセルの処理が必要になります。 加えて、有料プランでは以下が必要です。 - - You must set a price for both monthly and yearly subscriptions in US dollars. - - Your app must process plan change events. - - You must request verification to publish a listing with a paid plan. + - 月単位及び年単位でのサブスクリプションの価格を米ドルで設定しなければなりません。 + - アプリケーションはプランの変更イベントを処理しなければなりません。 + - 有料プランを持つリストを公開するには、検証をリクエストしなければなりません。 - {% data reusables.marketplace.marketplace-pricing-free-trials %} - For detailed information, see "[Pricing plans for {% data variables.product.prodname_marketplace %} apps](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)" and "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." + 詳細な情報については、「[{% data variables.product.prodname_marketplace %}アプリケーションの価格プラン](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)」及び「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -- **Available for** - {% data variables.product.prodname_marketplace %} pricing plans can apply to **Personal and organization accounts**, **Personal accounts only**, or **Organization accounts only**. たとえば、価格プランがユニット単位であり、複数のシートを提供するなら、個人アカウントからOrganization内の人にシートを割り当てる方法はないので、**Organization accounts only（Organizationアカウントのみ）**が選択できるでしょう。 +- **Available for（利用対象）** - {% data variables.product.prodname_marketplace %}の価格プランは、**個人及びOrganizationアカウント**、**個人アカウントのみ**、**Organizationアカウントのみ**のいずれかにできます。 たとえば、価格プランがユニット単位であり、複数のシートを提供するなら、個人アカウントからOrganization内の人にシートを割り当てる方法はないので、**Organization accounts only（Organizationアカウントのみ）**が選択できるでしょう。 -- **Short description** - Write a brief summary of the details of the pricing plan. この説明には、そのプランが意図している顧客の種類や、プランに含まれるリソースなどが含まれることがあります。 +- **Short description（簡単な説明）** - 価格プランの詳細の簡単な要約を書いてください。 この説明には、そのプランが意図している顧客の種類や、プランに含まれるリソースなどが含まれることがあります。 -- **Bullets** - You can write up to four bullets that include more details about your pricing plan. この箇条書きでは、アプリケーションのユースケースを含めたり、プランに含まれるリソースや機能に関するさらなる詳細をリストしたりすることができます。 +- **Bullets（箇条書き）** - 価格プランに関する詳細を含む箇条書きを、最大で4項目書くことができます。 この箇条書きでは、アプリケーションのユースケースを含めたり、プランに含まれるリソースや機能に関するさらなる詳細をリストしたりすることができます。 {% data reusables.marketplace.free-plan-note %} ### {% data variables.product.prodname_marketplace %}リストの価格プランの変更 -If a pricing plan for your {% data variables.product.prodname_marketplace %} listing is no longer needed, or if you need to adjust pricing details, you can remove it. +{% data variables.product.prodname_marketplace %}のリストのための価格プランが必要なくなったり、プランの詳細を調整する必要が生じた場合、そのプランを削除できます。 ![価格プランを削除するボタン](/assets/images/marketplace/marketplace_remove_this_plan.png) -Once you publish a pricing plan for an app that is already listed in {% data variables.product.prodname_marketplace %}, you can't make changes to the plan. Instead, you'll need to remove the pricing plan and create a new plan. 削除された価格プランを購入済みの顧客は、オプトアウトして新しい価格プランに移行するまでは、そのプランを使い続けます。 価格プランの詳細については、「[{% data variables.product.prodname_marketplace %}の価格プラン](/marketplace/selling-your-app/github-marketplace-pricing-plans/)」を参照してください。 +{% data variables.product.prodname_marketplace %}にリスト済みのアプリケーションの価格プランを公開すると、そのプランは変更できなくなります。 その代わりに、その価格プランを削除して、新しいプランを作成しなければなりません。 削除された価格プランを購入済みの顧客は、オプトアウトして新しい価格プランに移行するまでは、そのプランを使い続けます。 価格プランの詳細については、「[{% data variables.product.prodname_marketplace %}の価格プラン](/marketplace/selling-your-app/github-marketplace-pricing-plans/)」を参照してください。 価格プランを削除すると、ユーザはそのプランを使ってアプリケーションを購入することはできなくなります。 削除されたプランの既存ユーザは、プランのサブスクリプションをキャンセルするまではそのプランに留まり続けます。 diff --git a/translations/ja-JP/content/developers/github-marketplace/submitting-your-listing-for-publication.md b/translations/ja-JP/content/developers/github-marketplace/submitting-your-listing-for-publication.md index bd66b6b20275..4a891ed197e4 100644 --- a/translations/ja-JP/content/developers/github-marketplace/submitting-your-listing-for-publication.md +++ b/translations/ja-JP/content/developers/github-marketplace/submitting-your-listing-for-publication.md @@ -1,6 +1,6 @@ --- -title: Submitting your listing for publication -intro: 'You can submit your listing for the {% data variables.product.prodname_dotcom %} community to use.' +title: 公開のためのリストのサブミット +intro: '{% data variables.product.prodname_dotcom %}コミュニティに利用してもらうためにリストをサブミットできます。' redirect_from: - /marketplace/listing-on-github-marketplace/submitting-your-listing-for-review - /developers/github-marketplace/submitting-your-listing-for-review @@ -10,28 +10,28 @@ versions: -Once you've completed the listing for your app, you'll see two buttons that allow you to request publication of the listing with or without verification. The **Request** button for "Publish without verification" is disabled if you have published any paid pricing plans in the listing. +アプリケーションのリストを完成させると、検証ありもしくは検証なしでのリストの公開をリクエストできる2つのボタンが表示されます。 「検証なしでの公開」のための**リクエスト**ボタンは、リスト中で有料プランを公開している場合、無効化されています。 ![未検証及び検証済みリクエストボタン](/assets/images/marketplace/marketplace-request-button.png) {% data reusables.marketplace.launch-with-free %} -After you submit your listing for review, an onboarding expert will reach out to you with additional information. +レビューのためにリストをサブミットすると、オンボーディングの専門家が追加情報をもって連絡してきます。 -For an overview of the process for creating and submitting a listing, see "[About {% data variables.product.prodname_marketplace %}](/developers/github-marketplace/about-github-marketplace#publishing-an-app-to-github-marketplace)." +リストの作成とサブミットのプロセスの概要については、「[{% data variables.product.prodname_marketplace %}について](/developers/github-marketplace/about-github-marketplace#publishing-an-app-to-github-marketplace)」を参照してください。 -### Prerequisites for publishing with verification +### 検証付きでの公開のための前提条件 -Before you request verification of your listing, you'll need to integrate the {% data variables.product.prodname_marketplace %} billing flows and webhook into your app. For more information, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +リストの検証をリクエストする前に、{% data variables.product.prodname_marketplace %}の支払いフローとwebhookをアプリケーションに統合しなければなりません。 詳しい情報については「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 -If you've met the requirements for listing and you've integrated with the {% data variables.product.prodname_marketplace %} API, go ahead and submit your listing. For more information, see "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)." +リストの要件を満たしており、{% data variables.product.prodname_marketplace %} APIと統合してあれば、先へ進んでリストをサブミットしてください。 詳しい情報については、「[アプリケーションを載せるための要件](/developers/github-marketplace/requirements-for-listing-an-app)」を参照してください。 -{% data reusables.marketplace.app-transfer-to-org-for-verification %} For information on how to do this, see: "[Transferring an app to an organization before you submit](#transferring-an-app-to-an-organization-before-you-submit)" below. +{% data reusables.marketplace.app-transfer-to-org-for-verification %} その方法に関する情報としては、以下の「[サブミットの前にアプリケーションをOrganizationに移譲する](#transferring-an-app-to-an-organization-before-you-submit)」を参照してください。 -### Transferring an app to an organization before you submit +### サブミットの前にアプリケーションをOrganizationに移譲する -You cannot sell an app that's owned by a user account. You need to transfer the app to an organization that is already a verified creator, or that can request verification for a listing for the app. For details, see: +ユーザアカウントが所有するアプリケーションを販売することはできません。 検証済みの作者となっているOrganizationか、アプリケーションのリストの検証をリクエストできるOrganizationに、アプリケーションを移譲しなければなりません。 詳細については以下を参照してください。 -1. "[Creating an organization from scratch](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)" +1. 「[Organizationを最初から作成する](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)」 -1. "[Transferring ownership of a GitHub App](/developers/apps/transferring-ownership-of-a-github-app)" or "[Transferring ownership of an OAuth App](/developers/apps/transferring-ownership-of-an-oauth-app)" +1. 「[GitHub Appの所有権の移譲](/developers/apps/transferring-ownership-of-a-github-app)」あるいは「[OAuth Appの所有権の移譲](/developers/apps/transferring-ownership-of-an-oauth-app)」 diff --git a/translations/ja-JP/content/developers/github-marketplace/testing-your-app.md b/translations/ja-JP/content/developers/github-marketplace/testing-your-app.md index 15cf792b11fd..095691670607 100644 --- a/translations/ja-JP/content/developers/github-marketplace/testing-your-app.md +++ b/translations/ja-JP/content/developers/github-marketplace/testing-your-app.md @@ -1,6 +1,6 @@ --- title: アプリをテストする -intro: 'リストを{% data variables.product.prodname_marketplace %}にサブミットする前に、APIとwebhookを使ってアプリケーションをテストし、顧客に理想的な体験を提供できるようにすることをGitHubはおすすめします。 Before an onboarding expert approves your app, it must adequately handle the billing flows.' +intro: 'リストを{% data variables.product.prodname_marketplace %}にサブミットする前に、APIとwebhookを使ってアプリケーションをテストし、顧客に理想的な体験を提供できるようにすることをGitHubはおすすめします。 オンボーディングの専門家の検証前に、アプリケーションは支払いフローを適切に処理しなければなりません。' redirect_from: - /apps/marketplace/testing-apps-apis-and-webhooks/ - /apps/marketplace/integrating-with-the-github-marketplace-api/testing-github-marketplace-apps/ @@ -13,7 +13,7 @@ versions: ### アプリケーションのテスト -You can use a draft {% data variables.product.prodname_marketplace %} listing to simulate each of the billing flows. リストがドラフト状態にあるということは、まだそれが承認のためにサブミットされていないということです。 ドラフトの{% data variables.product.prodname_marketplace %}リストを使って行った購入は、実際の取引には_ならず_、GitHubはクレジットカードへの課金をしません。 For more information, see "[Drafting a listing for your app](/developers/github-marketplace/drafting-a-listing-for-your-app)" and "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +ドラフトの{% data variables.product.prodname_marketplace %}リストを使って、それぞれの支払いフローをシミュレートできます。 リストがドラフト状態にあるということは、まだそれが承認のためにサブミットされていないということです。 ドラフトの{% data variables.product.prodname_marketplace %}リストを使って行った購入は、実際の取引には_ならず_、GitHubはクレジットカードへの課金をしません。 詳細な情報については、「[アプリケーションのリストのドラフト](/developers/github-marketplace/drafting-a-listing-for-your-app)」及び「[アプリケーションでの{% data variables.product.prodname_marketplace %} APIの利用](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)」を参照してください。 #### 変更のテストのために開発アプリケーションをドラフトリストと使用する diff --git a/translations/ja-JP/content/developers/index.md b/translations/ja-JP/content/developers/index.md index 81987f268f6f..5f38fb8cadff 100644 --- a/translations/ja-JP/content/developers/index.md +++ b/translations/ja-JP/content/developers/index.md @@ -1,6 +1,6 @@ --- -title: Developers -intro: 'Go deeper with {% data variables.product.prodname_dotcom %} by integrating with our APIs, customizing your {% data variables.product.prodname_dotcom %} workflow, and building and sharing apps with the community.' +title: 開発者 +intro: 'APIと統合し、{% data variables.product.prodname_dotcom %}ワークフローをカスタマイズし、アプリケーションを構築してコミュニティと共有することによって、さらに{% data variables.product.prodname_dotcom %}との関係を深めてください。' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/developers/overview/index.md b/translations/ja-JP/content/developers/overview/index.md index 132fb50afca5..c3258fa663d5 100644 --- a/translations/ja-JP/content/developers/overview/index.md +++ b/translations/ja-JP/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 250482473af4..e49de68fb8a8 100644 --- a/translations/ja-JP/content/developers/overview/managing-deploy-keys.md +++ b/translations/ja-JP/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ SSHキーを使いたくないなら、[OAuthトークンでHTTPS][git-automatio * ユーザはローカルのSSH設定を変更する必要がない。 * 複数のトークン（ユーザごと）が必要ない。サーバーごとに1つのトークンで十分。 * トークンはいつでも取り消しできるので、本質的には使い捨てのパスワードにすることができる。 +{% if enterpriseServerVersions contains currentVersion %} * 新しいトークンの作成は、[OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization)を使って容易にスクリプト化できる。 +{% endif %} ##### 短所 diff --git a/translations/ja-JP/content/developers/overview/viewing-deployment-history.md b/translations/ja-JP/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..5ef9bae0ce17 --- /dev/null +++ b/translations/ja-JP/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: デプロイメント履歴の表示 +intro: リポジトリの現在と過去のデプロイメントの表示。 +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %}及び環境、もしくは{% endif %}REST APIとサードパーティのアプリケーションを通じて、デプロイメントを配信できます。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %}に関する詳しい情報については「[{% data variables.product.prodname_actions %}](/actions)」を参照してください。 {% endif %} REST APIでのデプロイメントに関する詳しい情報については、「[リポジトリ](/rest/reference/repos#deployments)」を参照してください。 + +現在及び過去のデプロイメントを表示するには、リポジトリのホームページの** Environments（環境）**をクリックしてください。 ![環境](/assets/images/environments-sidebar.png) + +デプロイメントページは、リポジトリの各環境の最新のアクティブなデプロイメントを表示します。 デプロイメントに環境のURLが含まれるなら、そのURLにリンクする"View deployment（環境の表示）"ボタンがデプロイメントの隣に表示されます。 + +アクティビティログは、環境のデプロイメントの履歴を表示します。 デフォルトでは、環境の最新のデプロイメントだけが`Active`ステータスを持ち、すべての過去にアクティブだったデプロイメントは`Inactive`ステータスを持ちます。 デプロイメントの自動的な非アクティブ化に関する詳しい情報については「[デプロイメントの非アクティブ化](/rest/reference/repos#inactive-deployments)」を参照してください。 + +また、REST APIを使ってデプロイメントに関する情報を取得することもできます。 詳しい情報については「[リポジトリ](/rest/reference/repos#deployments)」を参照してください。 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 e1bc1716c0dc..5e5077368365 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 @@ -91,7 +91,7 @@ GitHub がプルリクエストのベースブランチを自動的に変更し |:------------------------- |:--------------:|:--------------:| |
    • プルリクエスト
    | **X** | | - ### イベントオブジェクトのプロパティ +#### イベントオブジェクトのプロパティ {% data reusables.issue-events.issue-event-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 4c5782e34ec8..870ea339d6d8 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 @@ -71,7 +71,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) 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 5cb9f75a8ac5..123c0a740a66 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 @@ -335,7 +335,7 @@ webhook イベントは、登録したドメインの特異性に基づいてト {% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} -### enterprise +### Enterprise {% data reusables.webhooks.enterprise_short_desc %} @@ -430,7 +430,7 @@ webhook イベントは、登録したドメインの特異性に基づいてト {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **注釈:** {% data reusables.pre-release-program.suspend-installation-beta %} 詳しい情報については、「[{% data variables.product.prodname_github_app %} のインストールをサスペンドする](/apps/managing-github-apps/suspending-a-github-app-installation/)」を参照してください。 @@ -534,13 +534,13 @@ webhook イベントは、登録したドメインの特異性に基づいてト #### webhook ペイロードオブジェクト -| キー | 種類 | 説明 | -| ---------------------- | -------- | ------------------------------------------------------------ | -| `action` | `string` | 実行されたアクション. `created`、`edited`、`deleted` のいずれかを指定可。 | -| `ラベル` | `オブジェクト` | ラベルが追加された。 | -| `変更` | `オブジェクト` | アクションが `edited` の場合のラベルへの変更。 | -| `changes[name][from]` | `string` | The previous version of the name if the action was `edited`. | -| `changes[color][from]` | `string` | アクションが `edited` の場合の以前のバージョンの色。 | +| キー | 種類 | 説明 | +| ---------------------- | -------- | --------------------------------------------------- | +| `action` | `string` | 実行されたアクション. `created`、`edited`、`deleted` のいずれかを指定可。 | +| `label` | `オブジェクト` | ラベルが追加された。 | +| `changes` | `オブジェクト` | アクションが `edited` の場合のラベルへの変更。 | +| `changes[name][from]` | `string` | アクションが`edited`だった場合の、以前のバージョンの名前。 | +| `changes[color][from]` | `string` | アクションが `edited` の場合の以前のバージョンの色。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -715,7 +715,7 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus ### package -{% data variables.product.prodname_registry %} に関連するアクティビティ。 {% data reusables.webhooks.action_type_desc %} 詳しい情報については、「[Organization ユーザをブロックする](/rest/reference/orgs#blocking)」REST API を参照してください。 {% data variables.product.prodname_registry %} の詳細については、「[{% data variables.product.prodname_registry %} を使用してパッケージを管理する](/github/managing-packages-with-github-packages)」を参照してください。 +{% data variables.product.prodname_registry %} に関連するアクティビティ。 {% data reusables.webhooks.action_type_desc %} {% data variables.product.prodname_registry %} の詳細については、「[{% data variables.product.prodname_registry %} を使用してパッケージを管理する](/github/managing-packages-with-github-packages)」を参照してください。 #### 利用の可否 @@ -1125,9 +1125,11 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory セキュリティアドバイザリに関連するアクティビティ。 セキュリティアドバイザリは、GitHub 上のソフトウェアのセキュリティ関連の脆弱性に関する情報を提供します。 セキュリティアドバイザリデータセットは、GitHub セキュリティアラートにも役立ちます。「[脆弱性のある依存関係のセキュリティアラートについて](/articles/about-security-alerts-for-vulnerable-dependencies/)」を参照してください。 +{% endif %} #### 利用の可否 @@ -1236,8 +1238,8 @@ GitHub Marketplace の購入に関連するアクティビティ。 {% data reus | `action` | `string` | 実行されたアクション. `created`、 `deleted`、`edited`、`added_to_repository`、`removed_from_repository` のいずれかを指定可。 | | `Team` | `オブジェクト` | Team 自体。 | | `変更` | `オブジェクト` | アクションが `edited` の場合の Team への変更。 | -| `changes[description][from]` | `string` | The previous version of the description if the action was `edited`. | -| `changes[name][from]` | `string` | The previous version of the name if the action was `edited`. | +| `changes[description][from]` | `string` | アクションが `edited` の場合の以前のバージョンの説明。 | +| `changes[name][from]` | `string` | アクションが`edited`だった場合の、以前のバージョンの名前。 | | `changes[privacy][from]` | `string` | アクションが `edited` の場合の以前のバージョンのTeam プライバシー。 | | `changes[repository][permissions][from][admin]` | `boolean` | アクションが `edited` の場合の、リポジトリに対する以前のバージョンの Team メンバーの `admin` 権限。 | | `changes[repository][permissions][from][pull]` | `boolean` | アクションが `edited` の場合の、リポジトリに対する以前のバージョンの Team メンバーの `pull` 権限。 | diff --git a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index 398032e19653..f9f5ca771a51 100644 --- a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -1,54 +1,54 @@ --- -title: About discussions -intro: Use discussions to ask and answer questions, share information, make announcements, and conduct or participate in a conversation about a project on {% data variables.product.product_name %}. +title: ディスカッションについて +intro: ディスカッションでは、質問、質問への回答、情報の共有、発表、{% data variables.product.product_name %} 上のプロジェクトについて会話を実施したり参加したりすることができます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About discussions +### ディスカッションについて -With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within the project's repository. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools. +{% data variables.product.prodname_discussions %} を使用すると、プロジェクトのコミュニティは、プロジェクトのリポジトリ内で会話を作成して参加できます。 ディスカッションにより、プロジェクトのメンテナ、コントリビューター、訪問者は、サードパーティのツールを使用せずに、一か所に集合し、次のような目標を集めて達成できます。 -- Share announcements and information, gather feedback, plan, and make decisions -- Ask questions, discuss and answer the questions, and mark the discussions as answered -- Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows +- お知らせや情報を共有し、フィードバックを収集し、計画を立案して、意思決定を行う +- 質問し、質問についてディスカッションを行い、回答し、ディスカッションに回答済みのマークを付ける +- 訪問者とコントリビューターが目標、開発、管理、ワークフローについて話し合うための居心地の良い雰囲気を育む -![Discussions tab for a repository](/assets/images/help/discussions/hero.png) +![リポジトリの [Discussions] タブ](/assets/images/help/discussions/hero.png) -You don't need to close a discussion like you close an issue or a pull request. +Issue やプルリクエストをクローズするように、ディスカッションをクローズする必要はありません。 -If a repository administrator or project maintainer enables discussions for a repository, anyone who visits the repository can create and participate in discussions for the repository. Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. 詳細は「[Organization のリポジトリ権限レベル](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)」を参照してください。 +リポジトリ管理者またはプロジェクトメンテナがリポジトリのディスカッションを有効にすると、リポジトリにアクセスするすべての人がリポジトリのディスカッションを作成して参加できます。 リポジトリ管理者とプロジェクトメンテナは、リポジトリ内のディスカッションとディスカッションカテゴリを管理し、ディスカッションを固定してディスカッションの可視性を高めることができます。 モデレータとコラボレータは、コメントを回答としてマークしたり、ディスカッションをロックしたり、Issue をディスカッションに変換したりすることができます。 詳細は「[Organization のリポジトリ権限レベル](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)」を参照してください。 -For more information about management of discussions for your repository, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +リポジトリのディスカッションの管理の詳細については、「[リポジトリでのディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)」を参照してください。 -### About categories and formats for discussions +### ディスカッションのカテゴリと形式について {% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %} -For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. {% data reusables.discussions.github-recognizes-members %} +質問/回答形式のディスカッションの場合、ディスカッション内の個々のコメントをディスカッションの回答としてマークできます。 {% data reusables.discussions.github-recognizes-members %} -For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +詳しい情報については、「[リポジトリ内のディスカッションのカテゴリを管理する](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)」を参照してください。 -### Best practices for discussions +### ディスカッションのベストプラクティス -As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see "[Collaborating with maintainers using discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)." +コミュニティのメンバーまたはメンテナとして、コミュニティに影響を与える質問をしたり、情報について話し合ったりするためのディスカッションを開始します。 詳しい情報については、「[ディスカッションを使用したメンテナとのコラボレーション](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)」を参照してください。 -Participate in a discussion to ask and answer questions, provide feedback, and engage with the project's community. For more information, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +ディスカッションに参加して、質問をしたり、回答したり、フィードバックを提供したり、プロジェクトのコミュニティに参加したりすることができます。 詳しい情報については、「[ディスカッションをピン止めする](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)」を参照してください。 -You can spotlight discussions that contain important, useful, or exemplary conversations among members in the community. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +コミュニティのメンバー間の重要、有用、または模範的な会話を含むディスカッションにスポットライトを当てることができます。 詳しい情報については、「[リポジトリ内のディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)」を参照してください。 -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %}詳しい情報については、「[リポジトリ内のディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)」を参照してください。 ### フィードバックを送る -You can share your feedback about {% data variables.product.prodname_discussions %} with {% data variables.product.company_short %}. To join the conversation, see [`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22). +{% data variables.product.prodname_discussions %} に関するフィードバックを {% data variables.product.company_short %} と共有できます。 会話に参加するには、[`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22) を参照してください。 ### 参考リンク -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" +- 「[{% data variables.product.prodname_dotcom %} での書き方と書式設定について](/github/writing-on-github/about-writing-and-formatting-on-github)」 +- 「[ディスカッションを検索する](/github/searching-for-information-on-github/searching-discussions)」 - 「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications)」 - [コメントと会話の管理](/github/building-a-strong-community/moderating-comments-and-conversations) - 「[{% data variables.product.prodname_dotcom %} での安全性を維持する](/github/building-a-strong-community/maintaining-your-safety-on-github)」 diff --git a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index a07f2f4fb9ec..7c8b31c56430 100644 --- a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md @@ -1,48 +1,48 @@ --- -title: Collaborating with maintainers using discussions -shortTitle: Collaborating with maintainers -intro: You can contribute to the goals, plans, health, and community for a project on {% data variables.product.product_name %} by communicating with the maintainers of the project in a discussion. -permissions: People with read permissions to a repository can start and participate in discussions in the repository. +title: ディスカッションを使用してメンテナとコラボレーションする +shortTitle: メンテナとコラボレーションする +intro: ディスカッションでプロジェクトのメンテナと連絡を取り合うことにより、{% data variables.product.product_name %} でプロジェクトの目標、計画、健全性、およびコミュニティに貢献できます。 +permissions: リポジトリへの読み取り権限を持つユーザは、リポジトリでのディスカッションを開始して参加できます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About collaboration with maintainers using discussions +### ディスカッションを利用したメンテナとのコラボレーションについて -{% data reusables.discussions.about-discussions %} If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "[‎About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} プロジェクトを使用または貢献する場合は、ディスカッションを開始して提案を行い、計画、質問、アイデア、フィードバックについてメンテナやコミュニティメンバーと交流することができます。 詳しい情報については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。 -{% data reusables.discussions.about-categories-and-formats %} Repository administrators and project maintainers can delete a discussion. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)." +{% data reusables.discussions.about-categories-and-formats %} リポジトリ管理者とプロジェクトメンテナはディスカッションを削除できます。 詳しい情報については、「[リポジトリ内のディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)」を参照してください。 -{% data reusables.discussions.github-recognizes-members %} These members appear in a list of the most helpful contributors to the project's discussions. As your project grows, you can grant higher access permissions to active members of your community. For more information, see "[Granting higher permissions to top contributors](/discussions/guides/granting-higher-permissions-to-top-contributors)" +{% data reusables.discussions.github-recognizes-members %} これらのメンバーは、プロジェクトのディスカッションに最も役立つコントリビューターのリストに表示されます。 プロジェクトが成長するにつれて、コミュニティのアクティブなメンバーにより高いアクセス許可を付与できます。 詳しい情報については、「[上位貢献者により高いアクセス許可を付与する](/discussions/guides/granting-higher-permissions-to-top-contributors) 」を参照してください。 -![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) +![プロジェクトのディスカッションに最も役立つ貢献者](/assets/images/help/discussions/most-helpful.png) -For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +ディスカッションへの参加に関する詳しい情報については、「[ディスカッションに参加する](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)」を参照してください。 ### 必要な環境 -To collaborate with maintainers using discussions, a repository administrator or project maintainer must enable discussions for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +ディスカッションを使用してメンテナとコラボレーションするには、リポジトリ管理者またはプロジェクトメンテナがリポジトリのディスカッションを有効にする必要があります。 詳しい情報については、「[リポジトリのディスカッションの有効化または無効化](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」を参照してください。 -### Starting a discussion +### ディスカッションを開始する {% data reusables.discussions.starting-a-discussion %} -### Filtering the list of discussions +### ディスカッションのリストをフィルタする -You can search for discussions and filter the list of discussions in a repository. For more information, see "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)." +ディスカッションを検索し、リポジトリ内のディスカッションのリストをフィルタできます。 詳しい情報については、「[ ディスカッションを検索する](/github/searching-for-information-on-github/searching-discussions)」を参照してください。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the **Search all discussions** field, type a search query. Optionally, to the right of the search field, click a button to further filter the results. ![Search bar and buttons for filtering discussions](/assets/images/help/discussions/search-and-filter-controls.png) -1. In the list of discussions, click the discussion you want to view. ![Discussion search results](/assets/images/help/discussions/search-result.png) +1. [**Search all discussions**] フィールドに、検索クエリを入力します。 必要に応じて、検索フィールドの右側にあるボタンをクリックして、結果をさらにフィルタします。 ![ディスカッションをフィルタするための検索バーとボタン](/assets/images/help/discussions/search-and-filter-controls.png) +1. ディスカッションのリストで、表示するディスカッションをクリックします。 ![ディスカッション検索結果](/assets/images/help/discussions/search-result.png) -### Converting an issue to a discussion +### Issue をディスカッションに変換する -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %}詳しい情報については、「[リポジトリ内のディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)」を参照してください。 ### 参考リンク -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +- 「[{% data variables.product.prodname_dotcom %} での書き方と書式設定について](/github/writing-on-github/about-writing-and-formatting-on-github)」 - 「[{% data variables.product.prodname_dotcom %} での安全性を維持する](/github/building-a-strong-community/maintaining-your-safety-on-github)」 diff --git a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/index.md b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/index.md index 44aed03c8b9e..e0bcf9e07f73 100644 --- a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/index.md +++ b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/index.md @@ -1,7 +1,7 @@ --- -title: Collaborating with your community using discussions -shortTitle: Collaborating using discussions -intro: Gather and discuss your project with community members and other maintainers. +title: ディスカッションを使用してコミュニティとコラボレーションする +shortTitle: ディスカッションを使用してコラボレーションする +intro: コミュニティメンバーや他のメンテナと集まってプロジェクトについてディスカッションしましょう。 versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index b0a504de9dcf..972b2ebff731 100644 --- a/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -1,31 +1,31 @@ --- -title: Participating in a discussion -intro: You can converse with the community and maintainers in a forum within the repository for a project on {% data variables.product.product_name %}. -permissions: People with read permissions to a repository can participate in discussions in the repository. +title: ディスカッションに参加する +intro: '{% data variables.product.product_name %} のプロジェクトのリポジトリ内のフォーラムで、コミュニティやメンテナと会話することができます。' +permissions: リポジトリへの読み取り権限を持つユーザは、リポジトリでのディスカッションに参加できます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About participation in a discussion +### ディスカッションへの参加について -{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %}詳しい情報については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。 -In addition to starting or viewing a discussion, you can comment in response to the original comment from the author of the discussion. You can also create a comment thread by replying to an individual comment that another community member made within the discussion, and react to comments with emoji. For more information about reactions, see "[About conversations on {% data variables.product.prodname_dotcom %}](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)." +ディスカッションの開始または表示に加えて、ディスカッションの作者のコメントに対してコメントすることができます。 また、ディスカッション内で別のコミュニティメンバーが行った個々のコメントに返信してコメントスレッドを作成し、絵文字でコメントにリアクションすることもできます。 リアクションに関する詳しい情報については、「[{% data variables.product.prodname_dotcom %} での会話について](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)」を参照してください。 -You can block users and report disruptive content to maintain a safe and pleasant environment for yourself on {% data variables.product.product_name %}. For more information, see "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)." +{% data variables.product.product_name %} で、ユーザをブロックし、破壊的なコンテンツを報告して、安全で快適な環境を維持できます。 詳しい情報については、「[{% data variables.product.prodname_dotcom %} での安全を維持する](/github/building-a-strong-community/maintaining-your-safety-on-github)」を参照してください。 ### 必要な環境 -Discussions must be enabled for the repository for you to participate in a discussion in the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +リポジトリ内のディスカッションに参加するには、リポジトリでディスカッションを有効にする必要があります。 詳しい情報については、「[リポジトリのディスカッションの有効化または無効化](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」を参照してください。 -### Creating a discussion +### ディスカッションを作成する {% data reusables.discussions.starting-a-discussion %} -### Marking a comment as an answer +### コメントを回答としてマークする -Discussion authors and users with the triage role or greater for a repository can mark a comment as the answer to a discussion in the repository. +リポジトリのトリアージロール以上のディスカッション作者およびユーザは、コメントをリポジトリ内のディスカッションへの回答としてマークできます。 {% data reusables.discussions.marking-a-comment-as-an-answer %} diff --git a/translations/ja-JP/content/discussions/guides/best-practices-for-community-conversations-on-github.md b/translations/ja-JP/content/discussions/guides/best-practices-for-community-conversations-on-github.md index c56aa23743d0..30484b587f06 100644 --- a/translations/ja-JP/content/discussions/guides/best-practices-for-community-conversations-on-github.md +++ b/translations/ja-JP/content/discussions/guides/best-practices-for-community-conversations-on-github.md @@ -1,45 +1,45 @@ --- -title: Best practices for community conversations on GitHub -shortTitle: Best practices for community conversations -intro: 'You can use discussions to brainstorm with your team, and eventually move the conversation to a discussion when you are ready to scope out the work.' +title: GitHub におけるコミュニティの会話のベストプラクティス +shortTitle: コミュニティの会話のベストプラクティス +intro: 'ディスカッションを使用して Team とブレインストーミングを行い、作業を確認する状況が整ったら、最終的に会話をディスカッションに移すことができます。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Community conversations in {% data variables.product.prodname_discussions %} +### {% data variables.product.prodname_discussions %} 内のコミュニティの会話 -Since {% data variables.product.prodname_discussions %} is an open forum, there is an opportunity to bring non-code collaboration into a project's repository and gather diverse feedback and ideas more quickly. You can help drive a productive conversation by: +{% data variables.product.prodname_discussions %} はオープンフォーラムのため、コード以外のコラボレーションをプロジェクトのリポジトリに取り込み、さまざまなフィードバックやアイデアをより迅速に収集する機会があります。 生産的な会話を促進するには、次のような方法があります。 -- Asking pointed questions and follow-up questions to garner specific feedback -- Capture a diverse experience and distill it down to main points -- Open an issue to take action based on the conversation, where applicable +- 特定のフィードバックを収集するために、直接的な質問とフォローアップの質問をする +- 多様な体験を捉えて、主要なポイントに絞り込む +- Issue をオープンし、会話に基づいてアクションを実行する (該当する場合) -For more information about opening an issue and cross-referencing a discussion, see "[Opening an issue from a comment](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." +Issue のオープンおよびディスカッションの相互参照について詳しくは、「[コメントから Issue をオープンする](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)」を参照してください。 -### Learning about conversations on GitHub +### GitHubでの会話について学ぶ -You can create and participate in discussions, issues, and pull requests, depending on the type of conversation you'd like to have. +希望する会話のタイプに応じて、ディスカッション、Issue、プルリクエストを作成して参加できます。 -You can use {% data variables.product.prodname_discussions %} to discuss big picture ideas, brainstorm, and spike out a project's specific details before committing it to an issue, which can then be scoped. Discussions are useful for teams if: -- You are in the discovery phase of a project and are still learning which director your team wants to go in -- You want to collect feedback from a wider community about a project -- You want to keep bug fixes, feature requests, and general conversations separate +{% data variables.product.prodname_discussions %} を使用して、全体像のアイデアについて話し合い、ブレインストーミングを行って、プロジェクトを Issue にコミットする前にプロジェクトの特定の詳細をスパイクして、スコープを設定できます。 ディスカッションは、次の場合に Team に役立ちます。 +- プロジェクトの発見段階で、Team が参加するディレクターを検討している場合 +- より広いコミュニティからプロジェクトについてのフィードバックを収集する必要がある場合 +- バグ修正、機能リクエスト、一般的な会話を別々に保持する必要がある場合 Issueは、バグレポートや計画された改善など、プロジェクトの特定の詳細についての議論に役立ちます。 詳細は「[Issue について](/articles/about-issues)」を参照してください。 プルリクエストでは、提案された変更に直接コメントできます。 詳しい情報については[プルリクエストについて](/articles/about-pull-requests)及び[プルリクエストへコメントする](/articles/commenting-on-a-pull-request)を参照してください。 {% data reusables.organizations.team-discussions-purpose %}詳しい情報については「[Team ディスカッションについて](/articles/about-team-discussions)」を参照してください。 -### Following contributing guidelines +### コントリビューションガイドラインに従う -Before you open a discussion, check to see if the repository has contributing guidelines. The CONTRIBUTING file includes information about how the repository maintainer would like you to contribute ideas to the project. +ディスカッションを開く前に、リポジトリにコントリビューションガイドラインがあるかどうかを確認してください。 CONTRIBUTING ファイルには、リポジトリメンテナがプロジェクトにアイデアを提供する方法に関する情報が含まれています。 詳しい情報については、「[健全なコントリビューションを促すプロジェクトをセットアップする](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)」を参照してください。 ### 次のステップ -To continue learning about {% data variables.product.prodname_discussions %} and quickly create a discussion for your community, see "[Quickstart for {% data variables.product.prodname_discussions %}](/discussions/quickstart)." +{% data variables.product.prodname_discussions %} について引き続き学び、コミュニティのディスカッションをすばやく作成するには、「[{% data variables.product.prodname_discussions %} のクイックスタート](/discussions/quickstart)」を参照してください。 ### 参考リンク diff --git a/translations/ja-JP/content/discussions/guides/finding-discussions-across-multiple-repositories.md b/translations/ja-JP/content/discussions/guides/finding-discussions-across-multiple-repositories.md index d664ce0f95fe..901194c03020 100644 --- a/translations/ja-JP/content/discussions/guides/finding-discussions-across-multiple-repositories.md +++ b/translations/ja-JP/content/discussions/guides/finding-discussions-across-multiple-repositories.md @@ -1,20 +1,20 @@ --- -title: Finding discussions across multiple repositories -intro: 'You can easily access every discussion you''ve created or participated in across multiple repositories.' +title: 複数のリポジトリにわたってディスカッションを検索する +intro: '複数のリポジトリ間で作成または参加したすべてのディスカッションに簡単にアクセスできます。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Finding discussions +### ディスカッションを検索する 1. {% data variables.product.prodname_dotcom_the_website %}に移動します。 -1. In the top-right corner of {% data variables.product.prodname_dotcom_the_website %}, click your profile photo, then click **Your discussions**. !["Your discussions" in drop-down menu for profile photo on {% data variables.product.product_name %}](/assets/images/help/discussions/your-discussions.png) -1. Toggle between **Created** and **Commented** to see the discussions you've created or participated in. +1. {% data variables.product.prodname_dotcom_the_website %} の右上隅にあるプロフィール画像をクリックしてから、[**Your discussions**] をクリックします。 ![{% data variables.product.product_name %} のプロフィール画像のドロップダウンメニューにある [Your discussions]](/assets/images/help/discussions/your-discussions.png) +1. [**Created**] と [**Commented**] を切り替えて、作成または参加したディスカッションを表示します。 ### 参考リンク -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" +- 「[ディスカッションを検索する](/github/searching-for-information-on-github/searching-discussions)」 - "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" - "[Managing discussions for your community](/discussions/managing-discussions-for-your-community)" diff --git a/translations/ja-JP/content/discussions/guides/granting-higher-permissions-to-top-contributors.md b/translations/ja-JP/content/discussions/guides/granting-higher-permissions-to-top-contributors.md index 12d69aa931a4..8a4da0bff736 100644 --- a/translations/ja-JP/content/discussions/guides/granting-higher-permissions-to-top-contributors.md +++ b/translations/ja-JP/content/discussions/guides/granting-higher-permissions-to-top-contributors.md @@ -1,6 +1,6 @@ --- -title: Granting higher permissions to top contributors -intro: 'Repository administrators can promote any community member to a moderator and maintainer.' +title: 上位コントリビューターにより高い権限を付与する +intro: 'リポジトリ管理者は、コミュニティメンバーをモデレータおよびメンテナに昇格させることができます。' versions: free-pro-team: '*' --- @@ -9,24 +9,24 @@ versions: ### はじめに -The most helpful contributors for the past 30 days are highlighted on the {% data variables.product.prodname_discussions %} dashboard, based on how many comments were marked as answers by other community members. Helpful contributors can help drive a healthy community and moderate and guide the community space in addition to maintainers. +過去 30 日間で最も貢献したコントリビューターは、他のコミュニティメンバーによって回答としてマークされたコメントの数に基づいて、{% data variables.product.prodname_discussions %} ダッシュボードで強調表示されます。 貢献度の高いコントリビューターは、健全なコミュニティを推進し、メンテナに加えて、節度のあるコミュニティスペースに導くことができます。 -### Step 1: Audit your discussions top contributors +### ステップ 1: ディスカッションの上位コントリビューターを監査する {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. Compare the list of contributors with their access permissions to see who qualifies to moderate the discussion. +1. コントリビューターのリストとアクセス権限を比較して、ディスカッションをモデレートする資格があるユーザを確認します。 -### Step 2: Review permission levels for discussions +### ステップ 2: ディスカッションの権限レベルを確認する -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +リポジトリのトリアージ権限を持つユーザは、コメントを回答としてマークし、役に立たなくなった、またはコミュニティに損害を与えているディスカッションをロックし、アイデアがまだ開発の初期段階にあるときに Issue をディスカッションに変換することで、プロジェクトのディスカッションをモデレートするのに役立ちます。 詳しい情報については、「[ ディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions)」を参照してください。 -For more information about repository permission levels and {% data variables.product.prodname_discussions %}, see "[Repository permissions levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." +リポジトリの権限レベルおよび {% data variables.product.prodname_discussions %} に関する詳しい情報については、「[Organization のリポジトリの権限レベル](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)」を参照してください。 -### Step 3: Change permissions levels for top contributors +### ステップ 3: 上位コントリビューターのアクセス権限レベルを変更する -You can change a contributor's permission levels to give them more access to the tooling they need to moderate GitHub Discussions. To change a person's or team's permission levels, see "[Managing teams and people with access to your repository](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)." +コントリビューターのアクセス権限レベルを変更して、GitHub ディスカッションをモデレートするために必要なより多くのツールにアクセスできるようになります。 個人またはTeam の権限レベルの変更について詳しくは、「[リポジトリへのアクセス権を持つ Team と人を管理する](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)」を参照してください。 -### Step 4: Notify community members of elevated access +### ステップ 4: アクセス権限の昇格をコミュニティメンバーに通知する -When you change a collaborators permission level, they will receive a notification for the change. +コラボレータの権限レベルを変更すると、変更通知がコラボレータに送信されます。 diff --git a/translations/ja-JP/content/discussions/guides/index.md b/translations/ja-JP/content/discussions/guides/index.md index 71359c1a0252..461254498dd9 100644 --- a/translations/ja-JP/content/discussions/guides/index.md +++ b/translations/ja-JP/content/discussions/guides/index.md @@ -1,21 +1,21 @@ --- -title: Discussions guides +title: ディスカッションガイド shortTitle: ガイド -intro: 'Discover pathways to get started or learn best practices for participating or monitoring your community''s discussions.' +intro: 'コミュニティのディスカッションに参加したりモニタリングしたりするための最初のステップやベストプラクティスを学びましょう。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Getting started with discussions +### ディスカッションを使ってみる {% link_in_list /about-discussions %} {% link_in_list /best-practices-for-community-conversations-on-github %} {% link_in_list /finding-discussions-across-multiple-repositories %} -### Administering discussions +### ディスカッションを管理する {% link_in_list /granting-higher-permissions-to-top-contributors %} diff --git a/translations/ja-JP/content/discussions/index.md b/translations/ja-JP/content/discussions/index.md index 66dca4f270e2..d0ee25fb2467 100644 --- a/translations/ja-JP/content/discussions/index.md +++ b/translations/ja-JP/content/discussions/index.md @@ -1,8 +1,8 @@ --- -title: GitHub Discussions Documentation +title: GitHub Discussions のドキュメント beta_product: true shortTitle: GitHub Discussions -intro: '{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Community members can ask and answer questions, share updates, have open-ended conversations, and follow along on decisions affecting the community''s way of working.' +intro: '{% data variables.product.prodname_discussions %} は、オープンソースプロジェクトに関するコミュニティ向けの共同コミュニケーションフォーラムです。 コミュニティメンバーは、質問をしたり、質問に答えたり、最新情報を共有したり、自由形式の会話をしたり、コミュニティの動向に影響を与える決定をフォローしたりすることができます。' introLinks: quickstart: /discussions/quickstart featuredLinks: @@ -37,19 +37,19 @@ versions: {% assign discussionsCommunityExamples = site.data.variables.discussions_community_examples %} {% if discussionsCommunityExamples %}
    -

    Communities using discussions

    +

    ディスカッションを使用しているコミュニティ

    {% render 'discussions-community-card' for discussionsCommunityExamples as example %}
    {% if discussionsCommunityExamples.length > 6 %} - + {% endif %}
    {% octicon "search" width="24" %}

    Sorry, there is no result for

    It looks like we don't have an example that fits your filter.
    Try another filter or add your code example

    - Add your community {% octicon "arrow-right" %} + コミュニティを追加 {% octicon "arrow-right" %}
    {% endif %} diff --git a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/index.md b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/index.md index 8ccb2875b2fe..e52a051b31d9 100644 --- a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/index.md +++ b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/index.md @@ -1,7 +1,7 @@ --- -title: Managing discussions for your community -shortTitle: Managing discussions -intro: 'You can enable and configure discussions for your repository, and you can use tools on {% data variables.product.product_name %} to moderate conversations among community members.' +title: コミュニティのディスカッションを管理する +shortTitle: ディスカッションを管理する +intro: 'リポジトリのディスカッションを有効にして設定できます。また、{% data variables.product.product_name %} のツールを使用して、コミュニティメンバー間の会話をモデレートできます。' versions: free-pro-team: '*' --- diff --git a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md index 5fe66db5899a..99609409fb8b 100644 --- a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md +++ b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md @@ -1,56 +1,56 @@ --- -title: Managing categories for discussions in your repository -intro: You can categorize the discussions in your repository to organize conversations for your community members, and you can choose a format for each category. -permissions: Repository administrators and people with write or greater access to a repository can enable discussions in the repository. +title: リポジトリ内のディスカッションのカテゴリを管理する +intro: リポジトリ内のディスカッションを分類して、コミュニティメンバーの会話を整理したり、カテゴリごとに形式を選択したりすることができます。 +permissions: リポジトリ管理者およびリポジトリへの書き込み以上のアクセス権を持つユーザは、リポジトリ内でのディスカッションを有効にすることができます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About categories for discussions +### ディスカッションのカテゴリについて {% data reusables.discussions.about-discussions %} {% data reusables.discussions.about-categories-and-formats %} -Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations.{% data reusables.discussions.repository-category-limit %} +各カテゴリには一意の名前と絵文字の組み合わせが必要で、その目的を示す詳しい説明を付けることができます。 カテゴリは、メンテナが会話の保管方法を整理するときに役立ちます。また、Q&A より自由度の高い形式の会話のカテゴリを区別しやすいようにカスタマイズできます。{% data reusables.discussions.repository-category-limit %} -For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +詳しい情報については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)」を参照してください。 -### Default categories +### デフォルトのカテゴリ -| カテゴリ | Purpose | 種類 | -|:--------------- |:-------------------------------------------------------------------- |:--------------------- | -| #️⃣ General | Anything and everything relevant to the project | Open-ended discussion | -| 💡Ideas | Ideas to change or improve the project | Open-ended discussion | -| 🙏 Q&A | Questions for the community to answer, with a question/answer format | Question and Answer | -| 🙌 Show and tell | Creations, experiments, or tests relevant to the project | Open-ended discussion | +| カテゴリ | 目的 | 種類 | +|:------- |:------------------------ |:--------------- | +| #️⃣ 全般 | プロジェクトに関連するすべての事柄 | 自由回答形式のディスカッション | +| 💡 アイデア | プロジェクトを変更または改善するためのアイデア | 自由回答形式のディスカッション | +| 🙏 Q&A | コミュニティが回答する質問 (質問/回答形式) | 質問と回答 | +| 🙌 展示と説明 | プロジェクトに関連する作成物、実験、またはテスト | 自由回答形式のディスカッション | -### Creating a category +### カテゴリを作成する {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.edit-categories %} -1. Click **New category**. !["New category" button above list of discussion categories for a repository](/assets/images/help/discussions/click-new-category-button.png) -1. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." ![Emoji, title, description, and discussion format for new category](/assets/images/help/discussions/edit-category-details.png) -1. ** Create（作成）**をクリックしてください。 !["Create" button for new category](/assets/images/help/discussions/new-category-click-create-button.png) +1. [**New category**] をクリックします。 ![リポジトリのディスカッションカテゴリのリストの上にある [New category] ボタン](/assets/images/help/discussions/click-new-category-button.png) +1. カテゴリの絵文字、タイトル、説明、ディスカッション形式を編集します。 ディスカッション形式の詳細については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)」を参照してください。 ![新しいカテゴリの絵文字、タイトル、説明、ディスカッション形式](/assets/images/help/discussions/edit-category-details.png) +1. ** Create（作成）**をクリックしてください。 ![新しいカテゴリの [Create] ボタン](/assets/images/help/discussions/new-category-click-create-button.png) -### Editing a category +### カテゴリを編集する -You can edit a category to change the category's emoji, title, description, and discussion format. +カテゴリを編集して、カテゴリの絵文字、タイトル、説明、およびディスカッション形式を変更できます。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "pencil" aria-label="The pencil icon" %}. ![Edit button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-edit-for-category.png) +1. リストのカテゴリの右側にある {% octicon "pencil" aria-label="The pencil icon" %} をクリックします ![リポジトリのカテゴリリストのカテゴリの右側にある [Edit] ボタン](/assets/images/help/discussions/click-edit-for-category.png) 1. {% data reusables.discussions.edit-category-details %} -![Editing emoji, title, description, and discussion format for existing category](/assets/images/help/discussions/edit-existing-category-details.png) -1. [**Save changes**] をクリックします。 !["Save changes" button for existing category](/assets/images/help/discussions/existing-category-click-save-changes-button.png) +![既存のカテゴリの絵文字、タイトル、説明、ディスカッション形式を編集する](/assets/images/help/discussions/edit-existing-category-details.png) +1. [**Save changes**] をクリックします。 ![既存のカテゴリの [Save changes] ボタン](/assets/images/help/discussions/existing-category-click-save-changes-button.png) -### Deleting a category +### カテゴリを削除する -When you delete a category, {% data variables.product.product_name %} will move all discussions in the deleted category to an existing category that you choose. +カテゴリを削除すると、{% data variables.product.product_name %} は、削除されたカテゴリのすべてのディスカッションを、選択した既存のカテゴリに移動します。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "trash" aria-label="The trash icon" %}. ![Trash button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-delete-for-category.png) -1. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/choose-new-category.png) -1. Click **Delete & Move**. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/click-delete-and-move-button.png) +1. リストのカテゴリの右側にある {% octicon "trash" aria-label="The trash icon" %} をクリックします ![リポジトリのカテゴリリストのカテゴリの右側にある [Trash] ボタン](/assets/images/help/discussions/click-delete-for-category.png) +1. ドロップダウンメニューを使用して、削除するカテゴリのディスカッションの新しいカテゴリを選択します。 ![既存のカテゴリを削除するときに新しいカテゴリを選択するためのドロップダウンメニュー](/assets/images/help/discussions/choose-new-category.png) +1. [**Delete & Move**] をクリックします。 ![既存のカテゴリを削除するときに新しいカテゴリを選択するためのドロップダウンメニュー](/assets/images/help/discussions/click-delete-and-move-button.png) diff --git a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md index 23c2b87a1773..99e7855f95ad 100644 --- a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md +++ b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md @@ -1,94 +1,94 @@ --- -title: Managing discussions in your repository -intro: You can categorize, spotlight, transfer, or delete the discussions in a repository. -permissions: Repository administrators and people with write or greater access to a repository can manage discussions in the repository. +title: リポジトリ内のディスカッションを管理する +intro: リポジトリ内のディスカッションを分類、スポットライト、転送、または削除できます。 +permissions: リポジトリ管理者およびリポジトリへの書き込み以上のアクセス権を持つユーザは、リポジトリ内のディスカッションを管理できます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About management of discussions +### ディスカッションの管理について -{% data reusables.discussions.about-discussions %} For more information about discussions, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %}ディスカッションに関する詳しい情報については「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。 -Organization owners can choose the permissions required to create a discussion for repositories owned by the organization. For more information, see "[Managing discussion creation for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)." +Organization のオーナーは、Organization が所有するリポジトリのディスカッションを作成するために必要な権限を選択できます。 詳しい情報については、「[Organization 内のリポジトリのディスカッションの作成を管理する](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)」を参照してください。 -As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating a code of conduct or contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)," and "[Setting guidelines for repository contributors](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)." +ディスカッションのメンテナとして、コミュニティリソースを作成して、プロジェクト全体の目標に沿ったディスカッションを促し、コラボレータのための親しみやすいオープンフォーラムを維持できます。 コラボレータが従う行動規範またはコントリビューションガイドラインを作成することは、協力的で生産的なフォーラムを促進するのに役立ちます。 コミュニティリソースの作成について詳しくは、「[プロジェクトに行動規範を追加する](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)」および 「[リポジトリコントリビューター向けのガイドラインを設定する](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)」を参照してください。 -For more information on facilitating a healthy discussion, see "[Moderating comments and conversations](/github/building-a-strong-community/moderating-comments-and-conversations)." +健全なディスカッションの促進について詳しくは、「[コメントと会話のモデレーション](/github/building-a-strong-community/moderating-comments-and-conversations)」を参照してください。 ### 必要な環境 -To manage discussions in a repository, discussions must be enabled for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +リポジトリ内のディスカッションを管理するには、リポジトリでディスカッションを有効にする必要があります。 詳しい情報については、「[リポジトリのディスカッションの有効化または無効化](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」を参照してください。 -### Changing the category for a discussion +### ディスカッションのカテゴリを変更する -You can categorize discussions to help community members find related discussions. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" article. +ディスカッションを分類して、コミュニティメンバーが関連するディスカッションを見つけやすくすることができます。 詳しい情報については、「[リポジトリ内のディスカッションのカテゴリを管理する](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)」の記事を参照してください。 -You can also move a discussion to a different category. +ディスカッションを別のカテゴリに移動することもできます。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. 右のサイドバーで、{% octicon "pencil" aria-label="The pencil icon" %} [**Edit pinned discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Pin discussion]](/assets/images/help/discussions/click-edit-pinned-discussion.png) -### Pinning a discussion +### ディスカッションをピン留めする -You can pin up to four important discussions above the list of discussions for the repository. +リポジトリのディスカッションのリストに、最大 4 つの重要なディスカッションをピン留めできます。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-pin-discussion.png) -1. Optionally, customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. 右のサイドバーで、{% octicon "pin" aria-label="The pin icon" %} [**Pin discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Pin discussion]](/assets/images/help/discussions/click-pin-discussion.png) +1. 必要に応じて、ピン留めされたディスカッションの外観をカスタマイズします。 ![ピン留めされたディスカッションのカスタマイズオプション](/assets/images/help/discussions/customize-pinned-discussion.png) +1. [**Pin discussion**] をクリックします。 ![ピン留めされたディスカッションのカスタマイズオプションの下にある [Pin discussion] ボタン](/assets/images/help/discussions/click-pin-discussion-button.png) -### Editing a pinned discussion +### ピン留めされたディスカッションを編集する -Editing a pinned discussion will not change the discussion's category. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +ピン留めされたディスカッションを編集しても、ディスカッションのカテゴリは変更されません。 詳しい情報については、「[リポジトリ内のディスカッションのカテゴリを管理する](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)」を参照してください。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) -1. Customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. 右のサイドバーで、{% octicon "pencil" aria-label="The pencil icon" %} [**Edit pinned discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Pin discussion]](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. ピン留めされたディスカッションの外観をカスタマイズします。 ![ピン留めされたディスカッションのカスタマイズオプション](/assets/images/help/discussions/customize-pinned-discussion.png) +1. [**Pin discussion**] をクリックします。 ![ピン留めされたディスカッションのカスタマイズオプションの下にある [Pin discussion] ボタン](/assets/images/help/discussions/click-pin-discussion-button.png) -### Unpinning a discussion +### ディスカッションをピン留め解除する {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion**. !["Unpin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-unpin-discussion.png) -1. Read the warning, then click **Unpin discussion**. !["Unpin discussion" button beneath warning in modal](/assets/images/help/discussions/click-unpin-discussion-button.png) +1. 右のサイドバーで、{% octicon "pin" aria-label="The pin icon" %} [**Unpin discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Unpin discussion]](/assets/images/help/discussions/click-unpin-discussion.png) +1. 警告を読み、[**Unpin discussion**] をクリックします。 ![モーダルの警告の下にある [Unpin discussion] ボタン](/assets/images/help/discussions/click-unpin-discussion-button.png) -### Transferring a discussion +### ディスカッションを移譲する -To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion. +ディスカッションを移譲するには、ディスカッションを移譲するリポジトリにディスカッションを作成する権限が必要です。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "arrow-right" aria-label="The right arrow icon" %} **Transfer discussion**. !["Transfer discussion" in right sidebar for discussion](/assets/images/help/discussions/click-transfer-discussion.png) -1. Select the **Choose a repository** drop-down, and click the repository you want to transfer the discussion to. !["Choose a repository" drop-down, "Find a repository" search field, and repository in list](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) -1. Click **Transfer discussion**. !["Transfer discussion" button](/assets/images/help/discussions/click-transfer-discussion-button.png) +1. 右のサイドバーで、{% octicon "arrow-right" aria-label="The right arrow icon" %} [**Transfer discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Transfer discussion]](/assets/images/help/discussions/click-transfer-discussion.png) +1. [**Choose a repository**] ドロップダウンを選択し、ディスカッションの移譲先のリポジトリをクリックします。 ![[Choose a repository] ドロップダウン、[Find a repository] 検索フィールド、およびリスト内のリポジトリ](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) +1. [**Transfer discussion**] をクリックします。 ![[Transfer discussion] ボタン](/assets/images/help/discussions/click-transfer-discussion-button.png) -### Deleting a discussion +### ディスカッションを削除する {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**. !["Delete discussion" in right sidebar for discussion](/assets/images/help/discussions/click-delete-discussion.png) -1. Read the warning, then click **Delete this discussion**. !["Delete this discussion" button beneath warning in modal](/assets/images/help/discussions/click-delete-this-discussion-button.png) +1. 右のサイドバーで、{% octicon "trash" aria-label="The trash arrow icon" %} [**Delete discussion**] をクリックします。 ![ディスカッションの右のサイドバーにある [Delete discussion]](/assets/images/help/discussions/click-delete-discussion.png) +1. 警告を読み、[**Delete this discussion**] をクリックします。 ![モーダルの警告の下にある [Delete this discussion] ボタン](/assets/images/help/discussions/click-delete-this-discussion-button.png) -### Converting issues based on labels +### ラベルに基づいて Issue を変換する -You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure. +同じラベルのすべての Issue をまとめてディスカッションに変換できます。 このラベルの今後の Issue も、設定したディスカッションとカテゴリに自動的に変換されます。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} {% data reusables.project-management.labels %} -1. Next to the label you want to convert to issues, click **Convert issues**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. Issue に変換するラベルの横にある [**Convert issues**] をクリックします。 +1. [**Choose a category**] ドロップダウンメニューを選択し、ディスカッションのカテゴリをクリックします。 +1. [**I understand, convert this issue to a discussion**] をクリックします。 diff --git a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/moderating-discussions.md b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/moderating-discussions.md index 2c91d32d89f6..db24b5e0e878 100644 --- a/translations/ja-JP/content/discussions/managing-discussions-for-your-community/moderating-discussions.md +++ b/translations/ja-JP/content/discussions/managing-discussions-for-your-community/moderating-discussions.md @@ -1,39 +1,39 @@ --- -title: Moderating discussions -intro: 'You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, and converting issues to discussions. and editing or deleting comments, discussions, and categories that don''t align with your community''s code of conduct to discussions.' -permissions: People with triage access to a repository can moderate discussions in the repository. +title: ディスカッションをモデレートする +intro: 'コメントを回答としてマークし、ディスカッションをロックまたはロック解除し、Issue をディスカッションに変換することで、健全なコラボレーションを促進できます。 コミュニティのディスカッションの行動規範に則さないコメント、ディスカッション、およびカテゴリを編集または削除します。' +permissions: リポジトリへのトリアージアクセス権を持つユーザは、リポジトリ内のディスカッションをモデレートできます。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About moderating discussions +### ディスカッションのモデレートについて -{% data reusables.discussions.about-discussions %} If you have triage permissions for a repository, you can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. +{% data reusables.discussions.about-discussions %} リポジトリのトリアージ権限がある場合は、コメントを回答としてマークし、必要なくなった、またはコミュニティに損害を与えているディスカッションをロックし、アイデアがまだ開発の初期段階にあるときに Issue をディスカッションに変換することで、プロジェクトのディスカッションをモデレートするのに役立ちます。 -### Marking a comment as an answer +### コメントを回答としてマークする {% data reusables.discussions.marking-a-comment-as-an-answer %} -### Locking discussions +### ディスカッションをロックする -It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct or {% data variables.product.prodname_dotcom %}'s [Community Guidelines](/github/site-policy/github-community-guidelines). You can also lock a conversation to prevent comments on a discussion you want to use as an announcement to the community. When you lock a conversation, people with write access to the repository will still be able to comment on the discussion. +会話全体が建設的でない場合、またはコミュニティの行動規範または {% data variables.product.prodname_dotcom %} の[コミュニティガイドライン](/github/site-policy/github-community-guidelines)に違反している場合は、会話をロックするのが適切です。 会話をロックして、コミュニティへのお知らせとして使用するディスカッションへのコメントを防ぐこともできます。 会話をロックしても、リポジトリへの書き込みアクセス権を持つユーザは引き続きディスカッションにコメントできます。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the list of discussions, click the discussion you want to lock. ![Lock discussion](/assets/images/help/discussions/unanswered-discussion.png) -1. In the right margin of a discussion, click **Lock conversation**. -1. Read the information about locking conversations and click **Lock conversation on this discussion**. -1. When you're ready to unlock the conversation, click **Unlock conversation**, then click **Unlock conversation on this discussion**. +1. ディスカッションのリストで、ロックするディスカッションをクリックします。 ![ディスカッションのロック](/assets/images/help/discussions/unanswered-discussion.png) +1. ディスカッションの右マージンで、[**Lock conversation**] をクリックします。 +1. 会話のロックに関する情報を確認し、[**Lock conversation on this discussion**] をクリックします。 +1. 会話のロックを解除する準備ができたら、[**Unlock conversation**] をクリックしてから、[**Unlock conversation on this discussion**] をクリックします。 -### Converting an issue to a discussion +### Issue をディスカッションに変換する -When you convert an issue to a discussion, the discussion is automatically created using the content from the issue. People with write access to a repository can bulk convert issues based on labels. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +Issue をディスカッションに変換すると、その Issue のコンテンツを使用してディスカッションが自動的に作成されます。 リポジトリへの書き込みアクセス権を持つユーザは、ラベルに基づいて Issue を一括変換できます。 詳しい情報については、「[リポジトリ内のディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)」を参照してください。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} -1. In the list of issues, click the issue you'd like to convert. -1. In the right margin of an issue, click **Convert to discussion**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. Issue のリストで、変換する Issue をクリックします。 +1. Issue の右マージンで [**Convert to discussion**] をクリックします。 +1. [**Choose a category**] ドロップダウンメニューを選択し、ディスカッションのカテゴリをクリックします。 +1. [**I understand, convert this issue to a discussion**] をクリックします。 diff --git a/translations/ja-JP/content/discussions/quickstart.md b/translations/ja-JP/content/discussions/quickstart.md index 1a9d5ce3aea7..8d1580334982 100644 --- a/translations/ja-JP/content/discussions/quickstart.md +++ b/translations/ja-JP/content/discussions/quickstart.md @@ -1,6 +1,6 @@ --- -title: Quickstart for GitHub Discussions -intro: 'Enable {% data variables.product.prodname_discussions %} on an existing repository and start conversations with your community.' +title: GitHub Discussions のクイックスタート +intro: '既存のリポジトリで {% data variables.product.prodname_discussions %} を有効にして、コミュニティとの会話を開始します。' allowTitleToDifferFromFilename: true versions: free-pro-team: '*' @@ -10,49 +10,49 @@ versions: ### はじめに -{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Discussions are for conversations that need to be transparent and accessible but do not need to be tracked on a project board and are not related to code, unlike issues. Discussions enable fluid, open conversation in a public forum. +{% data variables.product.prodname_discussions %} は、オープンソースプロジェクトに関するコミュニティ向けの共同コミュニケーションフォーラムです。 Discussions は、Issue とは異なり、プロジェクトボードで追跡する必要がなく、コードに関連しない会話のためのものですが、透明性があり利用しやすいものである必要があります。 Discussions により、公開フォーラムで流動的でオープンな会話ができるようになります。 -Discussions give a space for more collaborative conversations by connecting and giving a more centralized area to connect and find information. +Discussions では、より協力的な会話ができるように、情報に接続して検索するためのより一元的なエリアを提供しています。 -### Enabling {% data variables.product.prodname_discussions %} on your repository +### リポジトリの {% data variables.product.prodname_discussions %} を有効化する -Repository owners and people with write access can enable {% data variables.product.prodname_discussions %} for a community on their public repositories. +リポジトリのオーナーと書き込みアクセスを持つユーザは、パブリックリポジトリのコミュニティに対して {% data variables.product.prodname_discussions %} を有効化できます。 -When you first enable a {% data variables.product.prodname_discussions %}, you will be invited to configure a welcome post. +{% data variables.product.prodname_discussions %} を最初に有効化すると、ウェルカム投稿を設定するように求められます。 {% data reusables.repositories.navigate-to-repo %} -1. リポジトリ名の下で{% octicon "gear" aria-label="The gear icon" %} **Settings（設定）**をクリックしてください。 ![Public settings button](/assets/images/help/discussions/public-repo-settings.png) -1. Under "Features", click **Set up discussions**. ![Set up a discussion button under "Features" for enabling or disabling discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png) -1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community. +1. リポジトリ名の下で{% octicon "gear" aria-label="The gear icon" %} **Settings（設定）**をクリックしてください。 ![公開設定ボタン](/assets/images/help/discussions/public-repo-settings.png) +1. [Features] で、[**Set up discussions**] をクリックします。 ![リポジトリのディスカッションを有効または無効にするために、[機能] の下にディスカッションボタンを設定](/assets/images/help/discussions/setup-discussions-button.png) +1. [Start a new discussion] で、テンプレートを編集してコミュニティに設定するリソースと方向性を合わせます。 1. Click **Start discussion**. !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png) -### Welcoming contributions to your discussions +### ディスカッションへのコントリビューションを歓迎する -You can welcome your community and introduce a new way to communicate in a repository by creating a welcome post and pin the post to your {% data variables.product.prodname_discussions %} page. Pinning and locking discussions helps people know that a post is meant as an announcement. You can use announcements as a way to link people to more resources and offer guidance for opening discussions in your community. For more information about pinning a discussion, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +ウェルカム投稿を作成して、その投稿を {% data variables.product.prodname_discussions %} ページにピン留めすることで、コミュニティを歓迎し、リポジトリ内の新しいコミュニケーションの導入について紹介します。 ディスカッションをピン留めしてロックすると、投稿がお知らせであることを周知するのに役立ちます。 お知らせを使用すると、ユーザをより多くのリソースにリンクし、コミュニティでディスカッションをオープンするためのガイダンスを提供できます。 ディスカッションのピン留めに関する詳しい情報については、「[リポジトリ内のディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)」を参照してください。 -### Setting up community guidelines for contributors +### コントリビューター向けのコミュニティガイドラインを設定する -You can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. You can also update the repository's README to communicate expectations on when collaborators should open an issue or discussion. +コントリビューションガイドラインを設定して、コラボレータがリポジトリについて有意義で有用な会話を行うよう促すことができます。 リポジトリの README を更新して、コラボレータが Issue やディスカッションをオープンするタイミングを伝えることもできます。 -For more information about providing guidelines for your project, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" and "[Setting up your project for healthy contributions](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)." +プロジェクトのガイドラインの提供方法の詳細については、「[プロジェクトに行動規範を追加する](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)」および 「[健全なコントリビューションのためのプロジェクトの設定](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)」を参照してください。 -### Creating a new discussion +### 新しいディスカッションを作成する -Anyone with access to a repository can create a discussion. +リポジトリへのアクセス権限を持つユーザは、ディスカッションを作成できます。 {% data reusables.discussions.starting-a-discussion %} -### Organizing discussions into relevant categories +### ディスカッションを関連するカテゴリに整理する -Repository owners and people with write access can create new categories to keep discussions organized. Collaborators participating and creating new discussions can group discussions into the most relevant existing categories. Discussions can also be recategorized after they are created. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" +リポジトリの所有者と書き込みアクセス権を持つユーザは、新しいカテゴリを作成してディスカッションを整理できます。 参加しているコラボレータが新しいディスカッションを作成する場合、ディスカッションを最も関連性の高い既存のカテゴリにグループ化できます。 ディスカッションは、作成後に再分類することもできます。 詳しい情報については、「[リポジトリ内のディスカッションのカテゴリを管理する](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)」を参照してください。 -### Promoting healthy conversations +### 健全な会話を促進する -People with write permissions for a repository can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +リポジトリへの書き込み権限を持つユーザは、ディスカッションをピン留めし、役に立たなくなった、またはコミュニティに害を与えているディスカッションを削除し、Organization が所有するより関連性の高いリポジトリにディスカッションを移譲することで、重要な会話を明示できます。 詳しい情報については、「[リポジトリ内のディスカッションを管理する](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)」を参照してください。 -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +リポジトリのトリアージ権限を持つユーザは、コメントを回答としてマークし、役に立たなくなった、またはコミュニティに損害を与えているディスカッションをロックし、アイデアがまだ開発の初期段階にあるときに Issue をディスカッションに変換することで、プロジェクトのディスカッションをモデレートするのに役立ちます。 詳しい情報については、「[ ディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions)」を参照してください。 ### 次のステップ -Once there is a clear path to scope work out and move an idea from concept to reality, you can create an issue and start tracking your progress. For more information on creating an issue from a discussion, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +作業を確認してアイデアをコンセプトから現実に移すための明確な道筋ができたら、Issue を作成して進捗状況の追跡を開始できます。 ディスカッションから Issue を作成する際の詳しい情報については、「[ ディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions)」を参照してください。 diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md index e285ea8f921a..3a678b866c1e 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md @@ -1,31 +1,31 @@ --- -title: About using MakeCode Arcade with GitHub Classroom -shortTitle: About using MakeCode Arcade -intro: You can configure MakeCode Arcade as the online IDE for assignments in {% data variables.product.prodname_classroom %}. +title: GitHub ClassroomでMakeCode Arcadeを使用する +shortTitle: MakeCode Arcadeの使用について +intro: MakeCode Arcadeを、{% data variables.product.prodname_classroom %}の課題のためのオンラインIDEとして設定できます。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-makecode --- -### About MakeCode Arcade +### MakeCode Arcadeについて -MakeCode Arcade is an online integrated development environment (IDE) for developing retro arcade games using drag-and-drop block programming and JavaScript. Students can write, edit, run, test, and debug code in a browser with MakeCode Arcade. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +MakeCode Arcadeとは、ドラッグアンドドロップのブロックプログラミングとJavaScriptを使用してレトロなアーケードゲームを開発するためのオンライン統合開発環境 (IDE) です。 生徒はMakeCode Arcadeを使ってブラウザでコードを記述、編集、実行、テスト、デバッグできます。 オンラインIDEおよび{% data variables.product.prodname_classroom %}に関する詳しい情報については、「[{% data variables.product.prodname_classroom %}とオンラインIDEの統合](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)」を参照してください。 {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit MakeCode Arcade, the student must sign into MakeCode Arcade with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on MakeCode Arcade. +生徒がボタンをクリックして、初めてMakeCode Arcadeにアクセスする際は、{% data variables.product.product_name %}認証情報でMakeCode Arcadeにサインインする必要があります。 サインインすると、生徒はMakeCode Arcadeで完全に構成された、課題リポジトリのコードが含まれる開発環境にアクセスできます。 -For more information about working on MakeCode Arcade, see the [MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour) and [documentation](https://arcade.makecode.com/docs) on the MakeCode Arcade website. +MakeCode Arcadeにおける作業についての詳細は、[MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour)およびMakeCode Arcadeウェブサイトの[ドキュメント](https://arcade.makecode.com/docs)を参照してください。 -MakeCode Arcade does not support multiplayer-editing for group assignments. Instead, students can collaborate with Git and {% data variables.product.product_name %} features like branches and pull requests. +MakeCode Arcadeは、グループ課題のための複数人による編集をサポートしていません。 その代わり、生徒はブランチやプルリクエストのようなGitおよび{% data variables.product.product_name %}の機能でコラボレートできます。 -### About submission of assignments with MakeCode Arcade +### MakeCode Arcadeによる課題の提出について -By default, MakeCode Arcade is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with MakeCode Arcade, students should push changes to {% data variables.product.product_location %} using the {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} button at the bottom of the screen. +デフォルトでは、MakeCode Arcadeは{% data variables.product.product_location %}の課題リポジトリにプッシュするよう設定されています。 MakeCode Arcadeで課題を進めた後、生徒は画面下部にある{% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %}ボタンで、変更を{% data variables.product.product_location %}にプッシュする必要があります。 -![MakeCode Arcade version control functionality](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) +![MakeCode Arcadeのバージョン管理機能](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) ### 参考リンク -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- [READMEについて](/github/creating-cloning-and-archiving-repositories/about-readmes) diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md index 15f050d0db9e..f8c4b2924c50 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md @@ -1,33 +1,33 @@ --- -title: About using Repl.it with GitHub Classroom -shortTitle: About using Repl.it -intro: You can configure Repl.it as the online integrated development environment (IDE) for assignments in {% data variables.product.prodname_classroom %}. +title: GitHub ClassroomでRepl.itを使用する +shortTitle: Repl.itの使用について +intro: Repl.itを、{% data variables.product.prodname_classroom %}の課題のためのオンライン統合開発環境 (IDE) として設定できます。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-replit --- -### About Repl.it +### Repl.itについて -Repl.it is an online integrated development environment (IDE) that supports multiple programming languages. Students can write, edit, run, test, and debug code in a browser with Repl.it. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +Repl.itは、複数の複数のプログラミング言語をサポートするオンライン統合開発環境 (IDE) です。 生徒はRepl.itを使ってブラウザでコードを記述、編集、実行、テスト、デバッグできます。 オンラインIDEおよび{% data variables.product.prodname_classroom %}に関する詳しい情報については、「[{% data variables.product.prodname_classroom %}とオンラインIDEの統合](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)」を参照してください。 {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit Repl.it, the student must sign into Repl.it with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on Repl.it. +生徒がボタンをクリックして、初めてRepl.itにアクセスする際は、{% data variables.product.product_name %}認証情報でMakeCode Arcadeにサインインする必要があります。 サインインすると、生徒はRepl.itで完全に構成された、課題リポジトリのコードが含まれる開発環境にアクセスできます。 -For more information about working on Repl.it, see the [Repl.it Quickstart Guide](https://docs.repl.it/misc/quick-start#the-repl-environment). +Repl.itでの作業に関する詳しい情報については、[Repl.itクイックスタートガイド](https://docs.repl.it/misc/quick-start#the-repl-environment)を参照してください。 -For group assignments, students can use Repl.it Multiplayer to work collaboratively. For more information, see the [Repl.it Multiplayer](https://repl.it/site/multiplayer) website. +グループ課題の場合、生徒はRepl.it Multiplayerを利用して共同作業を行うことができます。 詳しい情報については、[Repl.it Multiplayer](https://repl.it/site/multiplayer)のウェブサイトを参照してください。 -### About submission of assignments with Repl.it +### Repl.itによる課題の提出について -By default, Repl.it is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with Repl.it, students should push changes to {% data variables.product.product_location %} using the version control functionality in the left sidebar. +デフォルトでは、Repl.itは{% data variables.product.product_location %}の課題リポジトリにプッシュするよう設定されています。 MakeCode Arcadeで課題を進めた後、生徒は左サイドバーのバージョン管理機能を使って、変更を{% data variables.product.product_location %}にプッシュする必要があります。 -![Repl.it version control functionality](/assets/images/help/classroom/ide-replit-version-control-button.png) +![Repl.itのバージョン管理機能](/assets/images/help/classroom/ide-replit-version-control-button.png) -For more information about using Git on Repl.it, see the [Repl.it + Git Tutorial](https://repl.it/talk/learn/Replit-Git-Tutorial/23331) on the Repl.it website. +Repl.itにおけるGitの利用に関する詳しい情報については、Repl.itウェブサイト上の[Repl.it + Git Tutorial](https://repl.it/talk/learn/Replit-Git-Tutorial/23331)を参照してください。 ### 参考リンク -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- [READMEについて](/github/creating-cloning-and-archiving-repositories/about-readmes) diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md index 386402e62885..3a06dfafb01d 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md @@ -1,33 +1,33 @@ --- -title: Basics of setting up GitHub Classroom -shortTitle: '{% data variables.product.prodname_classroom %} basics' -intro: Learn how to set up your classroom, manage assignments, and configure time-saving automation. +title: GitHub Classroomのセットアップの基本 +shortTitle: '{% data variables.product.prodname_classroom %}の基本' +intro: 教室のセットアップ、課題の管理、時間を節約できる自動化の設定方法を学びます。 versions: free-pro-team: '*' --- -### Videos about {% data variables.product.prodname_classroom %} +### {% data variables.product.prodname_classroom %}についてのビデオ -You can watch a series of short video tutorials about the configuration and use of {% data variables.product.prodname_classroom %}. To watch all videos as part of a continuous playlist, see the [{% data variables.product.prodname_classroom %} Getting Started Guide](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u) on YouTube. +{% data variables.product.prodname_classroom %}の設定や使い方について、手短なビデオチュートリアルのシリーズをご覧いただけます。 すべてのビデオをプレイリストで再生したい場合は、YouTube上の[{% data variables.product.prodname_classroom %} Getting Started Guide](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u)を参照してください。 -For more information about terminology for {% data variables.product.prodname_classroom %}, see "[Glossary](/education/manage-coursework-with-github-classroom/glossary)". +{% data variables.product.prodname_classroom %}の用語に関する詳細については、「[用語集](/education/manage-coursework-with-github-classroom/glossary)」を参照してください。 -1. Getting started {% octicon "link-external" aria-label="The external link icon" %} -2. Adding your student roster {% octicon "link-external" aria-label="The external link icon" %} -3. Creating assignments - - Creating an assignment using a {% data variables.product.prodname_dotcom %} repository {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Microsoft MakeCode as your online IDE {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Repl.it as your online IDE {% octicon "link-external" aria-label="The external link icon" %} -4. How students complete assignments {% octicon "link-external" aria-label="The external link icon" %} -5. How teachers review assignments {% octicon "link-external" aria-label="The external link icon" %} -6. Creating group assignments {% octicon "link-external" aria-label="The external link icon" %} -7. Next steps to get started {% octicon "link-external" aria-label="The external link icon" %} +1. はじめに {% octicon "link-external" aria-label="The external link icon" %} +2. 生徒の名簿を追加する {% octicon "link-external" aria-label="The external link icon" %} +3. 課題を作成する + - {% data variables.product.prodname_dotcom %} リポジトリを使用して課題を作成する {% octicon "link-external" aria-label="The external link icon" %} + - オンラインIDEにMicrosoft MakeCodeを使用して課題を作成する {% octicon "link-external" aria-label="The external link icon" %} + - オンラインIDEにRepl.itを使用して課題を作成する {% octicon "link-external" aria-label="The external link icon" %} +4. 生徒が課題を仕上げる方法 {% octicon "link-external" aria-label="The external link icon" %} +5. 教師が課題を確認する方法 {% octicon "link-external" aria-label="The external link icon" %} +6. グループ課題を作成する {% octicon "link-external" aria-label="The external link icon" %} +7. 開始するための次のステップ {% octicon "link-external" aria-label="The external link icon" %} 8. {% data variables.product.prodname_dotcom %} Teacher Toolbox {% octicon "link-external" aria-label="The external link icon" %} ### 次のステップ -For more information about teaching with {% data variables.product.prodname_classroom %}, see "[Teach with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)." +{% data variables.product.prodname_classroom %}を使って教える方法の詳細については、「[{% data variables.product.prodname_classroom %}で教える](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)」を参照してください。 ### 参考リンク -- "[Teach and learn with {% data variables.product.prodname_education %}](/education/teach-and-learn-with-github-education)" +- [{% data variables.product.prodname_education %}で教える、学ぶ](/education/teach-and-learn-with-github-education) diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md index bcc3541cf092..8d6866e2db25 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md @@ -1,6 +1,6 @@ --- -title: Configure default settings for assignment repositories -shortTitle: Configure defaults for assignment repositories +title: 課題リポジトリのデフォルト設定の構成 +shortTitle: 課題リポジトリのデフォルトの構成 intro: You can use the Probot Settings app to configure the default settings for repositories that {% data variables.product.prodname_classroom %} creates for an assignment. permissions: Organization owners can configure default settings for assignment repositories by installing a {% data variables.product.prodname_github_app %} for the organization. versions: diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md index fcab190c3ea3..c8da3fd7ebd9 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md @@ -39,4 +39,4 @@ For all repositories, grant the app **read** access to metadata, administration, ### 参考リンク -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- [READMEについて](/github/creating-cloning-and-archiving-repositories/about-readmes) diff --git a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index c3d13bd2bc63..583e28363464 100644 --- a/translations/ja-JP/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/ja-JP/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -28,4 +28,4 @@ To create and access the feedback pull request, you must enable the feedback pul ### 参考リンク -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/ja-JP/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/ja-JP/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index 4ea378a753dd..80f9816a4b66 100644 --- a/translations/ja-JP/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/ja-JP/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -18,7 +18,7 @@ versions: - [{% data variables.product.prodname_dotcom %} のユーザアカウント](/articles/signing-up-for-a-new-github-account)を持っている - 最低でも 13 歳以上であること -あなたの在学状況を証明する書類には、学生証、授業計画、成績証明書、所属または登録を証明する書類などのコピーがあげられます。 +Documents that prove your current student status include a picture of your school ID with current enrollment date, class schedule, transcript, and affiliation or enrollment verification letter. 学生としての在籍期間、定期的に現在の在学状況の再検証が求められることがあります。 diff --git a/translations/ja-JP/content/github/administering-a-repository/about-dependabot-version-updates.md b/translations/ja-JP/content/github/administering-a-repository/about-dependabot-version-updates.md index 43e77647c070..73369d7f6e00 100644 --- a/translations/ja-JP/content/github/administering-a-repository/about-dependabot-version-updates.md +++ b/translations/ja-JP/content/github/administering-a-repository/about-dependabot-version-updates.md @@ -1,5 +1,5 @@ --- -title: About Dependabot version updates +title: GitHub Dependabot のバージョンアップデートについて intro: '{% data variables.product.prodname_dependabot %} を使用して、使用するパッケージを最新バージョンに更新しておくことができます。' redirect_from: - /github/administering-a-repository/about-dependabot @@ -14,11 +14,11 @@ versions: {% data variables.product.prodname_dependabot %} は、依存関係を維持する手間を省きます。 これを使用して、リポジトリが依存するパッケージおよびアプリケーションの最新リリースに自動的に対応できるようにすることができます。 -{% data variables.product.prodname_dependabot_version_updates %} を有効にするには、リポジトリに設定ファイルをチェックインします。 設定ファイルでは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 {% data variables.product.prodname_dependabot %} はこの情報を使用して、古いパッケージとアプリケーションをチェックします。 {% data variables.product.prodname_dependabot %} は、依存関係のセマンティックバージョニング（[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_version_updates %} を有効にするには、リポジトリに設定ファイルをチェックインします。 設定ファイルでは、リポジトリに保存されているマニフェストまたは他のパッケージ定義ファイルの場所を指定します。 {% data variables.product.prodname_dependabot %} はこの情報を使用して、古いパッケージとアプリケーションをチェックします。 {% data variables.product.prodname_dependabot %} は、依存関係のセマンティックバージョニング（[semver](https://semver.org/)）を調べて、そのバージョンへの更新の必要性を判断することにより、依存関係の新しいバージョンの有無を決定します。 特定のパッケージマネージャーでは、{% data variables.product.prodname_dependabot_version_updates %} もベンダをサポートしています。 ベンダ (またはキャッシュ) された依存関係は、マニフェストで参照されるのではなく、リポジトリ内の特定のディレクトリにチェックインされる依存関係です。 パッケージサーバーが利用できない場合でも、ビルド時にベンダ依存関係を利用できます。 {% data variables.product.prodname_dependabot_version_updates %} は、ベンダの依存関係をチェックして新しいバージョンを確認し、必要に応じて更新するように設定できます。 -{% data variables.product.prodname_dependabot %} が古い依存関係を特定すると、プルリクエストを発行して、マニフェストを依存関係の最新バージョンに更新します。 For vendored dependencies, {% data variables.product.prodname_dependabot %} 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 %} はプルリクエストを生成して、古い依存関係を新しいバージョンに直接置き換えます。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳しい情報については、「[バージョン更新の有効化と無効化](/github/administering-a-repository/enabling-and-disabling-version-updates)」を参照してください。 -セキュリティアップデートを有効にすると、{% data variables.product.prodname_dependabot %} はプルリクエストを発行し、脆弱性のある依存関係を更新します。 For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." +セキュリティアップデートを有効にすると、{% data variables.product.prodname_dependabot %} はプルリクエストを発行し、脆弱性のある依存関係を更新します。 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 {% data reusables.dependabot.dependabot-tos %} @@ -32,11 +32,11 @@ versions: ### サポートされているリポジトリとエコシステム -サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 For some package managers, you can also configure vendoring for dependencies. 詳しい情報については、「[依存関係の更新の設定オプション](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor) 」を参照してください。 +サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 一部のパッケージマネージャーでは、依存関係のベンダを設定することもできます。 詳しい情報については、「[依存関係の更新の設定オプション](/github/administering-a-repository/configuration-options-for-dependency-updates#vendor) 」を参照してください。 {% note %} -{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. See the details in the table below. +{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. 詳細は、以下の表をご覧ください。 {% endnote %} 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 e676a0201b4b..475803c758a8 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 @@ -25,7 +25,7 @@ versions: - コミットの一部として変更されたファイル群 - コミットメッセージ -リポジトリへのプッシュに対して受け取るメール通知はフィルタリングできます。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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 %}」を参照してください。 +リポジトリへのプッシュに対して受け取るメール通知はフィルタリングできます。 詳しい情報については、{% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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 %}」を参照してください。 ### リポジトリへのプッシュに対するメール通知の有効化 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 25c171709531..0bc422b92998 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 @@ -11,12 +11,16 @@ versions: github-ae: '*' --- +### 保護されたブランチについて + {% data reusables.pull_requests.about-protected-branches %} プルリクエストのリポジトリへのマージ方法に制限を適用することができます。 リポジトリのオーナーおよびリポジトリの管理権限を持つ人は、コラボレーターがリポジトリでブランチをマージする前に特定のワークフローや必須事項を強制できます。そのためには保護されたブランチのルールを作成します。 {% data reusables.repositories.branch-rules-example %}詳しい情報については[保護されたブランチの設定](/articles/configuring-protected-branches/)を参照してください。 +{% data reusables.pull_requests.you-can-auto-merge %} + ### 保護されたブランチのルールの優先順位付け リポジトリが同じブランチに影響する複数の保護されたブランチのルールを持っているなら、特定のブランチ名を含むルールがもっとも高い優先順位を持ちます。 同じ特定のブランチ名を参照する保護されたブランチのルールが複数あるなら、最初に作成されたブランチルールが高い優先順位を持ちます。 @@ -25,7 +29,7 @@ versions: ### ブランチの保護の設定 -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)」を参照してください。 +リポジトリにブランチ保護ルールを作成すると、コラボレータは保護されたブランチに強制的にプッシュしたり、デフォルトでブランチを削除{% if currentVersion == "free-pro-team@latest" %}したりすることはできません{% 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 3fdcd4b83ff6..55991292e1bf 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 @@ -21,18 +21,18 @@ versions: リリースは [Git タグ](https://git-scm.com/book/en/Git-Basics-Tagging)に基づきます。タグは、リポジトリの履歴の特定の地点をマークするものです。 タグの日付は異なる時点で作成できるため、リリースの日付とは異なる場合があります。 既存のタグの表示に関する詳細は「[リポジトリのリリースとタグを表示する](/github/administering-a-repository/viewing-your-repositorys-releases-and-tags)」を参照してください。 -リポジトリで新しいリリースが公開されたときに通知を受け取り、リポジトリで他の更新があったときには通知を受け取らないでいることができます。 For more information, see {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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 %}." +リポジトリで新しいリリースが公開されたときに通知を受け取り、リポジトリで他の更新があったときには通知を受け取らないでいることができます。 詳しい情報については、{% 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 %}。 リポジトリへの読み取りアクセス権を持つ人はリリースを表示および比較できますが、リリースの管理はリポジトリへの書き込み権限を持つ人のみができます。 詳細は「[リポジトリのリリースを管理する](/github/administering-a-repository/managing-releases-in-a-repository)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %} -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)」を参照してください。 +リポジトリへの管理者権限を持つユーザは、 +{% 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 %} {% if currentVersion == "free-pro-team@latest" %} リリースでセキュリティの脆弱性が修正された場合は、リポジトリにセキュリティアドバイザリを公開する必要があります。 -{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_alerts %} to affected repositories. 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 +{% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_alerts %} を送信できます。 詳しい情報については、「[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/configuring-pull-request-merges.md b/translations/ja-JP/content/github/administering-a-repository/configuring-pull-request-merges.md index 1733c2fc1d60..a964bbffb1fd 100644 --- a/translations/ja-JP/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/ja-JP/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: プルリクエストマージを設定する -intro: 'Git の履歴をワークフローおよび好みに合わせて管理するため、{% data variables.product.product_location %} のプルリクエストのマージを設定して、リポジトリ内のすべてのプルリクエストに対し、標準的マージコミット、squash したコミット、リベースしたコミットを有効化、無効化、または強制化できます。' +intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 fa2523166085..02f66579340d 100644 --- a/translations/ja-JP/content/github/administering-a-repository/index.md +++ b/translations/ja-JP/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/ja-JP/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/ja-JP/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..e19203c0666a --- /dev/null +++ b/translations/ja-JP/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Managing auto-merge for pull requests in your repository +intro: "You can allow or disallow auto-merge for pull requests in your repository." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Under "Merge button", select or deselect **Allow auto-merge**. ![Checkbox to allow or disallow auto-merge](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file 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 dd9e47a6feab..14b298a7771e 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 @@ -24,7 +24,7 @@ You can also publish an action from a specific release in {% data variables.prod {% endif %} 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)」を参照してください。 +{% 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 %} {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 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 e5820aeac886..a68232fd1609 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 @@ -24,7 +24,7 @@ Organization のオーナーは、リポジトリの可視性を変更する機 * 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. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}The visibility of any forks will also change to private.{% elsif currentVersion == "github-ae@latest" %}If the internal repository has any forks, the visibility of the forks is already private.{% 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)"{% 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 %}{% endif %} * Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -* 今後、{% data variables.product.prodname_dotcom %} は {% 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 enterpriseServerVersions contains currentVersion %} +* {% data variables.product.prodname_dotcom %} will no longer include 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 enterpriseServerVersions contains currentVersion %} * 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 %} {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 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 fb63a24c2526..807f9b89911c 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,5 +1,5 @@ --- -title: SAMシングルサインオンで利用するためにSSHキーを認可する +title: SAMLシングルサインオンで利用するためにSSHキーを認可する intro: 'SAML シングルサインオン (SSO) を使う Organization で SSH キーを使うためには、まずそのキーを認可しなければなりません。' redirect_from: - /articles/authorizing-an-ssh-key-for-use-with-a-saml-single-sign-on-organization/ 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 49948643bf9f..f86a1862bb0e 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 @@ -38,7 +38,7 @@ versions: *スコープ*は、{% data variables.product.prodname_oauth_app %}がパブリックおよび非パブリックのデータにアクセスするためにリクエストできる権限の名前付きグループです。 -{% data variables.product.product_name %}と統合される {% data variables.product.prodname_oauth_app %}を使用したい場合、そのアプリケーションはデータに対してどういった種類のアクセスが必要になるのかを知らせてきます。 アプリケーションにアクセスを許可すれば、アプリケーションはあなたの代わりにデータの読み取りや変更といったアクションを行えるようになります。 たとえば `user:email` スコープをリクエストするアプリケーションを使用したい場合、そのアプリケーションはあなたのプライベートのメールアドレスに対してリードオンリーのアクセスを持つことになります。 詳しい情報については 、「[{% data variables.product.prodname_oauth_app %} のスコープについて](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)」を参照してください。 +{% data variables.product.product_name %}と統合される {% data variables.product.prodname_oauth_app %}を使用したい場合、そのアプリケーションはデータに対してどういった種類のアクセスが必要になるのかを知らせてきます。 アプリケーションにアクセスを許可すれば、アプリケーションはあなたの代わりにデータの読み取りや変更といったアクションを行えるようになります。 たとえば `user:email` スコープをリクエストするアプリケーションを使用したい場合、そのアプリケーションはあなたのプライベートのメールアドレスに対してリードオンリーのアクセスを持つことになります。 詳しい情報については 、「[{% data variables.product.prodname_oauth_app %} のスコープについて](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)」を参照してください。 {% tip %} 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 84da980b427c..b0c23b138e11 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 @@ -32,7 +32,7 @@ versions: *スコープ*は、アプリケーションがパブリックおよび非パブリックのデータへのアクセスをリクエストできる権限について名前を付けたグループです。 -{% data variables.product.product_name %} と統合するサードパーティアプリケーションを使用したい場合、そのアプリケーションは、データに対してどういった種類のアクセスが必要になるのかをあなたに通知します。 アプリケーションにアクセスを許可すれば、アプリケーションはあなたの代わりにデータの読み取りや変更といったアクションを行えるようになります。 たとえば `user:email` スコープをリクエストするアプリケーションを使用したい場合、そのアプリケーションはあなたのプライベートのメールアドレスに対してリードオンリーのアクセスを持つことになります。 詳しい情報については 、「[{% data variables.product.prodname_oauth_app %} のスコープについて](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)」を参照してください。 +{% data variables.product.product_name %} と統合するサードパーティアプリケーションを使用したい場合、そのアプリケーションは、データに対してどういった種類のアクセスが必要になるのかをあなたに通知します。 アプリケーションにアクセスを許可すれば、アプリケーションはあなたの代わりにデータの読み取りや変更といったアクションを行えるようになります。 たとえば `user:email` スコープをリクエストするアプリケーションを使用したい場合、そのアプリケーションはあなたのプライベートのメールアドレスに対してリードオンリーのアクセスを持つことになります。 詳しい情報については 、「[{% data variables.product.prodname_oauth_app %} のスコープについて](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)」を参照してください。 {% tip %} 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 0782e4f4d883..36d005c9a922 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 @@ -126,8 +126,8 @@ SSH キーを使用するたびにパスフレーズを再入力したくない 1. ssh-agent が実行されていることを確認します. 「[SSH キーパスフレーズで操作する](/articles/working-with-ssh-key-passphrases)」の「ssh-agent を自動起動する」の手順を使用するか、手動で開始できます。 ```shell - # ssh-agent をバックグラウンドで起動 - $ eval $(ssh-agent -s) + # start the ssh-agent in the background + $ eval `ssh-agent -s` > Agent pid 59566 ``` diff --git a/translations/ja-JP/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/ja-JP/content/github/authenticating-to-github/testing-your-ssh-connection.md index 9101ab7926dd..a50c3bf23585 100644 --- a/translations/ja-JP/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/ja-JP/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -31,7 +31,7 @@ SSH 接続をテストする前に、次のことを済ませておく必要が > Are you sure you want to continue connecting (yes/no)? ``` -3. 表示されているメッセージにあるフィンガープリントがステップ 2 のいずれかのメッセージに一致していることを確認し、`yes` と入力します: +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Hi username! You've successfully authenticated, but GitHub does not > provide shell access. 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 e30c6c434a1a..3dc609908689 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 @@ -38,7 +38,7 @@ versions: {% data reusables.pull_requests.resolving-conversations %} -### Re-requesting a review +### レビューを再リクエストする {% data reusables.pull_requests.re-request-review %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..17415f8bb75a --- /dev/null +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: プルリクエストを自動的にマージする +intro: 'プルリクエストの自動マージを有効にすると、すべてのマージ要件が満たされたときにプルリクエストが自動的にマージされるようになり、開発速度を上げることができます。' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### 自動マージについて + +プルリクエストの自動マージを有効にすると、必要なすべてのレビューを満たし、ステータスチェックに合格すると、プルリクエストが自動的にマージされます。 自動マージにより、要件が満たされるのを待つ必要がなくなるため、他のタスクに進むことができます。 + +プルリクエストで自動マージを使用する前に、リポジトリで自動マージを有効にする必要があります。 詳しい情報については、「[リポジトリ内のプルリクエストの自動マージを管理する](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)」を参照してください。 + +自動マージに関するフィードバックがある場合は、[お問い合わせ](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback)にご連絡ください。 + +### 自動マージの有効化 + +リポジトリへの書き込み権限を持つユーザは、プルリクエストの自動マージを有効化できます。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. [Pull Requests] リストで、自動マージするプルリクエストをクリックします。 +1. 必要に応じて、マージ方法を選択するには、[**Enable auto-merge**] ドロップダウンメニューを選択してから、マージ方法をクリックします。 詳しい情報については[プルリクエストのマージについて](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)を参照してください。 ![[Enable auto-merge] ドロップダウンメニュー](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. [**Enable auto-merge**] をクリックします。 ![自動マージを有効化するボタン](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. マージまたは squash とマージの方法を選択した場合は、コミットメッセージと説明を入力し、マージコミットを作成するメールアドレスを選択します。 ![コミットメッセージと説明を入力し、作者のメールをコミットするフィールド](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. [**Confirm auto-merge**] をクリックします。 ![自動マージを確認するボタン](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### 自動マージの無効化 + +リポジトリへの書き込み権限を持つユーザと、プルリクエストの作者であるユーザは、プルリクエストの自動マージを無効化できます。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. [Pull Requests] リストで、自動マージを無効化するプルリクエストをクリックします。 +1. マージボックスで、[**Disable auto-merge**] をクリックします。 ![自動マージを無効化するボタン](/assets/images/help/pull_requests/disable-auto-merge-button.png) diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md index b2b1a7f68463..ebee38330335 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md @@ -3,7 +3,7 @@ title: フォークからプルリクエストを作成する intro: プルリクエストを作成して、上流リポジトリのフォークに加えた変更を提案できます。 redirect_from: - /articles/creating-a-pull-request-from-a-fork -permissions: リポジトリへの書き込みアクセスを持つユーザであれば、ユーザ所有のフォークからプルリクエストを作成できます。 +permissions: Anyone with write access to a repository can create a pull request from a user-owned fork. versions: free-pro-team: '*' enterprise-server: '*' 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 5d70af478bb9..38764b520d1f 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 @@ -24,11 +24,11 @@ versions: {% note %} -**Note:** 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)." +**注釈:** 削除するブランチがリポジトリのデフォルトブランチである場合は、ブランチを削除する前に新しいデフォルトブランチを選択する必要があります。 For more information, see "[Changing the default branch](/github/administering-a-repository/changing-the-default-branch)." {% endnote %} -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/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 b0b62b4b2746..64eb7cfb4e13 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 @@ -10,11 +10,11 @@ versions: github-ae: '*' --- -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. +プルリクエスト内のファイルは、`.html` や `.js` などのファイル拡張子の種類、拡張子の欠如、コードの所有権、ドットファイルでフィルタリングできます。 {% tip %} -**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. +**ヒント:** ファイルのフィルタドロップダウンメニューから、プルリクエストの diff 内の削除されたファイル、または既に表示したファイルを一時的に非表示にして、プルリクエストの diff 表示を簡素化できます。 {% endtip %} 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 30f5d59fd8a5..36b86c6d05fb 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 @@ -25,7 +25,7 @@ versions: 4. コミットメッセージのフィールドに、ファイルに対する変更内容を説明する、短くわかりやすいコミットメッセージを入力します。 ![Commit messageフィールド](/assets/images/help/pull_requests/suggested-change-commit-message-field.png) 5. [**Commit changes**] をクリックします。 ![[Commit changes] ボタン](/assets/images/help/pull_requests/commit-changes-button.png) -### Re-requesting a review +### レビューを再リクエストする {% data reusables.pull_requests.re-request-review %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/index.md index 0c8ac02e31f0..5ef00094108f 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 bffbded5f360..94e785995f51 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 @@ -12,11 +12,13 @@ versions: ### プルリクエストのマージについて -プルリクエストでは、head ブランチに加えた変更をベースブランチにマージすることを提案します。 {% 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)を参照してください。 +プルリクエストでは、head ブランチに加えた変更をベースブランチにマージすることを提案します。 {% data reusables.pull_requests.about-protected-branches %}ただし、プルリクエストを特定のブランチにマージできるタイミングには制限がある場合があります。 たとえば、必須のステータスチェックに合格した場合にのみ、プルリクエストをデフォルトブランチにマージできます。 詳しい情報については[保護されたブランチについて](/github/administering-a-repository/about-protected-branches)を参照してください。 + +{% data reusables.pull_requests.you-can-auto-merge %} プルリクエストでマージコンフリクトが発生する場合、またはマージの前に変更をテストしたい場合は、コマンドラインを使用して、[プルリクエストをローカルでチェックアウト](/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,20 +47,20 @@ You can't merge a draft pull request. ドラフトのプルリクエストに関 {% note %} - **Note:** The email selector is not available for rebase merges, which do not create a merge commit, or for squash merges, which credit the user who created the pull request as the author of the squashed commit. + **注釈:** メールセレクタは、マージコミットを作成しないリベースマージ、またはプルリクエストを作成したユーザを squash コミットの作者としてクレジットする squash マージには使用できません。 {% endnote %} 6. [**Confirm merge**]、[**Confirm squash and merge**] をクリックするか、[**Confirm rebase and merge**] をクリックします。 6. また、代わりに[ブランチを削除](/articles/deleting-unused-branches)することもできます。 こうすることで、リポジトリにあるブランチのリストが整理された状態を保てます。 -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)」を参照してください。 +プルリクエストをマージするとプルリクエストの head ブランチが自動的に削除されるようにリポジトリを設定できます。 詳しい情報については「[ブランチの自動削除の管理](/github/administering-a-repository/managing-the-automatic-deletion-of-branches)」を参照してください。 {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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)." + **注釈:** {% data reusables.pull_requests.retargeted-on-branch-deletion %} + 詳しい情報については、「[ブランチについて](/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 48dbbc2e1c65..7ff29fded9ef 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 @@ -11,7 +11,7 @@ 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 ``` 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 e9d9c2b37dd1..095977c4f5e6 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 @@ -11,7 +11,7 @@ versions: ユーザアカウントが所有しているリポジトリのオーナーとコラボレータは、プルリクエストのレビューを割り当てることができます。 リポジトリに対するトリアージ権限を持つ Organization メンバーは、プルリクエストのレビューを割り当てることができます。 -オーナーまたはコラボレータは、ユーザ所有のリポジトリに明示的に[読み取りアクセス](/articles/access-permissions-on-github)を付与された人にプルリクエストのレビューを割り当てることができます。 Organization メンバーは、リポジトリの読み取りアクセス権を持つ人や Team にプルリクエストのレビューを割り当てることができます。 リクエストされたレビュー担当者または Team は、Pull Request レビューをするようあなたが依頼したという通知を受け取ります。 {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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 %} +オーナーまたはコラボレータは、ユーザ所有のリポジトリに明示的に[読み取りアクセス](/articles/access-permissions-on-github)を付与された人にプルリクエストのレビューを割り当てることができます。 Organization メンバーは、リポジトリの読み取りアクセス権を持つ人や Team にプルリクエストのレビューを割り当てることができます。 リクエストされたレビュー担当者または Team は、Pull Request レビューをするようあなたが依頼したという通知を受け取ります。 {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@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 %} {% 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 80ebb89bb7be..95e57170f31f 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 @@ -12,18 +12,18 @@ versions: {% data variables.product.product_name %}で解決できるマージコンフリクトは、Git リポジトリの別々のブランチで、同じファイルの同じ行に異なる変更がなされた場合など、互いに矛盾する行変更を原因とするもののみです。 その他すべての種類のマージ コンフリクトについては、コマンド ラインでコンフリクトをローカルに解決する必要があります。 詳細は「[コマンド ラインを使用してマージコンフリクトを解決する](/articles/resolving-a-merge-conflict-using-the-command-line)」を参照してください。 {% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@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. たとえば、マージ コンフリクト エディターが無効な場合、フォークと上流リポジトリの間の Pull Request ではそれを使用できません。 +サイト管理者がリポジトリ間のプルリクエストのマージコンフリクトエディタを無効にすると、 +{% data variables.product.product_name %} でコンフリクトエディタを使用できず、コマンドラインでマージコンフリクトを解決する必要があります。 たとえば、マージ コンフリクト エディターが無効な場合、フォークと上流リポジトリの間の Pull Request ではそれを使用できません。 {% 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. このブランチにコミットすることが間違いでないことを確認してください。 +**警告:** マージコンフリクトを +{% data variables.product.product_name %} で解決すると、[head ブランチ](/github/getting-started-with-github/github-glossary#head-branch)がリポジトリのデフォルトブランチまたは保護されたブランチであっても、プルリクエストの[ベースブランチ](/github/getting-started-with-github/github-glossary#base-branch)全体が head ブランチにマージされます。 このブランチにコミットすることが間違いでないことを確認してください。 {% 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). このブランチにコミットすることが間違いでないことを確認してください。 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)を参照してください。 +**警告:** マージコンフリクトを +{% data variables.product.product_name %} でマージコンフリクト解決すると、プルリクエストの[ベースブランチ](/github/getting-started-with-github/github-glossary#base-branch)全体が [head ブランチ](/github/getting-started-with-github/github-glossary#head-branch)にマージされます。 このブランチにコミットすることが間違いでないことを確認してください。 head ブランチがリポジトリのデフォルトブランチである場合、プルリクエストの head ブランチとして機能する新しいブランチを作成するオプションが表示されます。 head ブランチが保護されている場合、コンフリクトの解決をマージすることができないため、新しい head ブランチを作成するように求められます。 詳しい情報については[保護されたブランチについて](/github/administering-a-repository/about-protected-branches)を参照してください。 {% endif %} {% endwarning %} @@ -34,7 +34,7 @@ If a site administrator disables the merge conflict editor for pull requests bet {% tip %} - **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 enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} or the site administrator has disabled the conflict editor for pull requests between repositories{% endif %}. 別の Git クライアントを使用するか、コマンドラインで Git を使用して、マージのコンフリクトを解決する必要があります。 詳細は「[コマンド ラインを使用してマージコンフリクトを解決する](/articles/resolving-a-merge-conflict-using-the-command-line)」を参照してください。 + **ヒント:** [**Resolve conflicts**] ボタンが無効になっている場合、プルリクエストのマージコンフリクトが複雑すぎて {% data variables.product.product_name %}{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} で解決できないか、サイト管理者がリポジトリ間のプルリクエストのコンフリクトエディタを無効にしています{% endif %}。 別の Git クライアントを使用するか、コマンドラインで Git を使用して、マージのコンフリクトを解決する必要があります。 詳細は「[コマンド ラインを使用してマージコンフリクトを解決する](/articles/resolving-a-merge-conflict-using-the-command-line)」を参照してください。 {% endtip %} {% data reusables.pull_requests.decide-how-to-resolve-competing-line-change-merge-conflict %} diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md index b55ac06e48e8..064c72b73a00 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md @@ -1,74 +1,74 @@ --- -title: Reviewing dependency changes in a pull request -intro: 'If a pull request contains changes to dependencies, you can view a summary of what has changed and whether there are known vulnerabilities in any of the dependencies.' +title: プルリクエスト内の依存関係の変更をレビューする +intro: 'プルリクエストに依存関係への変更が含まれている場合は、変更内容の概要と、依存関係に既知の脆弱性があるかどうかを確認できます。' versions: free-pro-team: '*' --- {% note %} -**Note:** Dependency review is currently in beta and subject to change. +**注釈:** 依存関係のレビューは現在ベータであり、変更される可能性があります。 {% endnote %} -### About dependency review +### 依存関係のレビューについて -If a pull request targets your repository's default branch and contains changes to package manifests or lock files, you can display a dependency review to see what has changed. The dependency review includes details of changes to indirect dependencies in lock files, and it tells you if any of the added or updated dependencies contain known vulnerabilities. +プルリクエストがリポジトリのデフォルトブランチを対象とし、パッケージマニフェストまたはロックファイルへの変更が含まれている場合は、依存関係のレビューを表示して、何が変更されたかを確認できます。 依存関係のレビューには、ロックファイル内の間接的な依存関係への変更の詳細が含まれ、追加または更新された依存関係のいずれかに既知の脆弱性が含まれているかどうかが示されます。 -Dependency review is available in: +依存関係のレビューは次の項目で確認できます。 -* All public repositories. -* Private repositories owned by organizations with an {% data variables.product.prodname_advanced_security %} license that have the dependency graph enabled. For more information, see "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." +* すべてのパブリックリポジトリ +* 依存関係グラフが有効になっている {% data variables.product.prodname_advanced_security %} ライセンスを持つ Organization が所有するプライベートリポジトリ。 詳しい情報については、「[リポジトリの依存関係を調べる](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)」を参照してください。 -Sometimes you might just want to update the version of one dependency in a manifest and generate a pull request. However, if the updated version of this direct dependency also has updated dependencies, your pull request may have more changes than you expected. The dependency review for each manifest and lock file provides an easy way to see what has changed, and whether any of the new dependency versions contain known vulnerabilities. +時に、マニフェスト内の 1 つの依存関係のバージョンを更新して、プルリクエストを生成することがあります。 ただし、この直接依存関係の更新バージョンでも依存関係が更新されている場合は、プルリクエストに予想よりも多くの変更が加えられている可能性があります。 各マニフェストとロックファイルの依存関係のレビューにより、何が変更されたか、新しい依存関係バージョンのいずれかに既知の脆弱性が含まれているかどうかを簡単に確認できます。 -By checking the dependency reviews in a pull request, and changing any dependencies that are flagged as vulnerable, you can avoid vulnerabilities being added to your project. {% data variables.product.prodname_dependabot_alerts %} will find vulnerabilities that are already in your dependencies, but it's much better to avoid introducing potential problems than to fix them at some later date. 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#dependabot-alerts-for-vulnerable-dependencies)." +プルリクエストで依存関係のレビューを確認し、脆弱性としてフラグが付けられている依存関係を変更することで、プロジェクトに脆弱性が追加されるのを防ぐことができます。 {% data variables.product.prodname_dependabot_alerts %} は、すでに依存関係にある脆弱性を検出しますが、あとで修正するよりも、潜在的な問題の発生を回避した方がはるかに良いです。 {% data variables.product.prodname_dependabot_alerts %} に関する詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies#dependabot-alerts-for-vulnerable-dependencies)」を参照してください。 -Dependency review supports the same languages and package management ecosystems as the dependency graph. 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)」を参照してください。 +依存関係のレビューは、依存関係グラフと同じ言語とパッケージ管理エコシステムをサポートしています。 詳しい情報については、「[依存関係グラフについて](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)」を参照してください。 -### Reviewing dependencies in a pull request +### プルリクエスト内の依存関係を確認する {% data reusables.repositories.sidebar-pr %} {% data reusables.repositories.choose-pr-review %} {% data reusables.repositories.changed-files %} -1. If the pull request contains many files, use the **File filter** drop-down menu to collapse all files that don't record dependencies. This will make it easier to focus your review on the dependency changes. +1. プルリクエストに多数のファイルが含まれている場合は、[**File filter**] ドロップダウンメニューを使用して、依存関係を記録しないすべてのファイルを折りたたみます。 これにより、レビューを依存関係の変更に焦点を絞りやすくなります。 - ![The file filter menu](/assets/images/help/pull_requests/file-filter-menu-json.png) + ![ファイルフィルタメニュー](/assets/images/help/pull_requests/file-filter-menu-json.png) -1. On the right of the header for a manifest or lock file, display the dependency review by clicking the rich diff button. +1. マニフェストまたはロックファイルのヘッダの右側で、リッチ diff ボタンをクリックして依存関係のレビューを表示します。 - ![The rich diff button](/assets/images/help/pull_requests/dependency-review-rich-diff.png) + ![リッチ diff ボタン](/assets/images/help/pull_requests/dependency-review-rich-diff.png) {% note %} - **Note:** The dependency review provides a clearer view of what has changed in large lock files, where the source diff is not rendered by default. + **注釈:** 依存関係のレビューでは、ソース diff がデフォルトでレンダリングされない大きなロックファイルで何が変更されたかをより明確に確認できます。 {% endnote %} -1. Check the dependencies listed in the dependency review. +1. 依存関係のレビューにリストされている依存関係を確認します。 - ![Vulnerability warnings in a dependency review](/assets/images/help/pull_requests/dependency-review-vulnerability.png) + ![依存関係のレビューにおける脆弱性の警告](/assets/images/help/pull_requests/dependency-review-vulnerability.png) - Any added or changed dependencies that have vulnerabilities are listed first, ordered by severity and then by dependency name. This means that the highest severity dependencies are always at the top of a dependency review. Other dependencies are listed alphabetically by dependency name. + 脆弱性のある追加または変更された依存関係が最初に一覧表示され、次に重要度、依存関係名の順に並べられます。 これは、最も重要度の高い依存関係が、常に依存関係レビューの最上位に表示されるということです。 その他の依存関係は、依存関係名のアルファベット順に一覧表示されます。 - The icon beside each dependency indicates whether the dependency has been added ({% octicon "diff-added" aria-label="Dependency added icon" %}), updated ({% octicon "diff-modified" aria-label="Dependency modified icon" %}), or removed ({% octicon "diff-removed" aria-label="Dependency removed icon" %}) in this pull request. + 各依存関係の横にあるアイコンは、このプルリクエストで依存関係が追加された ({% octicon "diff-added" aria-label="Dependency added icon" %})、更新された ({% octicon "diff-modified" aria-label="Dependency modified icon" %})、削除された ({% octicon "diff-removed" aria-label="Dependency removed icon" %}) ことを示しています。 - Other information includes: + その他の情報は次のとおりです。 - * The version, or version range, of the new, updated, or deleted dependency. - * For a specific version of a dependency: - * The age of that release of the dependency. - * The number of projects that are dependent on this software. This information is taken from the dependency graph. Checking the number of dependents can help you avoid accidentally adding the wrong dependency. - * The license used by this dependency, if this information is available. This is useful if you want to avoid code with certain licenses being used in your project. + * 新規、更新、または削除された依存関係のバージョンまたはバージョン範囲。 + * 依存関係の特定のバージョンの場合: + * 依存関係のリリース時期。 + * このソフトウェアに依存しているプロジェクトの数。 この情報は、依存関係グラフから取得されます。 依存関係の数を確認すると、誤って間違った依存関係を追加することを防ぐことができます。 + * この依存関係で使用されるライセンス（この情報が利用可能な場合）。 これは、プロジェクトで特定のライセンスが使用されているコードを避ける必要がある場合に役立ちます。 - Where a dependency has a known vulnerability, the warning message includes: + 依存関係に既知の脆弱性がある場合、警告メッセージには次のものが含まれます。 - * A brief description of the vulnerability. - * A Common Vulnerabilities and Exposures (CVE) or {% data variables.product.prodname_security_advisories %} (GHSA) identification number. You can click this ID to find out more about the vulnerability. - * The severity of the vulnerability. - * The version of the dependency in which the vulnerability was fixed. If you are reviewing a pull request for someone, you might ask the contributor to update the dependency to the patched version, or a later release. + * 脆弱性の簡単な説明。 + * Common Vulnerabilities and Exposures (CVE) または {% data variables.product.prodname_security_advisories %} (GHSA) 識別番号。 この ID をクリックすると、脆弱性の詳細を確認できます。 + * 脆弱性の重要度。 + * 脆弱性が修正された依存関係のバージョン。 誰かのプルリクエストを確認している場合は、パッチを適用したバージョンまたはそれ以降のリリースに依存関係を更新するようにコントリビューターに依頼することができます。 -1. You can return to the original view of the file by clicking the source diff button. +1. ソースの diff ボタンをクリックすると、ファイルの元のビューに戻ることができます。 - ![The source diff button](/assets/images/help/pull_requests/dependency-review-source-diff.png) + ![ソース diff ボタン](/assets/images/help/pull_requests/dependency-review-source-diff.png) 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 5a580742395f..3ee02dedaa04 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 @@ -11,7 +11,7 @@ versions: ### プルリクエストのレビューについて -プルリクエストの変更は、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. +プルリクエストの変更は、1 ファイルごとにレビューできます。 プルリクエストでファイルを確認しているときに、特定の変更について個別のコメントを残すことができます。 各ファイルの確認が終了したら、ファイルを閲覧済みとしてマークできます。 これによりファイルが折りたたまれるので、まだレビューを必要とするファイルを特定するのに役立ちます。 プルリクエストヘッダのプログレスバーには、閲覧したファイル数が表示されます。 必要な数のファイルを確認した後、要約コメントを付けて確認を送信することにより、プルリクエストを承認するか、追加の変更をリクエストできます。 {% data reusables.search.requested_reviews_search_tip %} @@ -30,15 +30,15 @@ versions: ![[Cancel review] ボタン](/assets/images/help/pull_requests/cancel-review-button.png) {% if currentVersion == "free-pro-team@latest" %} -### Reviewing dependency changes +### 依存関係の変更をレビューする -If the pull request contains changes to dependencies you can use the dependency review for a manifest or lock file to see what has changed and check whether the changes introduce security vulnerabilities. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." +プルリクエストに依存関係への変更が含まれている場合は、マニフェストまたはロックファイルの依存関係のレビューを使用して、何が変更されたかを確認し、変更によるセキュリティの脆弱性の発生の有無を確認できます。 For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." {% data reusables.repositories.changed-files %} -1. On the right of the header for a manifest or lock file, display the dependency review by clicking the rich diff button. +1. マニフェストまたはロックファイルのヘッダの右側で、リッチ diff ボタンをクリックして依存関係のレビューを表示します。 - ![The rich diff button](/assets/images/help/pull_requests/dependency-review-rich-diff.png) + ![リッチ diff ボタン](/assets/images/help/pull_requests/dependency-review-rich-diff.png) {% endif %} ### ファイルをレビュー済みとしてマークする diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md index a8005de23912..92d18b099b75 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/syncing-a-fork.md @@ -13,7 +13,7 @@ versions: {% data reusables.command_line.open_the_multi_os_terminal %} 2. ワーキングディレクトリをローカルプロジェクトに変更します。 -3. 上流リポジトリから、ブランチと各ブランチのコミットをフェッチします。 Commits to `BRANCHNAME` will be stored in the local branch `upstream/BRANCHNAME`. +3. 上流リポジトリから、ブランチと各ブランチのコミットをフェッチします。 `BRANCHNAME` へのコミットは、ローカルブランチ `upstream/BRANCHNAME` に保存されます。 ```shell $ git fetch upstream > remote: Counting objects: 75, done. @@ -23,12 +23,12 @@ versions: > From https://{% data variables.command_line.codeblock %}/ORIGINAL_OWNER/ORIGINAL_REPOSITORY > * [new branch] main -> upstream/main ``` -4. Check out your fork's local default branch - in this case, we use `main`. +4. フォークのローカルのデフォルトブランチを確認してください。この場合は、`main` を使用します。 ```shell $ git checkout main > Switched to branch 'main' ``` -5. Merge the changes from the upstream default branch - in this case, `upstream/main` - into your local default branch. This brings your fork's default branch into sync with the upstream repository, without losing your local changes. +5. 上流のデフォルトブランチ (この場合は `upstream/main`) からの変更をローカルのデフォルトブランチにマージします。 これにより、ローカルの変更を失うことなく、フォークのデフォルトブランチが上流リポジトリと同期されます。 ```shell $ git merge upstream/main > Updating a422352..5fdff0f diff --git a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md index c84f34c0b486..e3ea8141efbe 100644 --- a/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md +++ b/translations/ja-JP/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md @@ -56,7 +56,7 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -#### Changing the visibility of an internal repository +#### 内部リポジトリの表示を変更する {% note %} @@ -64,11 +64,11 @@ versions: {% endnote %} -If the policy for your enterprise permits forking, any fork of an internal repository will be private. If you change the visibility of an internal repository, any fork owned by an organization or user account will remain private. +Enterprise のポリシーでフォークが許可されている場合、内部リポジトリのフォークはすべてプライベートになります。 内部リポジトリの表示を変更した場合、Organization またはユーザアカウントが所有するフォークはすべてプライベートのままになります。 -##### Deleting the internal repository +##### 内部リポジトリを削除する -If you change the visibility of an internal repository and then delete the repository, the forks will continue to exist in a separate network. +内部リポジトリの表示を変更してからリポジトリを削除すると、フォークは別のネットワークに引き続き存在します。 {% endif %} @@ -78,4 +78,4 @@ If you change the visibility of an internal repository and then delete the repos - [フォークについて](/articles/about-forks) - 「[リポジトリのフォークポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」 - 「[Organization のフォークポリシーを管理する](/github/setting-up-and-managing-organizations-and-teams/managing-the-forking-policy-for-your-organization)」 -- "{% if currentVersion == "free-pro-team@latest" %}[Enforcing repository management policies in your enterprise account](/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-forking-private-or-internal-repositories){% else %}[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-on-forking-private-or-internal-repositories){% endif %}" +- 「{% if currentVersion == "free-pro-team@latest" %}[Enterprise アカウントでリポジトリ管理ポリシーを施行する](/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-forking-private-or-internal-repositories)」{% else %}「[Enterprise でリポジトリ管理ポリシーを施行する](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-on-forking-private-or-internal-repositories){% endif %}」 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 309effd0a63c..d11a128b1c2e 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 @@ -296,7 +296,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Accessing private repositories -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)." +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 `ghost/foo`, `ghost/bar`, and `ghost/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. 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 index 3a60666fafea..3664ed3528d5 100644 --- 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 @@ -54,7 +54,7 @@ On Windows, the `codeql-runner-win.exe` file usually requires no change to permi 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 +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux chmod +x codeql-runner-linux ``` @@ -129,7 +129,7 @@ This example is similar to the previous example, however this time the repositor > ... > 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 " + Please export these variables to future processes so that CodeQL can monitor the build, for example by running " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` 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 18cc715585ab..379146676ac8 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 @@ -83,7 +83,7 @@ versions: | キーボードショートカット | 説明 | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -| c | Issue を作成します | +| c | Issueの作成 | | control / または command / | Issue またはプルリクエストの検索バーにカーソルを合わせます。 詳細は「[検索を使用して Issue およびプルリクエストをフィルタリングする](/articles/using-search-to-filter-issues-and-pull-requests)」を参照してください。 | | u | 作者によりフィルタリングします | | l | ラベルによりフィルタリグするか、ラベルを編集します。 詳細は「[Issue およびプルリクエストをラベルでフィルタリングする](/articles/filtering-issues-and-pull-requests-by-labels)」を参照してください。 | diff --git a/translations/ja-JP/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md b/translations/ja-JP/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md index ed39ca2f3502..e07ab4a80476 100644 --- a/translations/ja-JP/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md +++ b/translations/ja-JP/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md @@ -1,6 +1,6 @@ --- title: 新しい GitHub アカウントへのサインアップ -shortTitle: Sign up for a new GitHub account +shortTitle: 新しい GitHub アカウントへのサインアップ intro: '{% data variables.product.product_name %} は、人々が協力して作業するチームのために個人および Organization のユーザアカウントを提供します。' redirect_from: - /articles/signing-up-for-a-new-github-account diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md index 26b9a33fd4f0..9ff290102787 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md @@ -17,7 +17,7 @@ By checking the dependency reviews on pull requests you can avoid introducing vu {% data variables.product.prodname_dotcom %} can create {% data variables.product.prodname_dependabot_alerts %} when it detects vulnerable dependencies in your repository. The alert is displayed on the Security tab for the repository. The alert includes a link to the affected file in the project, and information about a fixed version. {% data variables.product.prodname_dotcom %} also notifies the maintainers of the repository, according to their notification preferences. 詳しい情報については、「[脆弱性のある依存関係に対するアラートについて](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 #### {% data variables.product.prodname_dependabot_security_updates %} -When {% data variables.product.prodname_dotcom %} generates a {% data variables.product.prodname_dependabot %} alert for a vulnerable dependency in your repository, {% data variables.product.prodname_dependabot %} can automatically try to fix it for you. {% data variables.product.prodname_dependabot_security_updates %} are automatically generated pull requests that update a vulnerable dependency to a fixed version. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." +When {% data variables.product.prodname_dotcom %} generates a {% data variables.product.prodname_dependabot %} alert for a vulnerable dependency in your repository, {% data variables.product.prodname_dependabot %} can automatically try to fix it for you. {% data variables.product.prodname_dependabot_security_updates %} are automatically generated pull requests that update a vulnerable dependency to a fixed version. 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 #### {% data variables.product.prodname_dependabot_version_updates %} diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md index 7c3f8d29774f..e4cc7ae2629c 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md @@ -13,7 +13,7 @@ versions: ### About configuring {% data variables.product.prodname_dependabot_security_updates %} -You can enable {% data variables.product.prodname_dependabot_security_updates %} for any repository that uses {% data variables.product.prodname_dependabot_alerts %} and the dependency graph. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." +You can enable {% data variables.product.prodname_dependabot_security_updates %} for any repository that uses {% data variables.product.prodname_dependabot_alerts %} and the dependency graph. 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 個々のリポジトリ、またはユーザアカウントまたは Organization が所有するすべてのリポジトリに対して {% data variables.product.prodname_dependabot_security_updates %} を無効にすることができます。 詳しい情報については、以下の「[リポジトリの {% data variables.product.prodname_dependabot_security_updates %} を管理する](#managing-dependabot-security-updates-for-your-repositories)」を参照してください。 diff --git a/translations/ja-JP/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md b/translations/ja-JP/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md index 633522ee1f1f..fd90c14644ff 100644 --- a/translations/ja-JP/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md +++ b/translations/ja-JP/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md @@ -11,7 +11,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 %} と依存関係グラフを使用するリポジトリの自動セキュリティ更新を有効にすることができます。 For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." +{% data variables.product.prodname_dependabot_alerts %} と依存関係グラフを使用するリポジトリの自動セキュリティ更新を有効にすることができます。 詳しい情報については、「[{% data variables.product.prodname_dependabot_security_updates %} について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 {% data reusables.repositories.dependency-review %} 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 74287c9c48c1..4b1f265a45c0 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: 通知を設定する -intro: '通知を受信する {% data variables.product.product_name %} のアクティビティのタイプと、これらの更新の配信方法を選択します。' +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.' redirect_from: - /articles/about-web-notifications - /format-of-notification-emails/ @@ -19,7 +19,7 @@ versions: github-ae: '*' --- -### 通知配信オプション +### Notification delivery options You can receive notifications for activity on {% data variables.product.product_name %} in the following locations. @@ -33,41 +33,39 @@ You can receive notifications for activity on {% data variables.product.product_ {% data reusables.notifications.shared_state %} -#### 通知インボックスの利点 +#### 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: - - 複数の通知を一括でトリアージする。 - - 完了した通知を**完了**としてマークし、インボックスから削除する。 **完了**としてマークされたすべての通知を表示するには、`is:done` クエリを使用します。 - - 後で確認するために通知を保存する。 保存した通知にはインボックスでフラグが付けられ、無期限に保持されます。 保存した通知をすべて表示するには、`is:saved` クエリを使用します。 - - サブスクライブ解除して、インボックスから通知を削除する。 - - 通知が、通知インボックスから {% data variables.product.product_name %} で発生する Issue、プルリクエスト、または Team ディスカッションをプレビューする。 - - インボックスから `reasons` ラベルが付いた通知を受信する最新の理由の1つを確認する。 - - カスタムフィルタを作成して、必要なときにさまざまな通知にフォーカスする。 - - インボックスの通知をリポジトリまたは日付別にグループ化して、コンテキストの切り替えを減らし、概要をすばやく確認する。 + - 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 {% 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. インボックスの保持ポリシーの詳細については、「[通知について](/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. For more information about your inbox's retention policy, see "[About notifications](/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)." -### 参加と Watch 対象の通知について +### 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. 詳しい情報については[Team ディスカッションについて](/github/building-a-strong-community/about-team-discussions)を参照してください。 +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. For more information, see "[About team discussions](/github/building-a-strong-community/about-team-discussions)." -To see repositories that you're watching, go to your [watching page](https://github.com/watching). 詳しい情報については「[GitHub上でのサブスクリプションと通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)」を参照してください。 +To see repositories that you're watching, go to your [watching page](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)." {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} -#### 通知を設定する +#### Configuring notifications {% endif %} -You can configure notifications for a repository on the repository page, or on your watching page. -{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} You can choose to only receive notifications for releases in a repository, or ignore all notifications for a repository.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +You can configure notifications for a repository on the repository page, or on your watching page.{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} You can choose to only receive notifications for releases in a repository, or ignore all notifications for a repository.{% endif %}{% if currentVersion == "free-pro-team@latest" %} #### About custom notifications {% data reusables.notifications-v2.custom-notifications-beta %} @@ -81,15 +79,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) -例: - - 通知をメールに送信しない場合は、[**Email**] をオフにして、参加と Watch 対象の通知を行います。 - - 会話に参加したときにメールで通知を受信する場合は、[Participating] の下の [**Email**] を選択します。 +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". 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 -メール通知を有効化すると、{% data variables.product.product_name %} はコンテンツを HTML とプレーンテキストの両方で含むマルチパートのメールとして通知を送信します。 メール通知のコンテンツには、{% data variables.product.product_name %} のオリジナルのコンテンツに含まれる Markdown、@メンション、絵文字、ハッシュリンクなどがすべて含まれます。 メールでテキストだけを見たいなら、プレーンテキストのコピーだけを表示するようにメールクライアントを設定できます。 +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 reusables.notifications.outbound_email_tip %} @@ -97,17 +95,17 @@ If you do not enable watching or participating notifications for web{% if curren {% if currentVersion == "free-pro-team@latest" %} -Gmailを使っているなら、通知メールの横にあるボタンをクリックして、通知を生成したオリジナルのIssueあるいはプルリクエストにアクセスできます。 +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のボタン](/assets/images/help/notifications/gmail-buttons.png) +![Buttons 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: - - Issue やプルリクエストへのコメント。 - - プルリクエストのレビュー. - - プルリクエストのプッシュ。 - - Issue やプルリクエストのオープン、コメント、クローズなどの、自分自身の操作による更新。 + - 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. Depending on the organization that owns the repository, you can also send notifications to different email addresses. 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)." @@ -115,34 +113,34 @@ You can also send notifications for a specific repository to an email address. F {% data reusables.notifications-v2.email-notification-caveats %} -### メール通知のフィルタリング +### Filtering email notifications -{% data variables.product.product_name %} が送信する各メール通知には、ヘッダ情報が含まれています。 各メールのヘッダ情報には一貫性があるので、それを使ってメールクライアントですべての {% data variables.product.product_name %} 通知あるいは特定の種類の {% data variables.product.product_name %} 通知をフィルタリングしたりフォワードしたりできます。 +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. 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. -{% data variables.product.product_name %} からのメール通知には、以下のヘッダ情報が含まれています: +Email notifications from {% data variables.product.product_name %} contain the following header information: -| ヘッダ | 情報 | -| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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` フィールド | This field connects directly to the thread.{% if currentVersion != "github-ae@latest" %} If you reply to the email, you'll add a new comment to the conversation.{% endif %} -| `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 にプルリクエストのレビューがリクエストされました。
      • {% if currentVersion != "github-ae@latest" %}
    • `security_alert`: {% data variables.product.prodname_dotcom %} は、受信者がセキュリティのアラートを受け取るリポジトリに脆弱性を検出しました。
      • {% endif %}
    • `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 %} +| 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 currentVersion != "github-ae@latest" %} If you reply to the email, you'll add a new comment to the conversation.{% endif %} | +| `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.
      • {% if currentVersion != "github-ae@latest" %}
    • `security_alert`: {% data variables.product.prodname_dotcom %} detected a vulnerability in a repository you receive alerts for.
      • {% endif %}
    • `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 %} -### 通知設定を選択する +### Choosing your notification settings {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -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 %} 通知オプション](#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 %} +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 %} notification options](#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 %} -### 自動 Watch +### 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. @@ -150,70 +148,72 @@ 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. -### Organization のメール通知の送信先を選択する +### Choosing where your organization’s email notifications are sent -Organization に所属している場合、Organization のアクティビティに関する通知の送信先にするメールアカウントを指定できます。 たとえば、職場の 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. {% data reusables.notifications-v2.email-notification-caveats %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} -3. [Default notification email] で、通知の送信先にするメールアドレスを選択します。 - ![デフォルトの通知メールアドレスのドロップダウン](/assets/images/help/notifications/notifications_primary_email_for_orgs.png) -4. [**Save**] をクリックします。 +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**. -#### Organization ごとにメールの送信先を設定する +#### 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. [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) +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) {% if currentVersion != "github-ae@latest" %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_dependabot_alerts %} の通知オプション +### {% data variables.product.prodname_dependabot_alerts %} notification options {% else %} -### Security alert options +### Security alert notification options {% endif %} {% data reusables.notifications.vulnerable-dependency-notification-delivery-method-customization %} {% data reusables.notifications.vulnerable-dependency-notification-options %} -For more information about the notification delivery methods available to you, and advice on optimizing your 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 %}, see "[Configuring notifications for vulnerable dependencies](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)." +For more information about the notification delivery methods available to you, and advice on optimizing your 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 %}, see "[Configuring notifications for vulnerable dependencies](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)." {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -### {% data variables.product.prodname_actions %} の通知オプション +### {% data variables.product.prodname_actions %} notification options 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_dependabot_short %} アラートオプション](/assets/images/help/notifications-v2/github-actions-notification-options.png) + ![Notification options for {% data variables.product.prodname_actions %}](/assets/images/help/notifications-v2/github-actions-notification-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} -### {% data variables.product.prodname_mobile %} でプッシュ通知を有効にする +### Enabling push notifications with {% data variables.product.prodname_mobile %} -{% data variables.product.prodname_mobile %} をインストールすると、自動的に Web 通知が有効になります。 You can then enable push notifications for direct mentions within the app. +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. You can only receive notifications for pushes to repositories on {% data variables.product.prodname_mobile %} at this time. -#### {% data variables.product.prodname_ios %} でプッシュ通知を有効にする +#### Enabling push notifications with {% data variables.product.prodname_ios %} -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**] の切り替えを使用します。 +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. -#### {% data variables.product.prodname_android %} でプッシュ通知を有効にする +#### Enabling push notifications with {% data variables.product.prodname_android %} -1. [Home] の上にあるプロフィール画像をタップします。 -2. 設定を表示するには、{% octicon "gear" aria-label="The Gear icon" %} をタップします。 ![GitHub Android 版の設定アイコン](/assets/images/help/mobile/android-settings-icon.png) -3. 直接メンションのプッシュ通知をオンにするには、[**Direct mentions**] の切り替えを使用します。 +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. {% endif %} 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 4700a65188e8..d312bb24fa0e 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: 'Use your inbox to quickly triage and sync your notifications across email{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}.' +intro: 'インボックスを使用して、メール{% if currentVersion == "free-pro-team@latest" %}とモバイル{% endif %}間で通知をすばやくトリアージして同期します。' redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later @@ -13,24 +13,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) インボックスには、登録を解除していないか、**Done** とマークされていないすべての通知が表示されます。ワークフローに対して最適な形になるよう、フィルタを使用してインボックスをカスタマイズし、すべてまたは未読の通知を表示して、通知をグループ化することで概要をすばやく確認できます。 - ![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 +42,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. +デフォルトでは、インボックスには、割り当てられたとき、スレッドに参加したとき、プルリクエストの確認をリクエストされたとき、ユーザ名が直接 @メンションされたとき、またはメンバーになっている Team が @メンションされたときのフィルタがあります。 - ![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,44 +77,44 @@ You can add up to 15 of your own custom filters. ### カスタムフィルタの制限 -Custom filters do not currently support: +カスタムフィルタは現在、以下をサポートしていません。 - プルリクエストや Issue のタイトルの検索を含む、インボックスでの全文検索。 - `is:issue`、`is:pr`、および `is:pull-request` クエリフィルタの区別。 これらのクエリは、Issue とプルリクエストの両方を検索結果として表示します。 - 15 個以上のカスタムフィルタの作成。 - デフォルトのフィルタまたはその順序の変更。 - - Search [exclusion](/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results) using `NOT` or `-QUALIFIER`. + - `NOT` または `-QUALIFIER` を使用した [exclusion](/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results) の検索。 ### カスタムフィルタでサポートされているクエリ -There are three types of filters that you can use: +使用できるフィルタには、次の 3 種類があります。 - `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 Organization が所有する 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:assign` | 割り当てられている Issue またはプルリクエストに更新があるとき。 | -| `reason:author` | プルリクエストまたは Issue を開くと、更新または新しいコメントがあったとき。 | -| `reason:comment` | Issue、プルリクエスト、または Team ディスカッションにコメントしたとき。 | -| `reason:participating` | Issue、プルリクエスト、Team ディスカッションについてコメントしたり、@メンションされているとき。 | -| `reason:invitation` | Team、Organization、またはリポジトリに招待されたとき。 | -| `reason:manual` | まだサブスクライブしていない Issue またはプルリクエストで [**Subscribe**] をクリックしたとき。 | -| `reason:mention` | 直接@メンションされたとき。 | -| `reason:review-requested` | You or a team you're on have been requested to review a pull request.{% if currentVersion != "github-ae@latest" %} -| `reason:security-alert` | When a security alert is issued for a repository.{% endif %} -| `reason:state-change` | プルリクエストまたは Issue の状態が変更されたとき。 たとえば、Issue がクローズされたり、プルリクエストがマージされた場合です。 | -| `reason:team-mention` | メンバーになっている Team が@メンションされたとき。 | -| `reason:ci-activity` | リポジトリに、新しいワークフロー実行ステータスなどの CI 更新があるとき。 | +更新を受信した理由で通知をフィルタするには、`reason:` クエリを使用できます。 たとえば、自分 (または自分が所属する Team) がプルリクエストのレビューをリクエストされたときに通知を表示するには、`reason:review-requested` を使用します。 詳しい情報については、「[通知について](/github/managing-subscriptions-and-notifications-on-github/about-notifications#reasons-for-receiving-notifications)」を参照してください。 + +| クエリ | 説明 | +| ------------------------- | -------------------------------------------------------------------------------------------- | +| `reason:assign` | 割り当てられている Issue またはプルリクエストに更新があるとき。 | +| `reason:author` | プルリクエストまたは Issue を開くと、更新または新しいコメントがあったとき。 | +| `reason:comment` | Issue、プルリクエスト、または Team ディスカッションにコメントしたとき。 | +| `reason:participating` | Issue、プルリクエスト、Team ディスカッションについてコメントしたり、@メンションされているとき。 | +| `reason:invitation` | Team、Organization、またはリポジトリに招待されたとき。 | +| `reason:manual` | まだサブスクライブしていない Issue またはプルリクエストで [**Subscribe**] をクリックしたとき。 | +| `reason:mention` | 直接@メンションされたとき。 | +| `reason:review-requested` | 自分または参加している Team が、プルリクエストを確認するようにリクエストされているとき。{% if currentVersion != "github-ae@latest" %} +| `reason:security-alert` | リポジトリに対してセキュリティアラートが発行されたとき。{% endif %} +| `reason:state-change` | プルリクエストまたは Issue の状態が変更されたとき。 たとえば、Issue がクローズされたり、プルリクエストがマージされた場合です。 | +| `reason:team-mention` | メンバーになっている Team が@メンションされたとき。 | +| `reason:ci-activity` | リポジトリに、新しいワークフロー実行ステータスなどの CI 更新があるとき。 | #### サポートされている `is:` クエリ -{% data variables.product.product_name %} での特定のアクティビティの通知をフィルタするには、`is` クエリを使用できます。 For example, to only see repository invitation updates, use `is:repository-invitation`{% if currentVersion != "github-ae@latest" %}, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`.{% endif %} +{% data variables.product.product_name %} での特定のアクティビティの通知をフィルタするには、`is` クエリを使用できます。 たとえば、リポジトリの招待の更新のみを表示するには、`is:repository-invitation`{% if currentVersion != "github-ae@latest" %} を使用し、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %}セキュリティ{% endif %}アラートのみを表示するには、`is:repository-vulnerability-alert`を使用します。{% endif %} - `is:check-suite` - `is:commit` @@ -128,11 +128,11 @@ To filter notifications by why you've received an update, you can use the `reaso - `is:discussions`{% endif %} {% if currentVersion != "github-ae@latest" %} -For information about reducing noise from 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 %}, see "[Configuring notifications for vulnerable dependencies](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)." +- +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %} セキュリティアラート{% endif %}からの通知を減らす方法については、「[脆弱性のある依存関係の通知を設定する](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)」を参照してください。 {% endif %} -You can also use the `is:` query to describe how the notification was triaged. +`is:` クエリを使用して、通知がトリアージされた方法を記述することもできます。 - `is:saved` - `is:done` 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 574f5d9efe85..b3a639bf8ef4 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 @@ -11,7 +11,7 @@ versions: {% note %} -**注釈:** サブスクライブ解除する代わりに、リポジトリを無視するオプションがあります。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %不正利用の発生によりリポジトリを無視する場合は、[サポートにお問い合わせ](/contact)ください。 {% data reusables.policies.abuse %}{% endif %} +**注釈:** サブスクライブ解除する代わりに、リポジトリを無視するオプションがあります。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %}不正使用の発生により、リポジトリを無視する場合は、{% data variables.contact.contact_support %} 問い合わせてサポートを受けてください。 {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 68b36f9b812c..fa4321a74308 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 することをお勧めします。' +title: Viewing your subscriptions +intro: 'To understand where your notifications are coming from and your notifications volume, we recommend reviewing your subscriptions and watched repositories regularly.' redirect_from: - /articles/subscribing-to-conversations/ - /articles/unsubscribing-from-conversations/ @@ -20,19 +20,19 @@ versions: github-ae: '*' --- -{% 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)」を参照してください。 +You receive notifications for your subscriptions of ongoing activity on {% data variables.product.product_name %}. There are many reasons you can be subscribed to a conversation. For more information, see "[About notifications](/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)." -### 通知過多の理由を診断する +### Diagnosing why you receive too many notifications 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. -![自動 Watch](/assets/images/help/notifications-v2/automatic-watching-example.png) +![Automatic watching](/assets/images/help/notifications-v2/automatic-watching-example.png) -詳しい情報については、「[通知を設定する](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#automatic-watching)」を参照してください。 +For more information, see "[Configuring notifications](/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)." +To see an overview of your repository subscriptions, see "[Reviewing repositories that you're watching](#reviewing-repositories-that-youre-watching)." {% if currentVersion == "free-pro-team@latest" %} {% tip %} @@ -43,54 +43,56 @@ To see an overview of your repository subscriptions, see "[Reviewing repositorie 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 "[Unwatch recommendations](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" on {% data variables.product.prodname_blog %} and "[Managing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." You can also create a triage workflow to help with the notifications you receive. For guidance on triage workflows, see "[Customizing a workflow for triaging your notifications](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)." -### サブスクリプションのリストを確認する +### Reviewing all of your subscriptions {% data reusables.notifications.access_notifications %} -1. 左側のサイドバーの、通知元のリポジトリリストの下にある [Manage notifications] ドロップダウンを使用して、[**Subscriptions**] をクリックします。 ![[Manage notifications] ドロップダウンメニューオプション](/assets/images/help/notifications-v2/manage-notifications-options.png) +1. In the left sidebar, under the list of repositories that you have notifications from, use the "Manage notifications" drop-down to click **Subscriptions**. + ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png) -2. フィルタとソートを使用して、サブスクリプションのリストを絞り込み、通知の受信を希望しない会話のサブスクリプションを解除します。 +2. Use the filters and sort to narrow the list of subscriptions and begin unsubscribing to conversations you no longer want to receive notifications for. - ![サブスクリプションページ](/assets/images/help/notifications-v2/all-subscriptions.png) + ![Subscriptions page](/assets/images/help/notifications-v2/all-subscriptions.png) {% tip %} -**参考:** -- 忘れている可能性のあるサブスクリプションを確認するには、[least recently subscribed] でソートします。 +**Tips:** +- To review subscriptions you may have forgotten about, sort by "least recently subscribed." -- 引き続き通知が受信可能なリポジトリのリストを確認するには、[filter by repository] ドロップダウンメニューのリポジトリリストを参照します。 +- To review a list of repositories that you can still receive notifications for, see the repository list in the "filter by repository" drop-down menu. {% endtip %} -### Watch しているリポジトリを確認する +### Reviewing repositories that you're watching -1. 左側のサイドバーの、リポジトリリストの下にある [Manage notifications] ドロップダウンメニューを使用して、[**Watched repositories**] をクリックします。 ![[Manage notifications] ドロップダウンメニューオプション](/assets/images/help/notifications-v2/manage-notifications-options.png) -2. Watch しているリポジトリを評価し、それらの更新がまだ関連していて有用であるかどうかを判断します。 リポジトリを Watch すると、そのリポジトリのすべての会話が通知されます。 +1. In the left sidebar, under the list of repositories, use the "Manage notifications" drop-down menu and click **Watched repositories**. + ![Manage notifications drop down menu options](/assets/images/help/notifications-v2/manage-notifications-options.png) +2. Evaluate the repositories that you are watching and decide if their updates are still relevant and helpful. When you watch a repository, you will be notified of all conversations for that repository. {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - ![Watch対象の通知ページ](/assets/images/help/notifications-v2/watched-notifications.png) + ![Watched notifications page](/assets/images/help/notifications-v2/watched-notifications.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - ![Watch対象の通知ページ](/assets/images/help/notifications-v2/watched-notifications-custom.png) + ![Watched notifications page](/assets/images/help/notifications-v2/watched-notifications-custom.png) {% endif %} {% tip %} **Tip:** Instead of watching a repository, consider only receiving notifications {% if currentVersion == "free-pro-team@latest" %}when there are updates to issues, pull requests, releases or discussions (if enabled for the repository), or any combination of these options,{% else %}for releases in a repository,{% endif %} or completely unwatching a repository. - - リポジトリを Watch 解除しても、@メンションされたときやスレッドに参加しているときには通知を受信することができます。 When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. + + When you unwatch a repository, you can still be notified when you're @mentioned or participating in a thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. {% endtip %} -### 個々のリポジトリの Watch 設定を行う +### Configuring your watch settings for an individual repository -リポジトリごとに Watch するどうかを選択できます。 You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository. +You can choose whether to watch or unwatch an individual repository. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository. {% data reusables.repositories.navigate-to-repo %} -2. 右上隅の [Watch] ドロップダウンメニューをクリックして、Watch オプションを選択します。 +2. In the upper-right corner, click the "Watch" drop-down menu to select a watch option. {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - ![リポジトリのドロップダウンメニューの Watch オプション](/assets/images/help/notifications-v2/watch-repository-options.png) + ![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options.png) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - ![リポジトリのドロップダウンメニューの Watch オプション](/assets/images/help/notifications-v2/watch-repository-options-custom.png) + ![Watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom.png) {% data reusables.notifications-v2.custom-notifications-beta %} The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions. 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 91c391c1a7a6..0d1f4ceb4d7c 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 @@ -33,7 +33,7 @@ versions: {% note %} -**メモ:** リポジトリを無視することもできます。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %}乱用を経験し、Team を無視したい場合は、私たちがサポートしますので、[サポートに連絡してください](/contact)。 {% data reusables.policies.abuse %}{% endif %} +**メモ:** リポジトリを無視することもできます。 リポジトリを無視した場合、通知は届きません。 あなたが @メンションされても通知されなくなるため、リポジトリを無視することはおすすめしません。 {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 af17c3237102..729fe0a3d78e 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 @@ -27,7 +27,8 @@ versions: - コード検索では、_デフォルトブランチ_のみインデックスされます。{% if currentVersion == "free-pro-team@latest" %} - 384 KB より小さいファイルのみ検索可能です。{% else %}* 5 MB より小さいファイルのみ検索可能です。 - 各ファイルの最初の 500 KB のみ検索可能です。{% endif %} -- 500,000 より少ないファイル数のリポジトリのみ検索可能です。 +- Only repositories with fewer than 500,000 files are searchable.{% if currentVersion == "free-pro-team@latest" %} +- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} - [`filename`](#search-by-filename) の検索を除き、ソースコードを検索する場合、常に少なくとも検索単語を 1 つ含める必要があります。 たとえば[`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) は有効な検索ではありませんが、[`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) は有効な検索です。 - 検索結果では、同一ファイルから取り出される部分は 2 つまでです。そのファイルはさらに多くの部分でヒットしている可能性があります。 - クエリの一部として次のワイルドカード文字を用いることはできません: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]。 検索では、これらのシンボルは単に無視されます。 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 8d3b92115e2c..a4ed1f9db0a4 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 @@ -39,6 +39,7 @@ Organization のメンバーは、*owner (オーナー)*{% if currentVersion == | Organization 参加ログにアクセスする | **X** | | | | Organization のプロフィールページを変更する (詳細は「[Organization のプロフィールについて](/articles/about-your-organization-s-profile)」を参照) | **X** | | | | Organization のドメインを検証する (詳細は「[Organization のドメインを検証する](/articles/verifying-your-organization-s-domain)」を参照) | **X** | | | +| Restrict email notifications to verified domains (see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)" for details) | **X** | | | | **すべての Team** を削除する | **X** | | | | すべてのリポジトリを含めて Organization のアカウントを削除する | **X** | | | | Team を作成する (詳細は「[Organization のチーム作成権限を設定する](/articles/setting-team-creation-permissions-in-your-organization)」を参照) | **X** | **X** | | 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 05b0e628ea3f..4ea25ff8d1b8 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 @@ -60,7 +60,8 @@ Organization レベルの設定を管理することに加え、Organization の | [悪用あるいはスパムの可能性があるコンテンツのレポート](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} | ラベルの適用 | | **X** | **X** | **X** | **X** | | Create, edit, delete labels | | | **X** | **X** | **X** | -| すべての Issue およびプルリクエストのクローズ、再オープン、割り当て | | **X** | **X** | **X** | **X** | +| すべての Issue およびプルリクエストのクローズ、再オープン、割り当て | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Enable and disable auto-merge on a pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | マイルストーンの適用 | | **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** | 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 7d59733fe821..a0ff5410b59d 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 @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -制限されたメール通知が Organization 内で有効な場合、メンバーは Organization の検証済みドメインに関連付けられているメール アドレスで Organization の活動に関するメール通知のみを受信できます。 詳しい情報については [Organization のドメインの検証](/articles/verifying-your-organization-s-domain)を参照してください。 +### About email restrictions + +When restricted email notifications are enabled in an organization, members can only use an email address associated with the organization's verified domains to receive email notifications about organization activity. 詳しい情報については [Organization のドメインの検証](/articles/verifying-your-organization-s-domain)を参照してください。 外部のコラボレーターは、検証済みドメインへのメール通知の制限の対象になりません。 外部コラボレーターに関する詳しい情報については「[Organization の権限レベル](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)」を参照してください。 +If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +### メール通知を承認済みドメインに制限する + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. [Enforcement preferences] の下で、[**Restrict email notifications to domain email**] を選択します。 ![メール通知を検証済みドメインのメールに制限するためのチェックボックス](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. [**Save**] をクリックします。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index 19cca4ec9ee0..ae24c39e5026 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### About domain verification + {% data variables.product.product_name %} 上のドメインを確認するには、Organization のコードオーナー権限が必要です。 詳細は「[Organization の権限レベル](/articles/permission-levels-for-an-organization)」を参照してください。 ドメインホスティングサービスでドメインレコードを変更するためのアクセスも必要になります。 Organization のドメインの所有権を検証したあと、「検証済み」バッジが Organization のプロフィールに表示されます。 Organization が {% data variables.product.prodname_ghe_cloud %} 上にあり、企業向け利用規約に同意した場合、Organization のオーナーは、検証済みドメインにある各メンバーのメールアドレスを見て、Organization メンバーの身元を検証できるようになります。 詳細は「[Organization のプロフィールページについて](/articles/about-your-organization-s-profile/)」および「[企業利用規約にアップグレードする](/articles/upgrading-to-the-corporate-terms-of-service)」を参照してください。 -「検証済み」バッジを表示するには、Organization のプロフィールに表示されるウェブサイトとメールの情報が、検証済みのドメインと一致している必要があります。 Organization のプロフィールに表示されているウェブサイトとメールアドレスが異なるドメインでホストされている場合は、両方のドメインを検証する必要があります。 - -{% note %} - -**メモ:** Organization: のプロフィールに表示されているメールアドレスとウェブサイトで同じドメインのバリアントが使用されている場合は、両方のバリアントを確認する必要があります。 たとえば、Organization のプロフィールにウェブサイト `www.example.com` とメールアドレス `info@example.com` が表示されている場合、`www.example.com` と `example.com` の両方を検証する必要があります。 +If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." -{% endnote %} +{% data reusables.organizations.verified-domains-details %} {% data variables.product.prodname_ghe_cloud %} では、Organization のドメインの所有権を検証したあと、その Organization へのメール通知を制限することができます。 詳しい情報については「[メール通知を承認済みドメインに制限する](/articles/restricting-email-notifications-to-an-approved-domain)」を参照してください。 +### Organization のドメインを検証する + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. [**Add a domain**] をクリックします。 ![[Add a domain] ボタン](/assets/images/help/organizations/add-a-domain-button.png) -6. ドメインフィールドに検証するドメインを入力し、[**Add domain**] をクリックします。 ![[Add a domain] フィールド](/assets/images/help/organizations/add-domain-field.png) -7. ドメインホスティングサービスで DNS TXT レコードを作成するには、「**DNS TXT レコードを追加する**」の手順に従ってください。 DNS 設定が変更されるまでに最大 72 時間かかることがあります。 DNS 設定が変更されたら、次のステップに進みます。 ![DNS テキストレコードを作成するための手順](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **ヒント:** コマンドラインで ` dig ` コマンドを実行すると、DNS 設定が変更されたことを確認できます。 コマンド例では、`ORGANIZATION` を Organization の名前に、`example.com` を確認するドメインに置き換えます。 新しい TXT レコードがコマンド出力に表示されているはずです。 - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ORGANIZATION` with the name of your organization and `example.com` with the domain you'd like to verify. 新しい TXT レコードがコマンド出力に表示されているはずです。 ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - 8. TXT レコードが DNS に追加されたことを確認したら、組織の設定の [Verified domains] タブに移動します。 [Verified domains] タブを探すには、上記のステップ 1 〜 4 を実行します。 ![保留ドメインを含む確認済みドメイン設定ページ](/assets/images/help/organizations/pending-domain-verification.png) -9. 検証待ちのドメインの横にある {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} をクリックし、[**Continue verifying**] をクリックします。 ![ドメインの検証を続行するボタン](/assets/images/help/organizations/continue-verifying-domain.png) -10. [**Verify domain**] をクリックします。 ![ドメイン検証ボタン](/assets/images/help/organizations/verify-domain-final-button.png) +{% data reusables.organizations.continue-verifying-domain %} 11. 必要に応じて、Organization のプロフィールページに「検証済み」バッジが表示されたら、ドメインホスティングサービスの DNS レコードから TXT エントリを削除できます。 ![検証済みバッジ](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/index.md index ff2bfcdf9432..0c9ac7508a6c 100644 --- a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..29e49f2d891b --- /dev/null +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restricting email notifications for your enterprise account to approved domains +intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can restrict email notifications for an enterprise account. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About email restrictions for your enterprise account + +When you restrict email notifications to verified domains, enterprise members can only use an email address associated with a verified domain to receive email notifications about activity in organizations owned by your enterprise account. The domains can be inherited from the enterprise account or configured for the specific organization. For more information about email restrictions for organizations, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +If email restrictions are enabled for an enterprise account, organization owners cannot disable email restrictions for any organization owned by the enterprise account. If changes occur that result in an organization having no verified domains, either inherited from an enterprise account that owns the organization or for the specific organization, email restrictions will be disabled for the organization. + +### Restricting email notifications for your enterprise account + +Before you can restrict email notifications for your enterprise account, you must verify at least one domain for the enterprise account. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. [**Save**] をクリックします。 diff --git a/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..49c264dddaea --- /dev/null +++ b/translations/ja-JP/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verifying your enterprise account's domain +intro: 'You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can verify an enterprise account's domain. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About domain verification + +You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. 詳しい情報については [Organization のドメインの検証](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)を参照してください。 + +After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. {% data reusables.organizations.verified-domains-details %} + +Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. + +After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "[Restricting email notifications for your enterprise account to approved domains](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)." + +Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +### Verifying your enterprise account's domain + +To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. [**Add a domain**] をクリックします。 ![[Add a domain] ボタン](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ENTERPRISE-ACCOUNT` with the name of your enterprise account, and `example.com` with the domain you'd like to verify. 新しい TXT レコードがコマンド出力に表示されているはずです。 + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. ![検証済みバッジ](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 e05588ea6773..cbb2d8b029f6 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 @@ -46,7 +46,8 @@ You can also {% if currentVersion == "free-pro-team@latest" %}invite{% else %}ad | リポジトリのコードオーナーを定義する | 「[コードオーナー'について](/github/creating-cloning-and-archiving-repositories/about-code-owners)」 | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Create security advisories | "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| アクション | 詳細情報 | -|:----------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Fork the repository | 「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」 | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | [Issueやプルリクエストのためのマイルストーンの作成と編集](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests) | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | [フォークからプルリクエストを作成する](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) | -| Submit a review on a pull request that affects the mergeability of the pull request | 「[プルリクエストで提案された変更をレビューする](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)」 | -| Create and edit a wiki for the repository | 「[ウィキについて](/github/building-a-strong-community/about-wikis)」 | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| アクション | 詳細情報 | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Fork the repository | 「[フォークについて](/github/collaborating-with-issues-and-pull-requests/about-forks)」 | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | [Issueやプルリクエストのためのマイルストーンの作成と編集](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests) | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | [フォークからプルリクエストを作成する](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) | +| Submit a review on a pull request that affects the mergeability of the pull request | 「[プルリクエストで提案された変更をレビューする](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)」 | +| Create and edit a wiki for the repository | 「[ウィキについて](/github/building-a-strong-community/about-wikis)」 | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| リポジトリでコラボレーターである自身を削除する | [コラボレーターのリポジトリから自分を削除する](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository) | +| リポジトリでコラボレーターである自身を削除する | [コラボレーターのリポジトリから自分を削除する](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository) | ### 参考リンク 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 05af74762af5..0c37060ab985 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 @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} analyzes your {% data var product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. diff --git a/translations/ja-JP/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/ja-JP/content/github/site-policy/github-marketplace-developer-agreement.md index 778033585a86..43e137b7ab5b 100644 --- a/translations/ja-JP/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/ja-JP/content/github/site-policy/github-marketplace-developer-agreement.md @@ -8,7 +8,7 @@ versions: **以下の規約および条件（「同意書」）は、お客様のGitHubの「Marketplaceプログラム」への参加について規定するものです。 「Marketplaceプログラム」への参加登録を行うか、以下の [同意する] をクリックすることにより、お客様は本「同意書」を理解し、そのすべての規約および条件を受け入れたことを確認したことになります。 お客様が、企業またはその他の法人を代表して契約を締結しようとする場合、お客様は、本契約を締結するためにその法人に義務を負担させる法的権限を持つことを表明するものとし、この場合「お客様」とは、あなたが代表する法人のことを意味します。** -Effective Date: July 21, 2020 +Effective Date: January 1, 2021 ### 1. 定義 @@ -143,7 +143,7 @@ GitHubは、自らの裁量により、「リスティング」を「Marketplace **6.1** GitHubは、「エンドユーザ」が「Marketplace」経由で購入した「開発者製品」について、最終販売責任を負う商業者となります。 -**6.2** 「開発者アプリケーション」の「Marketplaceリスティング」の価格は、米ドル（USD）で設定されます。 「開発者」は、各「リスティング」の価格設定を自ら決定でき、一度価格を設定すると、その価格は変更されません。 既存の「リスティング」の価格プランを取りやめ、追加の価格プランを適用することができますが、ただし、かかる新価格プランが、既存の「エンドユーザ」に悪影響を及ぼさないことを条件とします。 「開発者製品」に設定した価格によって、お客様が受け取る金額が決定されます。 GitHubは、米ドルで設定された販売価格の75%を、適用法に基づき要求される源泉徴収税以外の「税金」を控除せずに送金します。 販売価格のうち残りの25%については、GitHubの割り当て分となり、GitHubが保管します。 毎月最終日、500米ドルの最低額に到達した場合に、GitHubはお客様の受け取り金額を送金するものとします。 +**6.2** 「開発者アプリケーション」の「Marketplaceリスティング」の価格は、米ドル（USD）で設定されます。 「開発者」は、各「リスティング」の価格設定を自ら決定でき、一度価格を設定すると、その価格は変更されません。 既存の「リスティング」の価格プランを取りやめ、追加の価格プランを適用することができますが、ただし、かかる新価格プランが、既存の「エンドユーザ」に悪影響を及ぼさないことを条件とします。 「開発者製品」に設定した価格によって、お客様が受け取る金額が決定されます。 GitHubは、米ドルで設定された販売価格の95%を、適用法に基づき要求される源泉徴収税以外の「税金」を控除せずに送金します。 販売価格のうち残りの5%については、GitHubの割り当て分となり、GitHubが保管します。 毎月最終日、500米ドルの最低額に到達した場合に、GitHubはお客様の受け取り金額を送金するものとします。 **6.3** 「返金要件」。 お客様は、「エンドユーザー」への返金に関する条件を指定する責任を負います。 いかなる場合においても、GitHub は返金についてサポートを提供する義務や、返金の支払いについて責任を負う義務を負いません。 @@ -169,7 +169,7 @@ GitHubは、自らの裁量により、「リスティング」を「Marketplace **10.3** （a）お客様が本「同意書」の条項に違反した場合、または（b）GitHubが法律で要求された場合、GitHubは本「同意書」をいつでも解約できます。 -**10.4** 「開発者」による「解約」の効果。 「開発者」から45日前の書面による解約通知を受けた時点で、「開発者」は「Marketplace」から新規顧客を獲得できなくなるものとします。 未払いの料金については、解約され、「Marketplace」から「開発者製品」が削除された際に送金されます。 解約が、GitHubが本規約を変更（セクション11）した結果により生じた場合、実際の解約日までの45日間の通知期間においては、かかる変更の直前に有効であった規約が適用されるものとします。 +**10.4** 「開発者」による「解約」の効果。 「開発者」から45日前の書面による解約通知を受けた時点で、「開発者」は「Marketplace」から新規顧客を獲得できなくなるものとします。 未払いの料金については、解約され、「Marketplace」から「開発者製品」が削除された際に送金されます。 If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** セクション2、3、4、5、8、9、12から18までに記載されている義務は、本「同意書」の失効または解約後も存続するものとします。 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 af5a9e23c105..3a3dadd6853a 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: '*' --- -発効日：2020年11月16日 +Effective date: December 19, 2020 お客様のソースコードやプロジェクト、個人情報について、GitHub Inc （以下、「GitHub」「当社」と称します）をご信頼いただき、ありがとうございます。 お客様の個人情報を保持することは重大な責務であり、当社がどのように取り扱っているのかを知っていただければと思います。 @@ -26,24 +26,24 @@ We use your personal information as this Privacy Statement describes. No matter ### 概要 -| セクション | 各セクションの内容 | -| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [GitHubが収集する情報](#what-information-github-collects) | GitHubは、お客様の登録内容や支払い、取引、ユーザプロフィールから直接情報を収集します。 当社は、また、お客様の同意が必要な場合は同意を得て、自動的に利用情報、クッキーや類似の技術、デバイス情報から収集します。 GitHubは、さらに、サードパーティからユーザの個人情報を収集することがあります。 当社は、必要最小限の個人情報を収集します。ただし、お客様がそれ以上の情報を提供することを選択した場合は除きます。 | -| [当社が_収集しない_情報](#what-information-github-does-not-collect) | 当社は、13歳未満の子どもの情報は意図的に収集しません。また、[センシティブな個人情報](https://gdpr-info.eu/art-9-gdpr/)も収集しません。 | -| [当社のお客様情報の利用方法](#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上のリポジトリコンテンツや公開情報、Organizationに関して個別の追加情報を提供します。 | -| [追加サービス](#additional-services) | 当社は、サードパーティアプリケーションやGitHub Pages、GitHubアプリケーションを含む追加のサービス提供についての情報を提供します。 | -| [当社が収集した情報についてお客様がアクセスし管理する方法](#how-you-can-access-and-control-the-information-we-collect) | 当社は、お客様に対して、お客様の個人情報にアクセス、変更または削除する方法を提供します。 | -| [当社のクッキー及びトラッキングの使用について](#our-use-of-cookies-and-tracking) | 当社では、ウェブサイトの機能全般においてクッキーを使用します。また、当社サイトの一部においてトラッキングおよび分析サービスを使用します。 当社は、このクッキーとトラッキングについて透明性の高いページを提供します。 詳細は、本セクションをご覧ください。 | -| [お客様情報についての当社の保護方法](#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) | 当社は、お客様にemailでご連絡します。 アカウント設定または当社にご連絡いただければ、当社からお客様への方法を管理できます。 | -| [苦情の解決](#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) | 本プライバシーステートメントは、[Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/)の元でライセンス付与されています。 | -| [GitHubへの連絡](#contacting-github) | 当社のプライバシーステートメントに関するご質問がある場合はお気軽にお問い合わせください。 | -| [翻訳](#translations) | 当社では、一部のプライバシーステートメントの翻訳のリンクを提供しています。 | +| セクション | 各セクションの内容 | +| ------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [GitHubが収集する情報](#what-information-github-collects) | GitHubは、お客様の登録内容や支払い、取引、ユーザプロフィールから直接情報を収集します。 We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. GitHubは、さらに、サードパーティからユーザの個人情報を収集することがあります。 当社は、必要最小限の個人情報を収集します。ただし、お客様がそれ以上の情報を提供することを選択した場合は除きます。 | +| [当社が_収集しない_情報](#what-information-github-does-not-collect) | 当社は、13歳未満の子どもの情報は意図的に収集しません。また、[センシティブな個人情報](https://gdpr-info.eu/art-9-gdpr/)も収集しません。 | +| [当社のお客様情報の利用方法](#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上のリポジトリコンテンツや公開情報、Organizationに関して個別の追加情報を提供します。 | +| [追加サービス](#additional-services) | 当社は、サードパーティアプリケーションやGitHub Pages、GitHubアプリケーションを含む追加のサービス提供についての情報を提供します。 | +| [当社が収集した情報についてお客様がアクセスし管理する方法](#how-you-can-access-and-control-the-information-we-collect) | 当社は、お客様に対して、お客様の個人情報にアクセス、変更または削除する方法を提供します。 | +| [当社のクッキー及びトラッキングの使用について](#our-use-of-cookies-and-tracking) | We only use strictly necessary cookies to provide, secure and improve our service. 当社は、このクッキーとトラッキングについて透明性の高いページを提供します。 詳細は、本セクションをご覧ください。 | +| [お客様情報についての当社の保護方法](#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) | 当社は、お客様にemailでご連絡します。 アカウント設定または当社にご連絡いただければ、当社からお客様への方法を管理できます。 | +| [苦情の解決](#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) | 本プライバシーステートメントは、[Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/)の元でライセンス付与されています。 | +| [GitHubへの連絡](#contacting-github) | 当社のプライバシーステートメントに関するご質問がある場合はお気軽にお問い合わせください。 | +| [翻訳](#translations) | 当社では、一部のプライバシーステートメントの翻訳のリンクを提供しています。 | ## GitHubのプライバシーについての声明 @@ -74,8 +74,8 @@ If you list and sell an application on [GitHub Marketplace](https://github.com/m ##### Usage information お客様が当社のサービスまたはウェブサイトにアクセスしている場合、当社は、ほとんどのサービスが収集する情報を、お客様の同意が必要な場合はその同意を得て、自動的に収集します。 この収集する情報は、閲覧しているページ、参照したページ、IPアドレスおよびセッション情報ならびに。それぞれのリクエストの日付および時間などのお客様のサービス利用方法を含みます。 この情報は、アカウントを保有しているかどうかに関わらず、ウェブサイトのすべての訪問者から収集しています。 この情報には、ユーザ個人情報を含む可能性があります。 -##### Cookies and similar technologies information -下記でさらに記載しているとおり、かつ、お客様の同意が必要な場合はその同意を条件として、当社は、お客様のログインを継続するため、お客様の環境設定を記憶するため、ならびに、お客様およびそのデバイスを識別するために、クッキーおよび類似する技術（クッキーIDや設定など）から自動的に情報を収集します。 +##### クッキー +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### Device information 当社は、IPアドレス、ブラウザまたはクライアントアプリケーション情報、言語設定、オペレーティングシステムとアプリケーションバージョン、デバイスの種類とID、デバイスのモデルとメーカーなど、お客様のデバイスについての一定の情報を収集することがあります。 この情報には、ユーザ個人情報を含む可能性があります。 @@ -235,15 +235,17 @@ GitHubは、一般的に、ユーザ個人情報をアカウントがアクテ #### クッキー -GitHub uses cookies and similar technologies (e.g., HTML5 localStorage) to make interactions with our service easy and meaningful. Cookie は、ウェブサイトが訪問者のコンピュータまたはモバイルデバイスに度々格納する小さなテキストファイルです。 We use cookies and similar technologies (hereafter collectively "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 only uses strictly necessary cookies. Cookie は、ウェブサイトが訪問者のコンピュータまたはモバイルデバイスに度々格納する小さなテキストファイルです。 -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. +We use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### トラッキングおよびアナリティクス +By using our service, 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 our service. -当社は、当社のユーザによるGitHubの利用の評価、アクティビティの統計レポートのコンパイルならびに当社のコンテンツおよびウェブサイトのパフォーマンスの向上に役立つ、一定数のサードパーティアナリティクスおよびサービスプロバイダを利用しています。 当社は、当社のウェブサイトの一定のエリアでのみこれらのサードパーティアナリティクスプロバイダを利用します。これらのプロバイダはすべて、収集できるユーザ個人情報の種類および情報を処理する目的を制限するデータ保護規約を当社と締結しています。 さらに、当社は、機能を提供ならびにコンテンツおよびパフォーマンスを向上するために内部でアナリティクスソフトウェアを利用します。 +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. -一定のブラウザは、「追跡拒否（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. +#### DNT + +"[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/)に従います。 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. [Privacy Badger](https://privacybadger.org/)など、トラッキングをブロックする良いアプリケーションもあります。 ### お客様情報についての当社の保護方法 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 85492a447419..850245246370 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,9 +10,9 @@ versions: free-pro-team: '*' --- -Effective date: **October 2, 2020** +Effective date: **December 30, 2020** -GitHubは、お客様のデータを当社が利用する方法、お客様のデータを当社が収集する方法、およびお客様のデータを共有する対象について、高い透明性を提供します。 この目的のため、当社は[当社のサブプロセッサ](#github-subprocessors)、[クッキー](#cookies-on-github)の使用方法、および[GitHubにおけるトラッキング](#tracking-on-github)を実施する場所とその方法について説明するページをご用意しました。 +GitHubは、お客様のデータを当社が利用する方法、お客様のデータを当社が収集する方法、およびお客様のデータを共有する対象について、高い透明性を提供します。 To that end, we provide this page, which details [our subprocessors](#github-subprocessors), and how we use [cookies](#cookies-on-github). ### GitHubのサブプロセッサ @@ -29,14 +29,13 @@ GitHubは、お客様のデータを当社が利用する方法、お客様の | Eloqua | マーケティングキャンペーンの自動化 | 米国 | 米国 | | Google Apps | 社内インフラストラクチャ | 米国 | 米国 | | Google Analytics | Analytics and performance | 米国 | 米国 | -| LinkedIn Navigator | マーケティングデータのエンリッチメントサービス | 米国 | 米国 | +| LinkedIn Navigator | Data enrichment service | 米国 | 米国 | | Magic Robot | キャンペーンレポート (Salesforceのアドオン) | 米国 | 米国 | | MailChimp | 顧客チケットメールサービスプロバイダ | 米国 | 米国 | | Mailgun | トランザクションメールサービスプロバイダ | 米国 | 米国 | | Microsoft | Microsoft Services | 米国 | 米国 | | Monday.com | チームコラボレーションおよびプロジェクト管理プラットフォーム | 米国 | イスラエル | | Nexmo | SMS通知プロバイダ | 米国 | 米国 | -| Oracle | 企業金融システム | 米国 | 米国 | | Salesforce.com | 顧客関係管理 | 米国 | 米国 | | Sendgrid | トランザクションメールサービスプロバイダ | 米国 | 米国 | | Sentry.io | Application monitoring provider | 米国 | 米国 | @@ -49,49 +48,35 @@ GitHubは、お客様のデータを当社が利用する方法、お客様の ### GitHub上のクッキー -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. +GitHub uses 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 | +| 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 | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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 for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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` | This cookie allows us to customize timestamps to your time zone. | セッション | +| GitHub | `user_session` | このクッキーはログインに使用されます。 | two weeks | _*_ 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. - -### 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 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/)に従います。 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. +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, certain pages on our website may set other third party cookies. たとえば、クッキーを設定するサイトから、動画などのコンテンツを埋め込むことがあります。 第三者のクッキーは最小限に保つよう努めていますが、当社は第三者のコンテンツが設定するクッキーを常に管理できるわけではありません。 diff --git a/translations/ja-JP/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/ja-JP/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index 04f6c6b3af88..0aecdc128526 100644 --- a/translations/ja-JP/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/ja-JP/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -162,8 +162,6 @@ GitHub, Inc. c/o Corporation Service Company Sacramento, CA 95833-3505 ``` -また、legal@support.github.com に写しを送信することもできます。 - 要求を送る際は、次の情報を含めて、できるだけ具体的かつ範囲を絞った内容にしてください。 - 情報の要求を発行する機関に関する完全な情報 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 5c7b22cdf5ea..2d8fe3be0880 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 @@ -39,12 +39,6 @@ If vulnerabilities have been detected in the repository, these are shown at the 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_alerts %}. -{% note %} - -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. - -{% endnote %} - ![依存関係グラフ](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ Any direct and indirect dependencies that are specified in the repository's mani {% if enterpriseServerVersions contains currentVersion 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. - -{% endnote %} - ![依存関係グラフ](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,6 +81,24 @@ You can also enable or disable the dependency graph for all repositories owned b 4. リポジトリ データへの読み取りアクセスを {% data variables.product.product_name %} に許可して依存関係グラフを有効にすることに関するメッセージを読んだうえで、[Dependency Graph] の隣にある [**Enable**] をクリックします。 ![依存関係グラフの [Enable] ボタン](/assets/images/help/repository/dependency-graph-enable-button.png) [Security & analysis] タブで [Dependency Graph] の隣にある [**Disable**] をクリックすれば、依存関係グラフはいつでも無効にできます。 + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} ### 依存関係グラフのトラブルシューティング 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 bfd48f033636..95e2e00f28fb 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,8 +40,9 @@ 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` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. DNS レコードが正しくセットアップされたことを確認するには、 `dig` コマンドを使います。_WWW.EXAMPLE.COM_ は、お使いのサブドメインに置き換えてください。 ```shell @@ -72,6 +73,8 @@ Apex ドメイン、たとえば`example.com` を設定するには、{% data va 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. DNS レコードが正しく設定されたことを確認するには、 `dig` コマンドを使います。_EXAMPLE.COM_ は、お使いの Apex ドメインに置き換えてください。 結果が、上記の {% data variables.product.prodname_pages %} の IP アドレスに一致することを確認します。 ```shell diff --git a/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index 82149e9e42d7..be1a000bb4cc 100644 --- a/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/ja-JP/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -39,11 +39,7 @@ versions: - 複数の `www` サブドメインを使用している。 たとえば、`www.example.com` と`www.anotherexample.com` の両方など。 - Apex ドメインとカスタムサブドメインの両方を使用している。 たとえば、`example.com` と`docs.example.com` の両方など。 -{% warning %} - -**警告:** `*.example.com` など、ワイルドカード DNS レコードは使わないでください。 ワイルドカード DNS レコードにより、あなたのサブドメインの 1 つで {% data variables.product.prodname_pages %}サイトを誰でもホストできるようになります。 - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} サポートされているカスタムサブドメインのリストは、「[カスタムドメインと {% data variables.product.prodname_pages %} について](/articles/about-custom-domains-and-github-pages/#supported-custom-domains)」を参照してください。 diff --git a/translations/ja-JP/content/graphql/README.md b/translations/ja-JP/content/graphql/README.md index f29fbc513144..557f91946e85 100644 --- a/translations/ja-JP/content/graphql/README.md +++ b/translations/ja-JP/content/graphql/README.md @@ -1,10 +1,10 @@ # GraphQL -The `/content/graphql` directory is where the GitHub GraphQL API docs live! +GitHub GraphQL API ドキュメントは、`/content/graphql`ディレクトリにあります。 -* The `/content/graphql/guides` and `/content/graphql/overview` directories contain articles that are human-editable. -* The `/content/graphql/reference` directory contains an article for each GraphQL data type used in the GitHub GraphQL API. Most of the content in this directory is rendered using `include` tags. +* `/content/graphql/guides`および`/content/graphql/overview`ディレクトリには、ユーザーが編集できる記事があります。 +* `/content/graphql/reference`ディレクトリには、GitHub GraphQL APIで使用されるGraphQLの各データ型についての記事があります。 このディレクトリの内容はほとんど、`include` タグを使用してレンダリングされます。 - The content rendered by `include` tags is sourced from the `/lib/graphql/static` directory, which is automatically generated from the API source code internally in GitHub, and should not be edited by a human. For more information, see the [`/lib/graphql/README.md`](/lib/graphql/README.md). + `include`タグによってレンダリングされるコンテンツは`/lib/graphql/static`ディレクトリから取得され、これはGitHubで内部的にAPIソースコードから自動的に生成されます。ユーザーは編集しないでください。 詳しい情報については、[`lib/graphql/README.md`](/lib/graphql/README.md)を参照してください。 - **As a result, we cannot accept contributions to GraphQL API reference content in this repository.** + **そのため、このリポジトリでGraphQL APIリファレンスに対するコントリビューションを受け付けることはできません。** 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 300a4f90b4eb..71d2c7be7e01 100644 --- a/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md +++ b/translations/ja-JP/content/graphql/guides/managing-enterprise-accounts.md @@ -193,6 +193,6 @@ GraphQLの使い始め方に関する詳しい情報については「[GraphQL Enterprise Accounts APIで利用できる新しいクエリ、ミューテーション、スキーマ定義された型の概要を以下に示します。 -For more details about the new queries, mutations, and schema defined types available for use with the Enterprise Accounts API, see the sidebar with detailed GraphQL definitions from any [GraphQL reference page](/graphql). +Enterprise APIで利用できる新しいクエリ、ミューテーション、スキーマ定義された型に関する詳しい情報については、任意の[GraphQLリファレンスページ](/graphql)の詳細なGraphQLの定義があるサイドバーを見てください。 GitHub上のGraphQL Explorer内からリファレンスドキュメントにアクセスできます。 詳しい情報については「[Explorerの利用](/graphql/guides/using-the-explorer#accessing-the-sidebar-docs)」を参照してください。 認証やレート制限の詳細など その他の情報については[ガイド](/graphql/guides)を参照してください。 diff --git a/translations/ja-JP/content/graphql/guides/migrating-from-rest-to-graphql.md b/translations/ja-JP/content/graphql/guides/migrating-from-rest-to-graphql.md index 0e8c057f427d..837060fbc88f 100644 --- a/translations/ja-JP/content/graphql/guides/migrating-from-rest-to-graphql.md +++ b/translations/ja-JP/content/graphql/guides/migrating-from-rest-to-graphql.md @@ -14,12 +14,12 @@ versions: RESTからGraphQLへの移行は、APIロジックの大きな変化を示します。 スタイルとしてのRESTと仕様としてのGraphQLとの違いのために、REST APIの呼び出しをGraphQL APIのクエリに1対1で置き換えることは難しく、しばしば望ましくないことになります。 移行の具体的な例を以下に示しました。 -To migrate your code from the [REST API](/rest) to the GraphQL API: +コードを [REST API](/rest) から GraphQL API に移行するには、以下を行います。 - [GraphQL仕様](https://graphql.github.io/graphql-spec/June2018/)のレビュー -- Review GitHub's [GraphQL schema](/graphql/reference) +- GitHubの[GraphQLスキーマ](/graphql/reference)のレビュー - 現在のコードによるGitHub REST APIとのやりとりの考慮 -- Use [Global Node IDs](/graphql/guides/using-global-node-ids) to reference objects between API versions +- [グローバルノードID](/graphql/guides/using-global-node-ids)を使ったAPIバージョン間でのオブジェクトの参照 GraphQLによる重要な利点には以下があります。 @@ -53,12 +53,12 @@ query { } ``` -別の例を考えてみましょう。プルリクエストのリストを取得して、それぞれがマージ可能かをチェックします。 A call to the REST API retrieves a list of pull requests and their [summary representations](/rest#summary-representations): +別の例を考えてみましょう。プルリクエストのリストを取得して、それぞれがマージ可能かをチェックします。 REST APIの呼び出しは、プルリクエストとその[サマリ表現](/rest#summary-representations)のリストを取得します。 ```shell curl -v {% data variables.product.api_url_pre %}/repos/:owner/:repo/pulls ``` -Determining if a pull request is mergeable requires retrieving each pull request individually for its [detailed representation](/rest#detailed-representations) (a large payload) and checking whether its `mergeable` attribute is true or false: +プルリクエストがマージ可能かを判断するためには、個別にそれぞれのプルリクエストの[詳細な表現](/rest#detailed-representations)（大きなペイロード）を取得し、その`mergeable`属性がtrueかfalse下をチェックしなければなりません。 ```shell curl -v {% data variables.product.api_url_pre %}/repos/:owner/:repo/pulls/:number ``` @@ -128,13 +128,13 @@ curl -v {% data variables.product.api_url_pre %}/repos/:owner/:repo/pulls/:numbe } ``` -You can also extend the power of this query by [substituting a variable](/graphql/guides/forming-calls-with-graphql#working-with-variables) for the pull request number. +プルリクエストの番号で[変数を置き換える](/graphql/guides/forming-calls-with-graphql#working-with-variables)ことで、このクエリの力を拡張することもできます。 ## 例：強力な型付け GraphQLスキーマは強く型付けされており、データの扱いが安全になっています。 -Consider an example of adding a comment to an issue or pull request using a GraphQL [mutation](/graphql/reference/mutations), and mistakenly specifying an integer rather than a string for the value of [`clientMutationId`](/graphql/reference/mutations#addcomment): +IssueもしくはプルリクエストにGraphQLの[ミューテーション](/graphql/reference/mutations)を使ってコメントを追加する例で、間違って[`clientMutationId`](/graphql/reference/mutations#addcomment)の値に文字列ではなく整数値を指定してしまったとしましょう。 ```graphql mutation { diff --git a/translations/ja-JP/content/graphql/guides/using-global-node-ids.md b/translations/ja-JP/content/graphql/guides/using-global-node-ids.md index 1fa831871e4c..aed7bf1f40b7 100644 --- a/translations/ja-JP/content/graphql/guides/using-global-node-ids.md +++ b/translations/ja-JP/content/graphql/guides/using-global-node-ids.md @@ -13,7 +13,7 @@ GitHubのほとんどのオブジェクト（ユーザ、Issue、プルリクエ {% note %} -**ノート:** RESTでは、グローバルノードIDフィールドは`node_id`という名前になっています。 GraphQLでは、`node`インターフェースの`id`フィールドです。 For a refresher on what "node" means in GraphQL, see "[Introduction to GraphQL](/graphql/guides/introduction-to-graphql#node)." +**ノート:** RESTでは、グローバルノードIDフィールドは`node_id`という名前になっています。 GraphQLでは、`node`インターフェースの`id`フィールドです。 GraphQLで「ノード」が何を意味するかを再確認するため、「[GraphQLの紹介](/graphql/guides/introduction-to-graphql#node)」を参照してください。 {% endnote %} @@ -29,7 +29,7 @@ GitHubのほとんどのオブジェクト（ユーザ、Issue、プルリクエ ### 1. オブジェクトのノードIDを返すRESTのエンドポイントの呼び出し -If you [request the authenticated user](/rest/reference/users#get-the-authenticated-user): +[認証済みのユーザをリクエスト](/rest/reference/users#get-the-authenticated-user)した場合、 ```shell $ curl -i -u username:token {% data variables.product.api_url_pre %}/user @@ -101,7 +101,7 @@ query { この種のノードをIDで見つけるクエリは、「ダイレクトノードルックアップ」と呼ばれています。 -When you run this query, you'll see that the `__typename` is [`User`](/graphql/reference/objects#user). +このクエリを実行すると、`__typename`が[`User`](/graphql/reference/objects#user)であることが分かります。 ### 3. GraphQLでダイレクトノードルックアップを行う @@ -122,4 +122,4 @@ query { ### 移行におけるグローバルノードIDの利用 -REST API または GraphQL API を使用するインテグレーションを構築する場合、API バージョン間にわたってオブジェクトを簡単に参照できるように、グローバルノード ID を保持すると良いでしょう。 For more information on handling the transition between REST and GraphQL, see "[Migrating from REST to GraphQL](/graphql/guides/migrating-from-rest-to-graphql)." +REST API または GraphQL API を使用するインテグレーションを構築する場合、API バージョン間にわたってオブジェクトを簡単に参照できるように、グローバルノード ID を保持すると良いでしょう。 RESTとGraphQL間の移行の扱いに関する詳細な情報については「[RESTからGraphQLへの移行](/graphql/guides/migrating-from-rest-to-graphql)」を参照してください。 diff --git a/translations/ja-JP/content/graphql/overview/resource-limitations.md b/translations/ja-JP/content/graphql/overview/resource-limitations.md index 36db666a9dd6..8b54995aff01 100644 --- a/translations/ja-JP/content/graphql/overview/resource-limitations.md +++ b/translations/ja-JP/content/graphql/overview/resource-limitations.md @@ -11,11 +11,11 @@ versions: ## ノードの制限 -To pass [schema](/graphql/guides/introduction-to-graphql#schema) validation, all GraphQL API v4 [calls](/graphql/guides/forming-calls-with-graphql) must meet these standards: +[スキーマ](/graphql/guides/introduction-to-graphql#schema)検証をパスするためには、すべてのGraphQL API v4の[呼び出し](/graphql/guides/forming-calls-with-graphql)が以下の標準を満す必要があります。 -* Clients must supply a `first` or `last` argument on any [connection](/graphql/guides/introduction-to-graphql#connection). +* クライアントはすべての[コネクション](/graphql/guides/introduction-to-graphql#connection)で引数として`first`もしくは`last`を渡さなければなりません。 * `first`及び`last`の値は1から100の間でなければなりません。 -* Individual calls cannot request more than 500,000 total [nodes](/graphql/guides/introduction-to-graphql#node). +* 個々の呼び出しは合計500,000以上の[ノード](/graphql/guides/introduction-to-graphql#node)を要求してはなりません。 #### 呼び出し中のノードの計算 @@ -117,11 +117,11 @@ To pass [schema](/graphql/guides/introduction-to-graphql#schema) validation, all = 22,060 総ノード -### レート制限 +## レート制限 GraphQL API v4 の制限は、REST API v3 の[レート制限](/rest/overview/resources-in-the-rest-api#rate-limiting)とは異なります。 -APIのレート制限が異なっているのはなぜでしょうか？ With [GraphQL](/graphql), one GraphQL call can replace [multiple REST calls](/graphql/guides/migrating-from-rest-to-graphql). 単一の複雑なGraphQLの呼び出しが、数千のRESTリクエストと等価なこともあります。 単一の GraphQL 呼び出しは REST API レート制限を大幅に下回りますが、クエリはGitHub のサーバーが演算するのと同等の負荷になる可能性があります。 +APIのレート制限が異なっているのはなぜでしょうか？ [GraphQL](/graphql)では、一つのGraphQLの呼び出しで[複数のRESTの呼び出し](/graphql/guides/migrating-from-rest-to-graphql)を置き換えることができます。 単一の複雑なGraphQLの呼び出しが、数千のRESTリクエストと等価なこともあります。 単一の GraphQL 呼び出しは REST API レート制限を大幅に下回りますが、クエリはGitHub のサーバーが演算するのと同等の負荷になる可能性があります。 クエリのサーバーにとってのコストを正確に表すために、GraphQL API v4は呼び出しの**レート制限スコア**を正規化されたポイントのスケールに基づいて計算します。 クエリのスコアは、親のコネクションやその子のfirst及びlast引数を計算に入れます。 @@ -130,12 +130,6 @@ APIのレート制限が異なっているのはなぜでしょうか？ With [G GraphQL API v4のレート制限は、**1時間あたり5,000ポイント**です。 -{% if currentVersion == "free-pro-team@latest" %} - -{% data variables.product.prodname_ghe_cloud %} アカウントに属する {% data variables.product.prodname_github_apps %} または{% data variables.product.prodname_oauth_app %} の場合、同じ {% data variables.product.prodname_ghe_cloud %} アカウントが所有するリソースへのリクエストの制限が 1 時間あたり 15,000 ポイントに増加しました。 - -{% endif %} - 1時間あたり5,000ポイントは、1時間あたり5,000回の呼び出しとは同じではないことに注意してください。GraphQL API v4とREST API v3は、異なるレート制限を使います。 {% note %} diff --git a/translations/ja-JP/content/graphql/reference/enums.md b/translations/ja-JP/content/graphql/reference/enums.md index 9017539bcb83..e52b84752b60 100644 --- a/translations/ja-JP/content/graphql/reference/enums.md +++ b/translations/ja-JP/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: 列挙型 redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/input-objects.md b/translations/ja-JP/content/graphql/reference/input-objects.md index 585f21ba57dd..37d1aa25eaea 100644 --- a/translations/ja-JP/content/graphql/reference/input-objects.md +++ b/translations/ja-JP/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: 入力オブジェクト redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/interfaces.md b/translations/ja-JP/content/graphql/reference/interfaces.md index 3b7b69725871..72daab2b88f9 100644 --- a/translations/ja-JP/content/graphql/reference/interfaces.md +++ b/translations/ja-JP/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: インターフェース redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/mutations.md b/translations/ja-JP/content/graphql/reference/mutations.md index 712c8dab1141..236b8325e0af 100644 --- a/translations/ja-JP/content/graphql/reference/mutations.md +++ b/translations/ja-JP/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: ミューテーション redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/objects.md b/translations/ja-JP/content/graphql/reference/objects.md index 6024fd36e9ce..1cafae745d94 100644 --- a/translations/ja-JP/content/graphql/reference/objects.md +++ b/translations/ja-JP/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: オブジェクト redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/queries.md b/translations/ja-JP/content/graphql/reference/queries.md index 0a5c5e58f9c4..4a34f3d3c282 100644 --- a/translations/ja-JP/content/graphql/reference/queries.md +++ b/translations/ja-JP/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: クエリ miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' @@ -17,7 +18,7 @@ versions: {% note %} -**Note:** For [user-to-server](/developers/apps/identifying-and-authorizing-users-for-github-apps#user-to-server-requests) {% data variables.product.prodname_github_app %} requests, you should use separate queries for issues and pull requests. For example, use the `is:issue` or `is:pull-request` filters and their equivalents. Using the `search` connection to return a combination of issues and pull requests in a single query will result in an empty set of nodes. +**注釈:** For [user-to-server](/developers/apps/identifying-and-authorizing-users-for-github-apps#user-to-server-requests) {% data variables.product.prodname_github_app %}リクエストの場合は、Issueとプルリクエストに別々のクエリを使用する必要があります。 たとえば、`is:issue`または`is:pull-request`フィルタと、それと同等のフィルタを使用します。 `search`接続を使用してIssueとプルリクエストの組み合わせを1つのクエリで返すと、ノードのセットが空になります。 {% endnote %} diff --git a/translations/ja-JP/content/graphql/reference/scalars.md b/translations/ja-JP/content/graphql/reference/scalars.md index 51280d677626..ee895c693585 100644 --- a/translations/ja-JP/content/graphql/reference/scalars.md +++ b/translations/ja-JP/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: スカラ redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/graphql/reference/unions.md b/translations/ja-JP/content/graphql/reference/unions.md index b66f1e0f3f62..fd5c7f120f93 100644 --- a/translations/ja-JP/content/graphql/reference/unions.md +++ b/translations/ja-JP/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: ユニオン redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index d31f04ed4762..505f9a45ccf2 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ Organizationを{% data variables.product.prodname_insights %}に追加した後 ### 参考リンク - [{% data variables.product.prodname_insights %}で利用できるメトリクス](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights) -- [{% data variables.product.prodname_insights %}とOrganizationのデータ保護](/github/site-policy/github-insights-and-data-protection-for-your-organization) +- {% data variables.product.prodname_insights %}とOrganizationのデータ保護 \ No newline at end of file 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 bf6396056101..1209fddf33c1 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 @@ -20,7 +20,7 @@ versions: ### サポートへの連絡 -{% 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 %} +{% 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 %}を参照してください。 ### 参考リンク diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md index f0ac2f2cad87..f4851d9c228e 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/configuring-the-connection-between-github-insights-and-github-enterprise.md +++ b/translations/ja-JP/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. GitHub Insightsの +{% octicon "gear" aria-label="The gear icon" %} Setting（設定）の下で、**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/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 751d059f02ee..53eeb43da329 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 @@ -1,6 +1,6 @@ --- title: GitHub InsightsとGitHub Enterprise間のリンクの有効化 -intro: 'You can enable a link that will allow users to navigate from {% data variables.product.prodname_ghe_server %} to {% data variables.product.prodname_insights %}.' +intro: 'ユーザが{% data variables.product.prodname_ghe_server %}から{% data variables.product.prodname_insights %}へアクセスできるようにするリンクを有効化できます。' product: '{% data reusables.gated-features.github-insights %}' permissions: '{% data variables.product.prodname_ghe_server %}のサイト管理者は、{% data variables.product.prodname_ghe_server %}と{% data variables.product.prodname_insights %}間のリンクを有効化できます。' redirect_from: @@ -21,8 +21,8 @@ versions: {% data variables.product.prodname_ghe_server %}. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.settings-tab %} -7. Under -{% octicon "gear" aria-label="The Settings gear" %} **Settings**, click **{% data variables.product.prodname_insights %}**. +7. GitHub Insightsの +{% octicon "gear" aria-label="The Settings gear" %} **Setting（設定）**の下で、**{% 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/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 a3a36bffb91c..86364cb1f0a8 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,7 @@ 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. Navigate to the organization you'd like to connect to +2. に接続したいOrganizationにアクセスしてください。 {% data variables.product.prodname_insights %}. {% data reusables.organizations.org_settings %} {% data reusables.organizations.github-apps-settings-sidebar %} @@ -99,4 +99,4 @@ versions: ### 参考リンク - [リポジトリの管理](/insights/installing-and-configuring-github-insights/managing-repositories) -- [{% data variables.product.prodname_insights %}とOrganizationのデータ保護](/github/site-policy/github-insights-and-data-protection-for-your-organization) +- {% data variables.product.prodname_insights %}とOrganizationのデータ保護 diff --git a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-contributors-and-teams.md b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-contributors-and-teams.md index 025f4d1e4fe0..d173052a317e 100644 --- a/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-contributors-and-teams.md +++ b/translations/ja-JP/content/insights/installing-and-configuring-github-insights/managing-contributors-and-teams.md @@ -90,7 +90,7 @@ Organizationが{% data variables.product.prodname_insights %}に追加される {% data reusables.github-insights.settings-tab %} {% data reusables.github-insights.teams-tab %} {% data reusables.github-insights.edit-team %} -3. "Contributors（コントリビューター）"の下で、ドロップダウンメニューを使い、コントリビューターを選択してください。 ![Contributors drop-down](/assets/images/help/insights/contributors-drop-down.png) +3. "Contributors（コントリビューター）"の下で、ドロップダウンメニューを使い、コントリビューターを選択してください。 ![コントリビューターのドロップダウン](/assets/images/help/insights/contributors-drop-down.png) 4. [**Done**] をクリックします。 #### カスタムTeamからのコントリビューターの削除 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 d0842dc39bcc..f72a7bae80bc 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 %}に連絡してください。 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_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/ja-JP/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/ja-JP/content/packages/guides/configuring-npm-for-use-with-github-packages.md index 6f1973eb33d1..65182579867b 100644 --- a/translations/ja-JP/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/ja-JP/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: {% data reusables.package_registry.default-name %} たとえば、{% data variables.product.prodname_dotcom %}は`OWNER/test`というリポジトリ内の`com.example:test`という名前のパッケージを公開します。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Limits for published npm versions + +If you publish over 1,000 npm package versions to {% data variables.product.prodname_registry %}, you may see performance issues and timeouts occur during usage. + +To reduce the number of versions you have published for your npm package, consider deleting package versions. 詳しい情報については「[パッケージの削除](/packages/manage-packages/deleting-a-package)」を参照してください。 + +In the future, {% data variables.product.company_short %} will enforce a hard limit on publishing more than 1,000 versions of an npm package. When we start enforcing the 1,000 versions limit for each npm package hosted on {% data variables.product.prodname_registry %}, we will offer more guidance on how to manage your package versions. + +{% endif %} + ### {% data variables.product.prodname_registry %} への認証を行う {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/ja-JP/content/packages/guides/deleting-a-container-image.md b/translations/ja-JP/content/packages/guides/deleting-a-container-image.md index 9d74cc511529..ad6bc7158e08 100644 --- a/translations/ja-JP/content/packages/guides/deleting-a-container-image.md +++ b/translations/ja-JP/content/packages/guides/deleting-a-container-image.md @@ -1,6 +1,6 @@ --- title: コンテナイメージを削除する -intro: 'GraphQL を使って、あるいは {% data variables.product.prodname_dotcom %} 上でプライベートパッケージのバージョンを削除できます。' +intro: 'You can delete a specific version or all versions of a private or public container image on {% data variables.product.prodname_dotcom %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ versions: ### {% data variables.product.prodname_dotcom %} 上でユーザが所持するコンテナイメージのバージョンを削除する +To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "[Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-a-user-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-user-level %} 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) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. 削除を確認するために、パッケージ名を入力して**I understand the consequences, delete this version（生じることを理解したので、このバージョンを削除してください）**をクリックしてください。 ![パッケージの削除の確認ボタン](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### {% data variables.product.prodname_dotcom %} 上で Organization が所持するコンテナイメージのバージョンを削除する +To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "[Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-an-organization-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-org-level %} 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) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. 削除を確認するために、パッケージ名を入力して**I understand the consequences, delete this version（生じることを理解したので、このバージョンを削除してください）**をクリックしてください。 ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-user-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-org-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![パッケージの削除ボタン](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![パッケージの削除の確認ボタン](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/ja-JP/content/packages/index.md b/translations/ja-JP/content/packages/index.md index e76d269f8d87..89e277363af4 100644 --- a/translations/ja-JP/content/packages/index.md +++ b/translations/ja-JP/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: + - + title: ghcr.io container names redirect to the container page + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: Filter for tagged and untagged containers + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ - title: Packages container support is an opt-in beta date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: Organization admins access to containers - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: Packages now respects IP allow list settings - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/ja-JP/content/packages/learn-github-packages/publishing-a-package.md b/translations/ja-JP/content/packages/learn-github-packages/publishing-a-package.md index e63ea80a30e0..e8226a570ac5 100644 --- a/translations/ja-JP/content/packages/learn-github-packages/publishing-a-package.md +++ b/translations/ja-JP/content/packages/learn-github-packages/publishing-a-package.md @@ -21,7 +21,7 @@ versions: {% if currentVersion == "free-pro-team@latest" %} 新しいバージョンのパッケージでセキュリティの脆弱性が解決される場合は、リポジトリでセキュリティアドバイザリを公開する必要があります。 -{% data variables.product.prodname_dotcom %} reviews each published security advisory and may use it to send {% data variables.product.prodname_dependabot_alerts %} to affected repositories. 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 +{% data variables.product.prodname_dotcom %} は公開された各セキュリティアドバイザリを確認し、それを使用して、影響を受けるリポジトリに {% data variables.product.prodname_dependabot_alerts %} を送信できます。 詳しい情報については、「[GitHub セキュリティアドバイザリについて](/github/managing-security-vulnerabilities/about-github-security-advisories)」 を参照してください。 {% endif %} ### パッケージを公開する diff --git a/translations/ja-JP/content/rest/README.md b/translations/ja-JP/content/rest/README.md index 55aaa5edda1d..bd2c93418d94 100644 --- a/translations/ja-JP/content/rest/README.md +++ b/translations/ja-JP/content/rest/README.md @@ -1,10 +1,10 @@ # REST -The `/content/rest` directory is where the GitHub REST API docs live! +GitHub REST API ドキュメントは、`/content/rest` ディレクトリにあります。 -* The `/content/rest/guides` and `/content/rest/overview` directories contain regular articles. These are human-editable. -* The `/content/rest/reference` directory contains an article for each group of endpoints in the GitHub REST API. Most of the content in this directory is rendered using `include` tags. +* `/content/rest/guides` および `/content/rest/overview` ディレクトリには、通常の記事があります。 これらは人間が判読できる記事です。 +* `/content/rest/reference` ディレクトリには、GitHub REST API の各エンドポイントグループについての記事があります。 このディレクトリの内容はほとんど、`include` タグを使用してレンダリングされます。 - The content rendered by `include` tags is sourced from the `/lib/rest/static` directory, which is automatically generated from the API source code internally in GitHub, and should not be edited by a human. For more information, see the [`/lib/rest/README.md`](/lib/rest/README.md). + `include` タグによってレンダリングされるコンテンツは`/lib/rest/static`ディレクトリから取得され、これは GitHub で内部的に API ソースコードから自動的に生成されます。ユーザーは編集しないでください。 詳しい情報については、[`/lib/rest/README.md`](/lib/rest/README.md) を参照してください。 - **As a result, we cannot accept contributions to REST API reference content in this repository.** + **そのため、このリポジトリで REST API リファレンスに対するコントリビューションを受け付けることはできません。** 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 ce92984eeab0..519bf02275ef 100644 --- a/translations/ja-JP/content/rest/guides/basics-of-authentication.md +++ b/translations/ja-JP/content/rest/guides/basics-of-authentication.md @@ -22,7 +22,7 @@ versions: ### アプリケーションの登録 -First, you'll need to [register your application][new oauth app]. 登録された各 OAuth アプリケーションには、一意のクライアント ID とクライアントシークレットが割り当てられます。 クライアントシークレットは共有しないでください。 共有には、文字列をリポジトリにチェックインすることも含まれます。 +まず、[アプリケーションの登録][new oauth app]が必要です。 登録された各 OAuth アプリケーションには、一意のクライアント ID とクライアントシークレットが割り当てられます。 クライアントシークレットは共有しないでください。 共有には、文字列をリポジトリにチェックインすることも含まれます。 どのような情報を入力しても構いませんが、**認証コールバック URL** は例外です。 これが、アプリケーションの設定にあたってもっとも重要な情報と言えるでしょう。 認証の成功後に {% data variables.product.product_name %} がユーザに返すのは、コールバックURLなのです。 @@ -47,10 +47,10 @@ get '/' do end ``` -Your client ID and client secret keys come from [your application's configuration page][app settings]. -{% if currentVersion == "free-pro-team@latest" %} You should **never, _ever_** store these values in -{% data variables.product.product_name %}--or any other public place, for that matter.{% endif %} We recommend storing them as -[environment variables][about env vars]--which is exactly what we've done here. +クライアント ID とクライアントシークレットは、[アプリケーションの設定ページ][app settings]から取得されます。 +{% if currentVersion == "free-pro-team@latest" %}これらの値は**いかなる場合も_決して_** +{% data variables.product.product_name %} や、それに限らず公開の場に保存しないでください。{% endif %}これらは +[環境変数][about env vars]として保存することをお勧めします。この例でも、そのようにしています。 次に、_views/index.erb_に以下の内容を貼り付けてください。 @@ -108,7 +108,7 @@ end #### 付与されたスコープの確認 -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)." +URL を直接変更すれば、ユーザはリクエストしたスコープを編集できます。 こうすると、アプリケーションに対して元々リクエストしたよりも少ないアクセスだけを許可できます。 トークンでリクエストを行う前に、ユーザからトークンに付与されたスコープを確認してください。 詳しい情報については、「[OAuth App のスコープ](/developers/apps/scopes-for-oauth-apps#requested-scopes-and-granted-scopes)」を参照してください。 付与されたスコープは、トークンの交換によるレスポンスの一部として返されます。 @@ -130,7 +130,7 @@ end リクエストを行う前にのみスコープを確認するだけでは不十分です。確認時と実際のリクエスト時の間に、ユーザがスコープを変更する可能性があります。 このような場合には、成功すると思っていたAPIの呼び出しが`404`または`401`ステータスになって失敗したり、情報の別のサブセットを返したりします。 -この状況にうまく対応できるように、有効なトークンによるリクエストに対するすべての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\]\[/rest/reference/apps#check-a-token\]{% else %}\[check a token for validity\]\[/rest/reference/apps#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" %} \[check a token for validity\]\[/rest/reference/apps#check-a-token\]{% else %}\[check a token for validity\]\[/rest/reference/apps#check-an-authorization\]{% endif %} にエンドポイントを提供します。 この情報を使用してトークンのスコープにおける変更を検出し、利用可能なアプリケーション機能の変更をユーザに通知します。 #### 認証リクエストの実施 @@ -174,9 +174,9 @@ erb :basic, :locals => auth_result ウェブページにアクセスするたびに、ユーザにアプリケーションへのログインを求めるというのは非常に悪いモデルです。 たとえば、`http://localhost:4567/basic`に直接移動してみてください。 エラーになるでしょう。 -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 %} にログインしている限りそれを記憶して、このアプリケーションにアクセスできるとしたらどうでしょうか。 実のところ、 +_これからやろうとしていること_はまさにそういうことなのです。 上記に上げたサーバはかなり単純なものです。 インテリジェントな認証を入れるために、トークンを保存するためセッションを使用するよう切り替えます。 これにより、認証はユーザーに意識されないものになります。 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 674dcb6caffe..d156ff1420b6 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 @@ -19,17 +19,17 @@ GitHubプラットフォームとの統合に興味はありますか。 [同じ いくつかのステップを踏むことで、GitHubから配信されるペイロードを安全に受信できます。 -1. 受信サーバーは必ずHTTPS接続にしてください。 By default, GitHub will verify SSL certificates when delivering payloads.{% if currentVersion == "free-pro-team@latest" %} +1. 受信サーバーは必ずHTTPS接続にしてください。 デフォルトでは、GitHubはペイロードを配信する際にSSL証明書を検証します。{% if currentVersion == "free-pro-team@latest" %} 1. [フック配信時に使用するIPアドレス](/github/authenticating-to-github/about-githubs-ip-addresses)をサーバーの許可リストに追加できます。 正しいIPアドレスを常に確認していることを確かめるため、[`/meta`エンドポイントを使用して](/rest/reference/meta#meta)GitHubが使用するアドレスを見つけることができます。{% endif %} 1. ペイロードがGitHubから配信されていることを確実に保証するため、[シークレットトークン](/webhooks/securing/)を提供します。 シークレットトークンを強制することにより、サーバーが受信するあらゆるデータが確実にGitHubから来ていることを保証できます。 サービスの*ユーザごと*に異なるシークレットトークンを提供するのが理想的です。 そうすれば、1つのトークンが侵害されても、他のユーザは影響を受けません。 ### 同期作業より非同期作業を優先する -GitHub expects that integrations respond within {% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %} seconds of receiving the webhook payload. サービスの応答時間がそれ以上になると、GitHubは接続を中止し、ペイロードは失われます。 +GitHubは、webhookペイロードを受信後{% if currentVersion == "free-pro-team@latest" %}10{% else %}30{% endif %}秒以内にインテグレーションが応答することを求めています。 サービスの応答時間がそれ以上になると、GitHubは接続を中止し、ペイロードは失われます。 サービスの完了時間を予測することは不可能なので、「実際の作業」のすべてはバックグラウンドジョブで実行すべきです。 バックグラウンドジョブのキューや処理を扱えるライブラリには、[Resque](https://github.com/resque/resque/) (Ruby用)、[RQ](http://python-rq.org/) (Python用)、[RabbitMQ](http://www.rabbitmq.com/)などがあります。 -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はサーバが{% if currentVersion == "free-pro-team@latest" %}ten{% else %}thirty{% endif %}秒以内に応答することを求めていることに注意してください。 サーバは何らかの応答を送信することにより、ペイロードの受信を確認する必要があります。 サービスがペイロードについての確認を可能な限り速やかに行うことは非常に重要です。そうすることにより、サーバがリクエストを継続するかどうか正確に報告できます。 ### 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 8d294cd530e9..2ac69978bade 100644 --- a/translations/ja-JP/content/rest/guides/delivering-deployments.md +++ b/translations/ja-JP/content/rest/guides/delivering-deployments.md @@ -13,7 +13,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 the default branch. +[Deployment API][deploy API]は、{% data variables.product.product_name %}にホストされたプロジェクトが、あなたのサーバーで起動できるようにします。 [Status API][status API]と組み合わせれば、コードがデフォルトブランチに到着してからすぐにデプロイメントを調整できるようになります。 この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 e3b19a6b3184..096b2089d6c2 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 @@ -38,8 +38,8 @@ GitHub Appは、単に合格/不合格の二択ではない、情報量の多い ![チェック実行のワークフロー](/assets/images/check_runs.png) {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %} -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)を参照してください。 +チェック実行が15日以上にわたり不完全な状態である場合は、チェック実行の`conclusion`が`stale`になり、に状態が +{% data variables.product.prodname_dotcom %}に{% octicon "issue-reopened" aria-label="The issue-reopened icon" %}でstaleと表示されます。 {% 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 6a504b1026eb..8e4c625291d3 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 @@ -33,14 +33,14 @@ Gitオブジェクトデータベースについての詳細は、Pro Gitブッ {% warning %} -**Warning!** Please do not depend on using Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/rest/reference/git#get-a-reference) for updates to `merge` Git refs, because this content becomes outdated without warning. +**警告:** 更新でGit refを`merge`するために直接Gitを使用したり、[`GET /repos/{owner}/{repo}/git/refs/{ref}`](/rest/reference/git#get-a-reference)を使用したりしないでください。こうしたコンテンツが古くて使えなくなっても警告されません。 {% endwarning %} _test_マージコミットを作成するには、使用するAPIは、明示的にプルリクエストを要求する必要があります。 _test_マージコミットは、UIでプルリクエストを表示して [Merge] ボタンが表示されるか、REST APIを使ってプルリクエストを[取得](/rest/reference/pulls#get-a-pull-request)、[作成](/rest/reference/pulls#create-a-pull-request)、または[編集](/rest/reference/pulls#update-a-pull-request)した際に作成されます。 このリクエストがなければ、`merge` Git refは次に誰かがプルリクエストを表示するまで期限切れになります。 -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: +期限切れの`merge` Git refを生成するポーリングメソッドを現在使用している場合、GitHubでは以下のステップに従い、デフォルトブランチ から最新の変更を取得することをお勧めします。 1. プルリクエストwebhookを受け取ります。 2. [`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/rest/reference/pulls#get-a-pull-request)を呼び出し、マージコミット候補を作成するためのバックグラウンドジョブを開始します。 -3. `mergeable`属性が`true`か`false`かを判断するため、[`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/rest/reference/pulls#get-a-pull-request)を使用してリポジトリをポーリングします。 You can use Git directly or [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/rest/reference/git#get-a-reference) for updates to `merge` Git refs only after performing the previous steps. +3. `mergeable`属性が`true`か`false`かを判断するため、[`GET /repos/{owner}/{repo}/pulls/{pull_number}`](/rest/reference/pulls#get-a-pull-request)を使用してリポジトリをポーリングします。 更新でGit refを`merge`するために直接Gitを、または [`GET /repos/{owner}/{repo}/git/refs/{ref}`](/rest/reference/git#get-a-reference)を使用できるのは、前の手順を実行した場合のみです。 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 725f4a7ee704..5d9d8a02d496 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 @@ -17,7 +17,7 @@ versions: ほとんどのアプリケーションは、任意の言語において既存の[ラッパーライブラリ][wrappers]を使用しています。ただ、まずは基底となっているAPI HTTPメソッドについて知ることが大切です。 -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 %} +ちょっと試しにやってみるだけなら、[cURL][curl]を使うのが一番簡単です。{% if currentVersion == "free-pro-team@latest" %} 別のクライアントを使用している場合、リクエストで有効な [ユーザエージェントのヘッダ](/rest/overview/resources-in-the-rest-api#user-agent-required)を送信する必要があることに注意してください。{% endif %} #### Hello World @@ -199,9 +199,9 @@ $ curl -i "{% data variables.product.api_url_pre %}/users/octocat/repos?type=own #### リポジトリの作成 -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は新規リポジトリの作成もサポートしています。 [リポジトリを作成する][create repo]には、 +詳細情報や設定オプションを含んだいくつかのJSONを`POST`する必要があります。 ```shell $ curl -i -H "Authorization: token 5199831f4dd3b79e7c5b7e0ebe75d67aa66e79d4" \ 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 0d6d983ee304..e10e49ab0b2b 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 @@ -232,7 +232,7 @@ erb :lang_freq, :locals => { :languages => languages.to_json} ] ``` -Since we already have a list of repositories above, let's inspect each one, and call [the language listing API method][language API]: +すでに上記でリポジトリのリストを取得しているので、それぞれを調べて、[言語をリスト化するAPIメソッド][language API]を呼び出しましょう。 ``` ruby repos.each do |repo| @@ -241,7 +241,7 @@ repos.each do |repo| end ``` -From there, we'll cumulatively add each language found to a list of languages: +そこから、見つかった各言語を言語のリストに次々に追加していきます。 ``` ruby repo_langs.each do |lang, count| @@ -264,7 +264,7 @@ end language_bytes = [ :name => "language_bytes", :elements => language_byte_count] ``` -(For more information on D3 tree map magic, check out [this simple tutorial][language API].) +(D3ツリーマップの魔力をもっと詳しく知りたければ、[この簡単なチュートリアル][language API]を確認しましょう。) 仕上げに、このJSON情報を同じERBテンプレートに渡します。 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 900b4d19b853..13d7dcf5dfaa 100644 --- a/translations/ja-JP/content/rest/guides/working-with-comments.md +++ b/translations/ja-JP/content/rest/guides/working-with-comments.md @@ -18,7 +18,7 @@ versions: ### プルリクエストのコメント -To access comments on a Pull Request, you'll go through [the Issues API][issues]. 最初はこれを意外に思うかもしれません。 しかし、プルリクエストがコード付きの Issue に過ぎないことさえ理解すれば、プルリクエストにコメントを作成するため Issues API を使うこともうなずけるでしょう。 +プルリクエストのコメントにアクセスするには、[Issues API][issues] を経由します。 最初はこれを意外に思うかもしれません。 しかし、プルリクエストがコード付きの Issue に過ぎないことさえ理解すれば、プルリクエストにコメントを作成するため Issues API を使うこともうなずけるでしょう。 ここでは [Octokit.rb][octokit.rb] を使って Ruby スクリプトを作成し、プルリクエストのコメントをフェッチする方法を示します。 また、[個人アクセストークン][personal token]の作成もおすすめします。 @@ -44,7 +44,7 @@ end ### 行につけるプルリクエストのコメント -diff ビュー内では、プルリクエスト内の一つの変更について、特定の側面からディスカッションを開始できます。 これらのコメントは、変更されたファイル内の個々の行について書き込まれます。 The endpoint URL for this discussion comes from [the Pull Request Review API][PR Review API]. +diff ビュー内では、プルリクエスト内の一つの変更について、特定の側面からディスカッションを開始できます。 これらのコメントは、変更されたファイル内の個々の行について書き込まれます。 このディスカッションのエンドポイントURLは、[Pull Request Review API][PR Review API] から取得されます。 以下のコードは、指定したプルリクエスト番号のファイルにあるプルリクエストのコメントすべてをフェッチします。 @@ -70,7 +70,7 @@ end ### コミットのコメント -最後のタイプのコメントは、特に個々のコミットで発生します。 For this reason, they make use of [the commit comment API][commit comment API]. +最後のタイプのコメントは、特に個々のコミットで発生します。 このため、[コミットのコメント API][commit comment API] を使用します。 コミットのコメントを取得するには、コミットの SHA1 を使用します。 言い換えれば、プルリクエストに関する識別子は全く使用しません。 次に例を示します。 diff --git a/translations/ja-JP/content/rest/overview/libraries.md b/translations/ja-JP/content/rest/overview/libraries.md index 7e9c454fcce8..f32deffc5275 100644 --- a/translations/ja-JP/content/rest/overview/libraries.md +++ b/translations/ja-JP/content/rest/overview/libraries.md @@ -7,11 +7,12 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
    The Gundamcat -

    Octokit comes in many flavors

    +

    Octokit にはいくつかの種類があります

    公式の Octokit ライブラリを使用するか、利用可能なサードパーティライブラリのいずれかを選択します。


    Ruby → octokit.rb

    @@ -24,64 +25,64 @@ versions: ### Clojure -Library name | Repository |---|---| **Tentacles**| [Raynes/tentacles](https://github.com/Raynes/tentacles) +ライブラリ名 | リポジトリ |---|---| **Tentacles**| [Raynes/tentacles](https://github.com/Raynes/tentacles) ### Dart -Library name | Repository |---|---| **github.dart** | [DirectMyFile/github.dart](https://github.com/DirectMyFile/github.dart) +ライブラリ名 | リポジトリ |---|---| **github.dart** | [DirectMyFile/github.dart](https://github.com/DirectMyFile/github.dart) ### Emacs Lisp -Library name | Repository |---|---| **gh.el** | [sigma/gh.el](https://github.com/sigma/gh.el) +ライブラリ名 | リポジトリ |---|---| **gh.el** | [sigma/gh.el](https://github.com/sigma/gh.el) ### Erlang -Library name | Repository |---|---| **octo-erl** | [sdepold/octo.erl](https://github.com/sdepold/octo.erl) +ライブラリ名 | リポジトリ |---|---| **octo-erl** | [sdepold/octo.erl](https://github.com/sdepold/octo.erl) ### Go -Library name | Repository |---|---| **go-github**| [google/go-github](https://github.com/google/go-github) +ライブラリ名 | リポジトリ |---|---| **go-github**| [google/go-github](https://github.com/google/go-github) ### Haskell -Library name | Repository |---|---| **haskell-github** | [fpco/Github](https://github.com/fpco/GitHub) +ライブラリ名 | リポジトリ |---|---| **haskell-github** | [fpco/Github](https://github.com/fpco/GitHub) ### Java -Library name | Repository | More information |---|---|---| **GitHub Java API**| [org.eclipse.egit.github.core](https://github.com/eclipse/egit-github/tree/master/org.eclipse.egit.github.core) | Is part of the [GitHub Mylyn Connector](https://github.com/eclipse/egit-github) and aims to support the entire GitHub v3 API. ビルドは [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22org.eclipse.egit.github.core%22) で利用できます。 **GitHub API for Java**| [org.kohsuke.github (From github-api)](http://github-api.kohsuke.org/)|defines an object oriented representation of the GitHub API. **JCabi GitHub API**|[github.jcabi.com (Personal Website)](http://github.jcabi.com)|is based on Java7 JSON API (JSR-353), simplifies tests with a runtime GitHub stub, and covers the entire API. +ライブラリ名 | リポジトリ | 詳細 |---|---|---| **GitHub Java API**| [org.eclipse.egit.github.core](https://github.com/eclipse/egit-github/tree/master/org.eclipse.egit.github.core) | [GitHub Mylyn Connector](https://github.com/eclipse/egit-github) の一部であり、GitHub v3 API 全体のサポートを目指します。 ビルドは [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22org.eclipse.egit.github.core%22) で利用できます。 **GitHub API for Java**| [org.kohsuke.github (From github-api)](http://github-api.kohsuke.org/)| GitHub API のオブジェクト指向の表現を定義します。 **JCabi GitHub API**|[github.jcabi.com (Personal Website)](http://github.jcabi.com)| Java7 JSON API (JSR-353) に基づいており、ランタイム GitHub スタブを使用してテストを簡素化し、API 全体をカバーします。 ### JavaScript -Library name | Repository | |---|---| **NodeJS GitHub library**| [pksunkara/octonode](https://github.com/pksunkara/octonode) **gh3 client-side API v3 wrapper**| [k33g/gh3](https://github.com/k33g/gh3) **Github.js wrapper around the GitHub API**|[michael/github](https://github.com/michael/github) **Promise-Based CoffeeScript library for the Browser or NodeJS**|[philschatz/github-client](https://github.com/philschatz/github-client) +ライブラリ名 | リポジトリ | |---|---| **NodeJS GitHub library**| [pksunkara/octonode](https://github.com/pksunkara/octonode) **gh3 client-side API v3 wrapper**| [k33g/gh3](https://github.com/k33g/gh3) **Github.js wrapper around the GitHub API**|[michael/github](https://github.com/michael/github) **Promise-Based CoffeeScript library for the Browser or NodeJS**|[philschatz/github-client](https://github.com/philschatz/github-client) ### Julia -Library name | Repository | |---|---| **Github.jl**|[WestleyArgentum/Github.jl](https://github.com/WestleyArgentum/GitHub.jl) +ライブラリ名 | リポジトリ | |---|---| **Github.jl**|[WestleyArgentum/Github.jl](https://github.com/WestleyArgentum/GitHub.jl) ### OCaml -Library name | Repository | |---|---| **ocaml-github**|[mirage/ocaml-github](https://github.com/mirage/ocaml-github) +ライブラリ名 | リポジトリ | |---|---| **ocaml-github**|[mirage/ocaml-github](https://github.com/mirage/ocaml-github) ### Perl -Library name | Repository | metacpan Website for the Library |---|---|---| **Pithub**|[plu/Pithub](https://github.com/plu/Pithub)|[Pithub CPAN](http://metacpan.org/module/Pithub) **Net::Github**|[fayland/perl-net-github](https://github.com/fayland/perl-net-github)|[Net:Github CPAN](https://metacpan.org/pod/Net::GitHub) +ライブラリ名 | リポジトリ | ライブラリの metacpan ウェブサイト |---|---|---| **Pithub**|[plu/Pithub](https://github.com/plu/Pithub)|[Pithub CPAN](http://metacpan.org/module/Pithub) **Net::Github**|[fayland/perl-net-github](https://github.com/fayland/perl-net-github)|[Net:Github CPAN](https://metacpan.org/pod/Net::GitHub) ### PHP -Library name | Repository |---|---| **GitHub PHP Client**|[tan-tan-kanarek/github-php-client](https://github.com/tan-tan-kanarek/github-php-client) **PHP GitHub API**|[KnpLabs/php-github-api](https://github.com/KnpLabs/php-github-api) **GitHub API**|[yiiext/github-api](https://github.com/yiiext/github-api) **GitHub Joomla! Package**|[joomla-framework/github-api](https://github.com/joomla-framework/github-api) **GitHub Nette Extension**|[kdyby/github](https://github.com/kdyby/github) **GitHub API Easy Access**|[milo/github-api](https://github.com/milo/github-api) **GitHub bridge for Laravel**|[GrahamCampbell/Laravel-Github](https://github.com/GrahamCampbell/Laravel-GitHub) **PHP7 Client & WebHook wrapper**|[FlexyProject/GithubAPI](https://github.com/FlexyProject/GitHubAPI) +ライブラリ名 | リポジトリ |---|---| **GitHub PHP Client**|[tan-tan-kanarek/github-php-client](https://github.com/tan-tan-kanarek/github-php-client) **PHP GitHub API**|[KnpLabs/php-github-api](https://github.com/KnpLabs/php-github-api) **GitHub API**|[yiiext/github-api](https://github.com/yiiext/github-api) **GitHub Joomla! Package**|[joomla-framework/github-api](https://github.com/joomla-framework/github-api) **GitHub Nette Extension**|[kdyby/github](https://github.com/kdyby/github) **GitHub API Easy Access**|[milo/github-api](https://github.com/milo/github-api) **GitHub bridge for Laravel**|[GrahamCampbell/Laravel-Github](https://github.com/GrahamCampbell/Laravel-GitHub) **PHP7 Client & WebHook wrapper**|[FlexyProject/GithubAPI](https://github.com/FlexyProject/GitHubAPI) ### Python -Library name | Repository |---|---| **ghapi**|[fastai/ghapi](https://github.com/fastai/ghapi) **PyGithub**|[PyGithub/PyGithub](https://github.com/PyGithub/PyGithub) **libsaas**|[duckboard/libsaas](https://github.com/ducksboard/libsaas) **github3.py**|[sigmavirus24/github3.py](https://github.com/sigmavirus24/github3.py) **sanction**|[demianbrecht/sanction](https://github.com/demianbrecht/sanction) **agithub**|[jpaugh/agithub](https://github.com/jpaugh/agithub) **octohub**|[turnkeylinux/octohub](https://github.com/turnkeylinux/octohub) **github-flask**|[github-flask (Oficial Website)](http://github-flask.readthedocs.org) **torngithub**|[jkeylu/torngithub](https://github.com/jkeylu/torngithub) +ライブラリ名 | リポジトリ |---|---| **ghapi**|[fastai/ghapi](https://github.com/fastai/ghapi) **PyGithub**|[PyGithub/PyGithub](https://github.com/PyGithub/PyGithub) **libsaas**|[duckboard/libsaas](https://github.com/ducksboard/libsaas) **github3.py**|[sigmavirus24/github3.py](https://github.com/sigmavirus24/github3.py) **sanction**|[demianbrecht/sanction](https://github.com/demianbrecht/sanction) **agithub**|[jpaugh/agithub](https://github.com/jpaugh/agithub) **octohub**|[turnkeylinux/octohub](https://github.com/turnkeylinux/octohub) **github-flask**|[github-flask (Oficial Website)](http://github-flask.readthedocs.org) **torngithub**|[jkeylu/torngithub](https://github.com/jkeylu/torngithub) ### Ruby -Library name | Repository |---|---| **GitHub API Gem**|[peter-murach/github](https://github.com/peter-murach/github) **Ghee**|[rauhryan/ghee](https://github.com/rauhryan/ghee) +ライブラリ名 | リポジトリ |---|---| **GitHub API Gem**|[peter-murach/github](https://github.com/peter-murach/github) **Ghee**|[rauhryan/ghee](https://github.com/rauhryan/ghee) ### Scala -Library name | Repository |---|---| **Hubcat**|[softprops/hubcat](https://github.com/softprops/hubcat) **Github4s**|[47deg/github4s](https://github.com/47deg/github4s) +ライブラリ名 | リポジトリ |---|---| **Hubcat**|[softprops/hubcat](https://github.com/softprops/hubcat) **Github4s**|[47deg/github4s](https://github.com/47deg/github4s) ### Shell -Library name | Repository |---|---| **ok.sh**|[whiteinge/ok.sh](https://github.com/whiteinge/ok.sh) +ライブラリ名 | リポジトリ |---|---| **ok.sh**|[whiteinge/ok.sh](https://github.com/whiteinge/ok.sh) diff --git a/translations/ja-JP/content/rest/overview/media-types.md b/translations/ja-JP/content/rest/overview/media-types.md index 8574279d93bf..1bc2f78704e7 100644 --- a/translations/ja-JP/content/rest/overview/media-types.md +++ b/translations/ja-JP/content/rest/overview/media-types.md @@ -21,7 +21,7 @@ API がサポートする最も基本的なメディアタイプは次のとお application/json application/vnd.github+json -Neither of these specify a [version][versions], so you will always get the current default JSON representation of resources. +これらはどちらも[バージョン][versions]を指定しないため、常にリソースの現在のデフォルトの JSON 表現を取得します。 {% note %} @@ -57,7 +57,7 @@ $ -H "Accept: application/vnd.github.v3.full+json" ### コメント本文のプロパティ -The body of a comment can be written in [GitHub Flavored Markdown][gfm], [issues](/rest/reference/issues), [issue comments](/rest/reference/issues#comments), [pull request comments](/rest/reference/pulls#comments), and the [gist comments](/rest/reference/gists#comments) APIs all accept these same media types: +コメントの本文は、[GitHub Flavored Markdown][gfm]、[Issue](/rest/reference/issues)、[Issue コメント](/rest/reference/issues#comments)、[プルリクエストコメント](/rest/reference/pulls#comments)、および [gist コメント](/rest/reference/gists#comments) API で記述できます。これらの API はすべて、次の同じメディアタイプを受け入れます。 #### Raw @@ -85,7 +85,7 @@ Raw 形式のテキストおよび HTML 表現を返します。 レスポンス ### Git blob プロパティ -The following media types are allowed when [getting a blob](/rest/reference/git#get-a-blob): +[blob の取得](/rest/reference/git#get-a-blob)時に許可されるメディアタイプは次のとおりです。 #### JSON @@ -102,7 +102,7 @@ Raw 形式の blob データを返します。 ### コミット、コミット比較、プルリクエスト -The [commits API](/rest/reference/repos#commits) and [pull requests API](/rest/reference/pulls) support [diff][git-diff] and [patch][git-patch] formats: +[コミット API](/rest/reference/repos#commits) と[プルリクエスト API](/rest/reference/pulls) は、[diff][git-diff] および [patch][git-patch] 形式をサポートしています。 #### diff diff --git a/translations/ja-JP/content/rest/overview/openapi-description.md b/translations/ja-JP/content/rest/overview/openapi-description.md index f55d81e76fa7..ccffca20211c 100644 --- a/translations/ja-JP/content/rest/overview/openapi-description.md +++ b/translations/ja-JP/content/rest/overview/openapi-description.md @@ -1,27 +1,27 @@ --- -title: OpenAPI description -intro: The {% data variables.product.product_name %} REST API is fully described in an OpenAPI 3.0 compliant document. +title: OpenAPI の記述 +intro: '{% data variables.product.product_name %} の REST API は、OpenAPI 3.0 準拠のドキュメントで詳細に記述されています。' versions: free-pro-team: '*' enterprise-server: '*' --- -### About OpenAPI descriptions +### OpenAPI の記述について -[OpenAPI](https://swagger.io/docs/specification/about/) is a standard specification for describing REST APIs. OpenAPI descriptions allow both humans and machines to discover the capabilities of an API without needing to first read documentation or understand the implementation. {% data variables.product.company_short %} has made its REST API publicly available as an OpenAPI 3.0 compliant document. +[OpenAPI](https://swagger.io/docs/specification/about/) は、REST API を記述するための標準仕様です。 OpenAPI の記述は、人間にとっても機械にとっても判読しやすくなっており、 あらかじめドキュメントを読んだり実装を理解したりする必要がありません。 {% data variables.product.company_short %} は、REST API を OpenAPI 3.0 準拠のドキュメントとして公開しています。 -### Getting the {% data variables.product.company_short %} OpenAPI description +### {% data variables.product.company_short %} OpenAPI の記述を取得する -You can find the description in the open source [REST API OpenAPI Description](https://github.com/github/rest-api-description) repository. +OpenAPI の記述は、オープンソースの [REST API OpenAPI Description](https://github.com/github/rest-api-description) リポジトリにあります。 -We provide the description in two formats. The bundled version works for most cases, as it includes OpenAPI components for reuse and readability. If your tooling does not support inline references to components, we also provide a fully dereferenced version. +OpenAPI の記述には 2 つの形式があります。 バンドルバージョンは、再利用と判読に適した OpenAPI コンポーネントを含んでいるため、たいていの場合に有効です。 完全逆参照バージョンは、ツール環境でコンポーネントへのインライン参照がサポートされていない場合のために用意されています。 -### Using the {% data variables.product.company_short %} OpenAPI description +### {% data variables.product.company_short %} OpenAPI 記述を使用する -There are many uses for an OpenAPI description. たとえば、次のような方法を使用します。 +OpenAPI の記述にはいろいろな使い方があります。 たとえば、次のような方法を使用します。 -* Generate your own API client. -* Validate and test a {% data variables.product.company_short %} REST API integration. -* Explore and interact with the {% data variables.product.product_name %} REST API using third-party tools, such as Insomnia or Postman. +* 独自の API クライアントを生成する。 +* {% data variables.product.company_short %} REST API の記述を検証してテストする。 +* Insomnia や Postman といったサードパーティツールを使用して、{% data variables.product.product_name %} REST API を調べ、操作する。 -For example, {% data variables.product.company_short %} uses the REST OpenAPI description to generate the {% data variables.product.product_name %} [REST API reference documentation](/rest/reference). +たとえば、{% data variables.product.company_short %} は REST OpenAPI の記述を使用して {% data variables.product.product_name %} [REST API リファレンスドキュメント](/rest/reference)を生成します。 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 444b0b3f0099..3138ff0e664d 100644 --- a/translations/ja-JP/content/rest/overview/other-authentication-methods.md +++ b/translations/ja-JP/content/rest/overview/other-authentication-methods.md @@ -11,15 +11,15 @@ versions: {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -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. +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/)を使用してください。 {% endif %} {% if currentVersion == "github-ae@latest" %} -To authenticate we recommend using [OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) tokens, such a personal access token through the [OAuth web flow](/apps/building-oauth-apps/authorizing-oauth-apps/). +認証には、[OAuth](/apps/building-integrations/setting-up-and-registering-oauth-apps/) トークン、たとえば [OAuth web フロー](/apps/building-oauth-apps/authorizing-oauth-apps/) を介した個人アクセストークンなどを使用することをお勧めします。 {% endif %} @@ -43,16 +43,16 @@ $ curl -u username:token {% data variables.product.api_url_pre {% note %} -**Note:** {% data variables.product.prodname_dotcom %} has discontinued password authentication to the API starting on November 13, 2020 for all {% data variables.product.prodname_dotcom_the_website %} accounts, including those on a {% data variables.product.prodname_free_user %}, {% data variables.product.prodname_pro %}, {% data variables.product.prodname_team %}, or {% data variables.product.prodname_ghe_cloud %} plan. 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. For more information, see "[Troubleshooting](/rest/overview/troubleshooting#basic-authentication-errors)." +**注釈:** {% data variables.product.prodname_dotcom %} は、すべての {% data variables.product.prodname_dotcom_the_website %} アカウントについて、API に対するパスポート認証を 2020 年 11 月 13 日で終了しました。{% data variables.product.prodname_free_user %}、{% data variables.product.prodname_pro %}、{% data variables.product.prodname_team %}、または {% data variables.product.prodname_ghe_cloud %} プランのアカウントもこれに該当します。 今後、{% data variables.product.prodname_dotcom %} API への認証には API トークンを使用してください。アクセストークンの扱い方に応じて、OAuth アクセストークン、 GitHub App インストールアクセストークン、個人アクセストークンなどを使用できます。 詳しい情報については、「[トラブルシューティング](/rest/overview/troubleshooting#basic-authentication-errors)」を参照してください。 {% endnote %} {% endif %} {% if enterpriseServerVersions contains currentVersion %} -To use Basic Authentication with the -{% data variables.product.product_name %} API, simply send the username and -password associated with the account. +Basic 認証を +{% data variables.product.product_name %} API で使用するには、アカウントに +対応するユーザ名とパスワードを送信するだけです。 たとえば、[cURL][curl] を介して API にアクセスしている場合、`` を {% data variables.product.product_name %} のユーザ名に置き換えると、次のコマンドで認証されます。 （cURL からパスワードの入力を求められます。） @@ -98,9 +98,9 @@ $ curl -v -H "Authorization: token TOKEN" {% data variables.product.api {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} ### 2 要素認証を使用する -When you have two-factor authentication enabled, [Basic Authentication](#basic-authentication) for _most_ endpoints in the REST API requires that you use a personal access token{% if enterpriseServerVersions contains currentVersion %} or OAuth token instead of your username and password{% endif %}. +2 要素認証を有効にしている場合、REST API の_ほとんど_のエンドポイントの [Basic 認証](#basic-authentication)では、個人アクセストークン{% if enterpriseServerVersions contains currentVersion %} または OAuth トークンをユーザ名とパスワードの代わりに{% endif %} を使用する必要があります。 -You can generate a new personal access token {% if currentVersion == "free-pro-team@latest" %}using [{% data variables.product.product_name %} developer settings](https://github.com/settings/tokens/new){% endif %}{% if enterpriseServerVersions contains currentVersion %} or with the "\[Create a new authorization\]\[/rest/reference/oauth-authorizations#create-a-new-authorization\]" endpoint in the OAuth Authorizations API to generate a new OAuth token{% endif %}. 詳しい情報については、「[コマンドラインの個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)」を参照してください。 Then you would use these tokens to [authenticate using OAuth token][oauth-auth] with the {% data variables.product.prodname_dotcom %} API.{% if enterpriseServerVersions contains currentVersion %} The only time you need to authenticate with your username and password is when you create your OAuth token or use the OAuth Authorizations API.{% endif %} +{% if currentVersion == "free-pro-team@latest" %}using [{% data variables.product.product_name %} 開発者設定を使用して](https://github.com/settings/tokens/new)新しい個人アクセストークンを生成する{% endif %}{% if enterpriseServerVersions contains currentVersion %}か、 OAuth Authorizations API で \[Create a new authorization\]\[/rest/reference/oauth-authorizations#create-a-new-authorization\] エンドポイントを使用して新しい OAuth トークンを生成する{% endif %}ことができます。 詳しい情報については、「[コマンドラインの個人アクセストークンを作成する](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)」を参照してください。 これらのトークンを使用し、{% data variables.product.prodname_dotcom %} API で [OAuth トークンを使用して認証][oauth-auth]します。{% if enterpriseServerVersions contains currentVersion %}ユーザ名とパスワードで認証する必要があるのは、OAuth トークンを作成するとき、または OAuth Authorizations API を使用するときだけです。{% endif %} {% endif %} 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 5c6a55d84a0e..ac1d206892b1 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 @@ -26,7 +26,7 @@ GitHub の GraphQL API についての情報は、[v4 ドキュメント](/graph ### スキーマ -{% 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 %}`. すべてのデータは +{% if currentVersion == "free-pro-team@latest" %}すべての API アクセスは HTTPS 経由で行われ、{% else %}API は{% endif %} `{% data variables.product.api_url_code %}` からアクセスされます。 すべてのデータは JSON として送受信されます。 ```shell @@ -41,8 +41,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -76,7 +77,7 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs ### 認証 -{% if currentVersion == "github-ae@latest" %} We recommend authenticating to the {% data variables.product.product_name %} REST API by creating an OAuth2 token through the [web application flow](/developers/apps/authorizing-oauth-apps#web-application-flow). {% else %} There are two ways to authenticate through {% data variables.product.product_name %} REST API.{% endif %} Requests that require authentication will return `404 Not Found`, instead of `403 Forbidden`, in some places. This is to prevent the accidental leakage of private repositories to unauthorized users. +{% if currentVersion == "github-ae@latest" %} {% data variables.product.product_name %} REST API への認証には、[Webアプリケーションフロー](/developers/apps/authorizing-oauth-apps#web-application-flow)で OAuth2 トークンを作成することをお勧めします。 {% else %}{% data variables.product.product_name %} REST API を使用して認証する方法は 2 つあります。{% endif %} 認証を必要とするリクエストは、場所によって `403 Forbidden` ではなく `404 Not Found` を返します。 これは、許可されていないユーザにプライベートリポジトリが誤って漏洩するのを防ぐためです。 #### Basic 認証 @@ -96,7 +97,7 @@ $ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product. {% endnote %} -[OAuth2 の詳細](/apps/building-oauth-apps/)をお読みください。 Note that OAuth2 tokens can be acquired using the [web application flow](/developers/apps/authorizing-oauth-apps#web-application-flow) for production applications. +[OAuth2 の詳細](/apps/building-oauth-apps/)をお読みください。 OAuth2 トークンは、本番アプリケーションの [Web アプリケーションフロー](/developers/apps/authorizing-oauth-apps#web-application-flow)で取得できることに注意してください。 {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} #### OAuth2 キー/シークレット @@ -209,13 +210,13 @@ REST API を介して `node_id` を検索し、それらを GraphQL 操作で使 すべてのエラーオブジェクトにはリソースとフィールドのプロパティがあるため、クライアントは問題の内容を認識することができます。 また、フィールドの問題点を知らせるエラーコードもあります。 発生する可能性のある検証エラーコードは次のとおりです。 -| エラーコード名 | 説明 | -| ---------------- | ------------------------------------------------------------------ | -| `missing` | リソースが存在しません。 | -| `missing_field` | リソースの必須フィールドが設定されていません。 | -| `invalid` | フィールドのフォーマットが無効です。 詳細については、ドキュメントを参照してください。 | -| `already_exists` | 別のリソースに、このフィールドと同じ値があります。 これは、一意のキー（ラベル名など）が必要なリソースで発生する可能性があります。 | -| `unprocessable` | 入力が無効です。 | +| エラーコード名 | 説明 | +| ---------------- | --------------------------------------------------------------------------- | +| `missing` | リソースが存在しません。 | +| `missing_field` | リソースの必須フィールドが設定されていません。 | +| `invalid` | フィールドのフォーマットが無効です。 Review the documentation for more specific information. | +| `already_exists` | 別のリソースに、このフィールドと同じ値があります。 これは、一意のキー（ラベル名など）が必要なリソースで発生する可能性があります。 | +| `unprocessable` | 入力が無効です。 | リソースはカスタム検証エラー（`code` が `custom`）を送信する場合もあります。 カスタムエラーには常にエラーを説明する `message` フィールドがあり、ほとんどのエラーには、エラーの解決に役立つ可能性があるコンテンツを指す `documentation_url` フィールドも含まれます。 @@ -234,14 +235,14 @@ API v3 は、必要に応じて HTTP リダイレクトを使用します。 ク API v3 は、可能な限り各アクションに適切な HTTPメソッドを使用しようとします。 -| メソッド | 説明 | -| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `HEAD` | HTTP ヘッダ情報のみを取得するために、任意のリソースに対して発行できます。 | -| `GET` | リソースを取得するために使用します。 | -| `POST` | リソースを作成するために使用します。 | -| `PATCH` | 部分的な JSON データでリソースを更新するために使用します。 たとえば、Issue リソースには `title` と `body` の属性があります。 PATCH リクエストは、リソースを更新するために 1 つ以上の属性を受け入れることができます。 PATCH は比較的新しく、一般的ではない HTTPメソッドであるため、リソースエンドポイントも `POST` リクエストを受け入れます。 | -| `PUT` | リソースまたはコレクションを置き換えるために使用します。 `body` 属性のない `PUT` リクエストでは、必ず `Content-Length` ヘッダをゼロに設定してください。 | -| `DELETE` | リソースを削除するために使用します。 | +| メソッド | 説明 | +| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `HEAD` | HTTP ヘッダ情報のみを取得するために、任意のリソースに対して発行できます。 | +| `GET` | リソースを取得するために使用します。 | +| `POST` | リソースを作成するために使用します。 | +| `PATCH` | 部分的な JSON データでリソースを更新するために使用します。 たとえば、Issue リソースには `title` と `body` の属性があります。 A `PATCH` request may accept one or more of the attributes to update the resource. | +| `PUT` | リソースまたはコレクションを置き換えるために使用します。 `body` 属性のない `PUT` リクエストでは、必ず `Content-Length` ヘッダをゼロに設定してください。 | +| `DELETE` | リソースを削除するために使用します。 | ### ハイパーメディア @@ -261,15 +262,15 @@ API v3 は、可能な限り各アクションに適切な HTTPメソッドを ### ページネーション -複数のアイテムを返すリクエストは、デフォルトで 30 件ごとにページ分けされます。 You can specify further pages with the `page` parameter. For some resources, you can also set a custom page size up to 100 with the `per_page` parameter. Note that for technical reasons not all endpoints respect the `per_page` parameter, see [events](/rest/reference/activity#events) for example. +複数のアイテムを返すリクエストは、デフォルトで 30 件ごとにページ分けされます。 `page` パラメータを使用すると、さらにページを指定できます。 一部のリソースでは、`per_page` パラメータを使用してカスタムページサイズを最大 100 に設定することもできます。 技術的な理由により、すべてのエンドポイントが `per_page` パラメータを尊重するわけではないことに注意してください。例については、[イベント](/rest/reference/activity#events)を参照してください。 ```shell $ curl '{% data variables.product.api_url_pre %}/user/repos?page=2&per_page=100' ``` -Note that page numbering is 1-based and that omitting the `page` parameter will return the first page. +ページ番号は 1 から始まり、`page` パラメータを省略すると最初のページが返されることに注意してください。 -Some endpoints use cursor-based pagination. A cursor is a string that points to a location in the result set. With cursor-based pagination, there is no fixed concept of "pages" in the result set, so you can't navigate to a specific page. Instead, you can traverse the results by using the `before` or `after` parameters. +カーソルベースのページネーションを使用するエンドポイントもあります。 カーソルとは、結果セットで場所を示す文字列です。 カーソルベースのページネーションでは、結果セットで「ページ」という概念がなくなるため、特定のページに移動することはできません。 かわりに、`before` または `after` パラメータを使用して結果の中を移動できます。 ページネーションの詳細については、[ページネーションでトラバースする][pagination-guide]のガイドをご覧ください。 @@ -281,18 +282,18 @@ Some endpoints use cursor-based pagination. A cursor is a string that points to {% endnote %} -The [Link header](http://tools.ietf.org/html/rfc5988) includes pagination information. 例: +[Link ヘッダ](http://tools.ietf.org/html/rfc5988)には、ページネーション情報が含まれています。 例: Link: <{% data variables.product.api_url_code %}/user/repos?page=3&per_page=100>; rel="next", <{% data variables.product.api_url_code %}/user/repos?page=50&per_page=100>; rel="last" _この例は、読みやすいように改行されています。_ -Or, if the endpoint uses cursor-based pagination: +エンドポイントでカーソルベースのページネーションを使用する場合: Link: <{% data variables.product.api_url_code %}/orgs/ORG/audit-log?after=MTYwMTkxOTU5NjQxM3xZbGI4VE5EZ1dvZTlla09uWjhoZFpR&before=>; rel="next", -This `Link` response header contains one or more [Hypermedia](/rest#hypermedia) link relations, some of which may require expansion as [URI templates](http://tools.ietf.org/html/rfc6570). +この `Link` レスポンスヘッダには、1 つ以上の[ハイパーメディア](/rest#hypermedia)リンク関係が含まれています。その一部には、[URI テンプレート](http://tools.ietf.org/html/rfc6570)としての拡張が必要な場合があります。 使用可能な `rel` の値は以下のとおりです。 @@ -317,7 +318,7 @@ Basic 認証または OAuth を使用する API リクエストの場合、1 時 {% data reusables.enterprise.rate_limit %} -Note that [the Search API has custom rate limit rules](/rest/reference/search#rate-limit). +[Search API にはカスタムのレート制限ルール](/rest/reference/search#rate-limit)があることに注意してください。 API リクエストの返された HTTP ヘッダは、現在のレート制限ステータスを示しています。 @@ -360,7 +361,7 @@ new Date(1372700873 * 1000) > } ``` -You can [check your rate limit status](/rest/reference/rate-limit) without incurring an API hit. +API ヒットを発生させることなく、[レート制限ステータスを確認](/rest/reference/rate-limit)できます。 #### OAuth アプリケーションの認証されていないレート制限を増やす @@ -591,9 +592,9 @@ JavaScript ハンドラを記述して、コールバックを処理できます #### ISO 8601 タイムスタンプにタイムゾーン情報を明示的に提供する -タイムスタンプを指定できる API 呼び出しの場合、その正確なタイムスタンプを使用します。 An example of this is the [Commits API](/rest/reference/git#commits). +タイムスタンプを指定できる API 呼び出しの場合、その正確なタイムスタンプを使用します。 これは[コミット API](/rest/reference/git#commits) の例です。 -これらのタイムスタンプは、`2014-02-27T15:05:06+01:00` のようになります。 Also see [this example](/rest/reference/git#example-input) for how these timestamps can be specified. +これらのタイムスタンプは、`2014-02-27T15:05:06+01:00` のようになります。 これらのタイムスタンプを指定する方法については、[こちらの例](/rest/reference/git#example-input)も参照してください。 #### `Time-Zone` ヘッダを使用する @@ -603,7 +604,7 @@ JavaScript ハンドラを記述して、コールバックを処理できます $ curl -H "Time-Zone: Europe/Amsterdam" -X POST {% data variables.product.api_url_pre %}/repos/github/linguist/contents/new_file.md ``` -つまり、このヘッダが定義するタイムゾーンで API 呼び出しが行われた時のタイムスタンプが生成されます。 For example, the [Contents API](/rest/reference/repos#contents) generates a git commit for each addition or change and uses the current time as the timestamp. このヘッダは、現在のタイムスタンプの生成に使用されたタイムゾーンを決定します。 +つまり、このヘッダが定義するタイムゾーンで API 呼び出しが行われた時のタイムスタンプが生成されます。 たとえば、[コンテンツ API](/rest/reference/repos#contents) は追加または変更ごとに git コミットを生成し、タイムスタンプとして現在の時刻を使用します。 このヘッダは、現在のタイムスタンプの生成に使用されたタイムゾーンを決定します。 #### ユーザが最後に認識されたタイムゾーンを使用する diff --git a/translations/ja-JP/content/rest/overview/troubleshooting.md b/translations/ja-JP/content/rest/overview/troubleshooting.md index 9db07dcdd9bb..4efcc291f9bd 100644 --- a/translations/ja-JP/content/rest/overview/troubleshooting.md +++ b/translations/ja-JP/content/rest/overview/troubleshooting.md @@ -13,52 +13,52 @@ versions: API で不可解な問題が発生した場合、発生したと思われる問題の解決策をこちらの一覧から確認できます。 -### `404` error for an existing repository +### 既存リポジトリの `404` エラー 通常、クライアントが正しく認証されていない場合、`404` エラーが送信されます。 このような場合、`403 Forbidden` が表示されるはずであると考えるかもしれません。 しかし、プライベートリポジトリに関する_いずれの_情報も提供されないため、API は代わりに `404` エラーを返します。 トラブルシューティングを行うには、[正しく認証されていること](/guides/getting-started/)、[OAuth アクセストークンに必要なスコープがあること](/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/)、そして[サードパーティアプリケーションの制限][oap-guide]によってアクセスがブロックされていないことを確認してください。 -### Not all results returned +### 表示されない結果がある リソース（_例:_ ユーザ、Issue _など_）のリストにアクセスするほとんどの API 呼び出しは、ページネーションをサポートしています。 リクエストをして、すべての結果を受け取っていない場合は、おそらく最初のページしか表示されていません。 より多くの結果を受け取るには、残りのページをリクエストする必要があります。 ページネーション URL のフォーマットを推測*しない*ことが重要です。 すべての API 呼び出しで同じ構造が使用されるわけではありません。 代わりに、すべてのリクエストで送信される [Link Header](/rest#pagination) からページネーション情報を抽出します。 {% if currentVersion == "free-pro-team@latest" %} -### Basic authentication errors +### Basic 認証のエラー -On November 13, 2020 username and password authentication to the REST API and the OAuth Authorizations API were deprecated and no longer work. +2020 年 11 月 13 日に、 REST API に対するユーザ名およびパスワードによる認証と OAuth 認証 API は非推奨となり、使用できなくなりました。 -#### Using `username`/`password` for basic authentication +#### Basic 認証での `username`/`password` の使用 -If you're using `username` and `password` for API calls, then they are no longer able to authenticate. 例: +API 呼び出しに `username` と `password` を使用している場合、これは認証されなくなります。 例: ```bash curl -u my_user:my_password https://api.github.com/user/repos ``` -Instead, use a [personal access token](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line) when testing endpoints or doing local development: +エンドポイントをテストするとき、またはローカル開発を実行するときには、かわりに[個人アクセストークン](/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line)を使用してください。 ```bash curl -H 'Authorization: token my_access_token' https://api.github.com/user/repos ``` -For OAuth Apps, you should use the [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to generate an OAuth token to use in the API call's header: +OAuth App の場合は、[Web アプリケーションフロー](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow)を使用して、API 呼び出しのヘッダーで使用する OAuth トークンを生成する必要があります。 ```bash curl -H 'Authorization: token my-oauth-token' https://api.github.com/user/repos ``` -#### Calls to OAuth Authorizations API +#### OAuth 認証 API の呼び出し -If you're making [OAuth Authorization API](/enterprise-server/rest/reference/oauth-authorizations) calls to manage your OAuth app's authorizations or to generate access tokens, similar to this example: +[OAuth 認証 API](/enterprise-server/rest/reference/oauth-authorizations) を呼び出して OAuth アプリの認証を管理する、あるいはアクセストークンを生成する場合は、次の例のようにします。 ```bash curl -u my_username:my_password -X POST "https://api.github.com/authorizations" -d '{"scopes":["public_repo"], "note":"my token", "client_id":"my_client_id", "client_secret":"my_client_secret"}' ``` -Then you must switch to the [web application flow](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow) to generate access tokens. +次に、[Web アプリケーションフロー](/apps/building-oauth-apps/authorizing-oauth-apps/#web-application-flow)に切り替えて、アクセストークンを生成します。 {% endif %} diff --git a/translations/ja-JP/content/rest/reference/actions.md b/translations/ja-JP/content/rest/reference/actions.md index f3eb50251a28..dcf6004f4a60 100644 --- a/translations/ja-JP/content/rest/reference/actions.md +++ b/translations/ja-JP/content/rest/reference/actions.md @@ -27,9 +27,9 @@ versions: {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ## 権限 -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. 詳しい情報については、「[使用制限、支払い、および管理](/actions/reference/usage-limits-billing-and-administration#disabling-or-limiting-github-actions-for-your-repository-or-organization)」を参照してください。 +権限 API では、どの組織とリポジトリが {% data variables.product.prodname_actions %} を実行できるか、どのアクションを実行できるかについて権限を設定できます。 詳しい情報については、「[使用制限、支払い、および管理](/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 を参照してください。 +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 %} diff --git a/translations/ja-JP/content/rest/reference/activity.md b/translations/ja-JP/content/rest/reference/activity.md index 7c6adef0dab9..1ccd87820971 100644 --- a/translations/ja-JP/content/rest/reference/activity.md +++ b/translations/ja-JP/content/rest/reference/activity.md @@ -147,7 +147,7 @@ $ -H "If-Modified-Since: Thu, 25 Oct 2012 15:16:27 GMT" | `招待` | リポジトリへのコントリビューションへの招待を承諾した。 | | `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" %} +| `review_requested` | 自分、または自分が所属している Team が、プルリクエストのレビューを求められた。{% 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 している。 | diff --git a/translations/ja-JP/content/rest/reference/apps.md b/translations/ja-JP/content/rest/reference/apps.md index db750025db75..a3d93eb3e409 100644 --- a/translations/ja-JP/content/rest/reference/apps.md +++ b/translations/ja-JP/content/rest/reference/apps.md @@ -32,9 +32,9 @@ REST API v3 エンドポイントのサブセットでは、GitHub App のイン {% if operation.subcategory == 'oauth-applications' %}{% include rest_operation %}{% endif %} {% endfor %} -## Installations +## インストール -Installations API を使用すると、GitHub App のインストールに関する情報を取得して、それらのインストール内でアクションを実行できます。 _インストレーション_とは、アプリケーションをインストールしたユーザまたは Organization のアカウントを指します。 インストレーションとして認証し、特定のリポジトリへのアクセスを制限する方法については、「[インストレーションとして認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)」を参照してください。 +Installations API を使用すると、GitHub App のインストールに関する情報を取得して、それらのインストール内でアクションを実行できます。 _インストール_とは、アプリケーションをインストールしたユーザまたは Organization のアカウントを指します。 インストレーションとして認証し、特定のリポジトリへのアクセスを制限する方法については、「[インストレーションとして認証する](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)」を参照してください。 Organization のすべての GitHub App インストレーションを一覧表示するには、「[Organization のアプリケーションインストールの一覧表示](/rest/reference/orgs#list-app-installations-for-an-organization)」を参照してください。 diff --git a/translations/ja-JP/content/rest/reference/code-scanning.md b/translations/ja-JP/content/rest/reference/code-scanning.md index 42f1f093fec7..5594e46c9953 100644 --- a/translations/ja-JP/content/rest/reference/code-scanning.md +++ b/translations/ja-JP/content/rest/reference/code-scanning.md @@ -9,6 +9,6 @@ versions: {% 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)." +{% 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/ja-JP/content/rest/reference/enterprise-admin.md b/translations/ja-JP/content/rest/reference/enterprise-admin.md index 8667f6ea314c..2e20666da1eb 100644 --- a/translations/ja-JP/content/rest/reference/enterprise-admin.md +++ b/translations/ja-JP/content/rest/reference/enterprise-admin.md @@ -24,7 +24,7 @@ You can use these {{ site.data.variables.product.prodname_ghe_cloud }} endpoints ### エンドポイント URL -REST API endpoints{% if enterpriseServerVersions contains currentVersion %}—except [Management Console](#management-console) API endpoints—{% endif %} are prefixed with the following URL: +REST API エンドポイント{% if enterpriseServerVersions contains currentVersion %}（[管理コンソール](#management-console) API エンドポイントを除く）{% endif %}の前には、次の URL が付けられます。 ```shell http(s)://hostname/api/v3/ @@ -40,16 +40,16 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### 認証 -{% 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 enterpriseServerVersions contains currentVersion %}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/)**{% if enterpriseServerVersions contains currentVersion %}（[a href="/rest/reference/oauth-authorizations#create-a-new-authorization">認証 API](/rest/reference/oauth-authorizations#create-a-new-authorization) を使用して作成可能）{% endif %}または **[Basic 認証](/rest/overview/resources-in-the-rest-api#basic-authentication)**で自分自身を認証できます。 {% if enterpriseServerVersions contains currentVersion %}Enterprise 固有のエンドポイントで使用する場合、OAuthトークンには `site_admin` [OAuth スコープ](/developers/apps/scopes-for-oauth-apps#available-scopes)が必要です。{% endif %} -Enterprise administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% if enterpriseServerVersions contains currentVersion %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% endif %}. +Enterprise 管理 API エンドポイントには、認証された {% data variables.product.product_name %} サイト管理者のみがアクセスできます。{% if enterpriseServerVersions contains currentVersion %}ただし、[Management Console のパスワード](/enterprise/admin/articles/accessing-the-management-console/)が必要な [Management Console](#management-console) API は除きます。{% endif %} {% endif %} {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### バージョン情報 -The current version of your enterprise is returned in the response header of every API: `X-GitHub-Enterprise-Version: {{currentVersion}}.0` You can also read the current version by calling the [meta endpoint](/rest/reference/meta/). +Enterprise の現在のバージョンは、すべての API のレスポンスヘッダで返されます: `X-GitHub-Enterprise-Version: {{currentVersion}}.0` [メタエンドポイント](/rest/reference/meta/)を呼び出して、現在のバージョンを読み取ることもできます。 {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -150,9 +150,9 @@ GET /scim/v2/enterprises/{enterprise}/Users/{scim_user_id} {% if currentVersion == "github-ae@latest" %} -## Encryption at rest +## 保管時の暗号化 -You can use the encryption at rest API to manage the key that encrypts your data on {% data variables.product.product_name %}. For more information, see "[Configuring data encryption for your enterprise](/admin/configuration/configuring-data-encryption-for-your-enterprise)." +保管時の暗号化の API を使用すると、{% data variables.product.product_name %} でデータを暗号化するキーを管理できます。 詳しい情報については、「[Enterprise 向けのデータ暗号化を設定する](/admin/configuration/configuring-data-encryption-for-your-enterprise)」を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'encryption-at-rest' %}{% include rest_operation %}{% endif %} @@ -173,9 +173,9 @@ You can use the encryption at rest API to manage the key that encrypts your data {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.22" %} -## Announcements +## アナウンス -The Announcements API allows you to manage the global announcement banner in your enterprise. For more information, see "[Customizing user messages for your enterprise](/admin/user-management/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner)." +アナウンス API を使用すると、Enterprise でグローバルなアナウンスバナーを管理できます。 詳しい情報については「[Enterprise のユーザメッセージをカスタマイズする](/admin/user-management/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner)」を参照してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'announcement' %}{% include rest_operation %}{% endif %} @@ -187,7 +187,7 @@ The Announcements API allows you to manage the global announcement banner in you ## グローバル webhook -Global webhooks are installed on your enterprise. You can use global webhooks to automatically monitor, respond to, or enforce rules for users, organizations, teams, and repositories on your enterprise. グローバル webhook は、[Organization](/developers/webhooks-and-events/webhook-events-and-payloads#organization)、[ユーザ](/developers/webhooks-and-events/webhook-events-and-payloads#user)、[リポジトリ](/developers/webhooks-and-events/webhook-events-and-payloads#repository)、[Team](/developers/webhooks-and-events/webhook-events-and-payloads#team)、[メンバー](/developers/webhooks-and-events/webhook-events-and-payloads#member)、[メンバーシップ](/developers/webhooks-and-events/webhook-events-and-payloads#membership)、[フォーク](/developers/webhooks-and-events/webhook-events-and-payloads#fork)、[ping](/developers/webhooks-and-events/about-webhooks#ping-event) イベントタイプをサブスクライブできます。 +グローバル webhook は Enterprise にインストールされています。 グローバル webhook を使用して、Engerprise のユーザ、Organization、Team、およびリポジトリのルールを自動的に監視、対応、強制することができます。 グローバル webhook は、[Organization](/developers/webhooks-and-events/webhook-events-and-payloads#organization)、[ユーザ](/developers/webhooks-and-events/webhook-events-and-payloads#user)、[リポジトリ](/developers/webhooks-and-events/webhook-events-and-payloads#repository)、[Team](/developers/webhooks-and-events/webhook-events-and-payloads#team)、[メンバー](/developers/webhooks-and-events/webhook-events-and-payloads#member)、[メンバーシップ](/developers/webhooks-and-events/webhook-events-and-payloads#membership)、[フォーク](/developers/webhooks-and-events/webhook-events-and-payloads#fork)、[ping](/developers/webhooks-and-events/about-webhooks#ping-event) イベントタイプをサブスクライブできます。 *この API は、[認証された](/rest/overview/resources-in-the-rest-api#authentication)サイト管理者のみが使用できます。*通常のユーザがアクセスしようとすると、`404` レスポンスを受け取ります。 グローバル webhook の設定方法については、[グローバル webhookについて](/enterprise/admin/user-management/about-global-webhooks)を参照してください。 @@ -231,7 +231,7 @@ LDAP マッピングエンドポイントを使用すると、ユーザまたは {% tip %} -Management Console への API 呼び出しを行うときは、ポート番号を明示的に設定する必要があります。 If TLS is enabled on your enterprise, the port number is `8443`; otherwise, the port number is `8080`. +Management Console への API 呼び出しを行うときは、ポート番号を明示的に設定する必要があります。 Enterprise で TLS が有効になっている場合、ポート番号は `8443` です。それ以外の場合、ポート番号は `8080` です。 ポート番号を提供しない場合は、自動的にリダイレクトに従うようにツールを設定する必要があります。 @@ -264,7 +264,7 @@ $ curl -L 'https://api_key:your-amazing-password@hostname: {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ## Organization -The Organization Administration API allows you to create organizations on your enterprise. *[認証された](/rest/overview/resources-in-the-rest-api#authentication)サイト管理者のみが使用できます。*通常のユーザがアクセスしようとすると、`404` レスポンスを受け取ります。 +Organization 管理 API を使用すると、Enterprise に Organization を作成できます。 *[認証された](/rest/overview/resources-in-the-rest-api#authentication)サイト管理者のみが使用できます。*通常のユーザがアクセスしようとすると、`404` レスポンスを受け取ります。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'orgs' %}{% include rest_operation %}{% endif %} @@ -384,7 +384,7 @@ pre-receive フック API を使用すると、pre-receive フックを作成、 {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ## ユーザ -The User Administration API allows you to suspend{% if enterpriseServerVersions contains currentVersion %}, unsuspend, promote, and demote{% endif %}{% if currentVersion == "github-ae@latest" %} and unsuspend{% endif %} users on your enterprise. *これは[認証された](/rest/overview/resources-in-the-rest-api#authentication)サイト管理者のみが使用できます。*通常のユーザがアクセスしようとすると、`403` レスポンスを受け取ります。 +ユーザ管理 API では、Enterprise でユーザをサスペンド{% if enterpriseServerVersions contains currentVersion %}、サスペンド解除、昇格、降格、{% endif %}{% if currentVersion == "github-ae@latest" %}およびサスペンド解除{% endif %}できます。 *これは[認証された](/rest/overview/resources-in-the-rest-api#authentication)サイト管理者のみが使用できます。*通常のユーザがアクセスしようとすると、`403` レスポンスを受け取ります。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'users' %}{% include rest_operation %}{% endif %} diff --git a/translations/ja-JP/content/rest/reference/gists.md b/translations/ja-JP/content/rest/reference/gists.md index 02eb927ff870..308b175b53db 100644 --- a/translations/ja-JP/content/rest/reference/gists.md +++ b/translations/ja-JP/content/rest/reference/gists.md @@ -10,7 +10,7 @@ versions: ### 認証 -You can read public gists {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %}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)」を参照してください。 +パブリック Gist を読んで{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %}、トークンなしで匿名ユーザ向けに作成できます。{% else %} 匿名でも、Gist を作成するには GitHub にサインインする必要があります。{% endif %}ユーザに代わって Gist を読み書きするには、Gist OAuth スコープとトークンが必要です。 詳しい情報については、「[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 98c87db3d9ab..b83aa6cccd18 100644 --- a/translations/ja-JP/content/rest/reference/interactions.md +++ b/translations/ja-JP/content/rest/reference/interactions.md @@ -6,7 +6,7 @@ versions: free-pro-team: '*' --- -リポジトリに対するインタラクションには、コミット、Issueのオープン、プルリクエストの作成があります。 The Interactions APIs allow people with owner or admin access to temporarily restrict interaction with public repositories to a certain type of user. +リポジトリに対するインタラクションには、コミット、Issueのオープン、プルリクエストの作成があります。 インタラクションAPIを使用すると、オーナーまたは管理者アクセス権のあるユーザはパブリックリポジトリの操作を一時的に特定のユーザのタイプに制限することができます。 {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} @@ -14,13 +14,13 @@ versions: ## Organization -The Organization Interactions API allows organization owners to temporarily restrict which type of user can comment, open issues, or create pull requests in the organization's public repositories. {% data reusables.interactions.interactions-detail %} Here's more about the types of {% data variables.product.product_name %} users: +OrganizationのインタラクションAPIを使用すると、OrganizationのオーナーはOrganizationのパブリックリポジトリでコメント、Issueのオープン、プルリクエストの作成ができるユーザのタイプを一時的に制限することができます。 {% data reusables.interactions.interactions-detail %} {% data variables.product.product_name %} ユーザのタイプについては以下を参照してください。 * Organizationの{% data reusables.interactions.existing-user-limit-definition %} * Organizationの{% data reusables.interactions.contributor-user-limit-definition %} * Organizationの{% data reusables.interactions.collaborator-user-limit-definition %} -Setting the interaction limit at the organization level will overwrite any interaction limits that are set for individual repositories owned by the organization. To set different interaction limits for individual repositories owned by the organization, use the [Repository](#repository) interactions endpoints instead. +Organizationレベルでインタラクション制限を設定すると、Organizationが所有する個々のリポジトリに設定されているインタラクション制限は上書きされます。 Organizationが所有する個々のリポジトリに対して異なるインタラクション制限を設定するには、かわりに[リポジトリ](#repository)インタラクションエンドポイントを使用してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'orgs' %}{% include rest_operation %}{% endif %} @@ -28,13 +28,13 @@ Setting the interaction limit at the organization level will overwrite any inter ## Repository -The Repository Interactions API allows people with owner or admin access to temporarily restrict which type of user can comment, open issues, or create pull requests in a public repository. {% data reusables.interactions.interactions-detail %} Here's more about the types of {% data variables.product.product_name %} users: +リポジトリのインタラクションAPIを使用すると、オーナーまたは管理者アクセス権のあるユーザはパブリックリポジトリでコメント、Issueのオープン、プルリクエストの作成ができるユーザのタイプを一時的に制限することができます。 {% data reusables.interactions.interactions-detail %} {% data variables.product.product_name %} ユーザのタイプについては以下を参照してください。 -* {% 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. +* リポジトリの{% data reusables.interactions.existing-user-limit-definition %} +* リポジトリの{% data reusables.interactions.contributor-user-limit-definition %} +* リポジトリの{% data reusables.interactions.collaborator-user-limit-definition %} -If an interaction limit is enabled for the user or organization that owns the repository, the limit cannot be changed for the individual repository. Instead, use the [User](#user) or [Organization](#organization) interactions endpoints to change the interaction limit. +リポジトリを所有しているユーザまたはOrganizationについてインタラクション制限を有効にしている場合、個々のリポジトリについてその制限を変更することはできません。 インタラクション制限を変更するには、[ユーザ](#user)または[Organization](#organization)インタラクションエンドポイントを使用してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'repos' %}{% include rest_operation %}{% endif %} @@ -42,13 +42,13 @@ If an interaction limit is enabled for the user or organization that owns the re ## ユーザ -The User Interactions API allows you to temporarily restrict which type of user can comment, open issues, or create pull requests on your public repositories. {% data reusables.interactions.interactions-detail %} Here's more about the types of {% data variables.product.product_name %} users: +ユーザのインタラクションAPIを使用すると、自分のパブリックリポジトリでコメント、Issueのオープン、プルリクエストの作成ができるユーザのタイプを一時的に制限することができます。 {% data reusables.interactions.interactions-detail %} {% data variables.product.product_name %} ユーザのタイプについては以下を参照してください。 -* {% data reusables.interactions.existing-user-limit-definition %} from interacting with your repositories. -* {% data reusables.interactions.contributor-user-limit-definition %} from interacting with your repositories. -* {% data reusables.interactions.collaborator-user-limit-definition %} from interacting with your repositories. +* {% data reusables.interactions.existing-user-limit-definition %}が自分のリポジトリの操作を制限されます。 +* {% data reusables.interactions.contributor-user-limit-definition %}が自分のリポジトリの操作を制限されます。 +* {% data reusables.interactions.collaborator-user-limit-definition %}が自分のリポジトリの操作を制限されます。 -Setting the interaction limit at the user level will overwrite any interaction limits that are set for individual repositories owned by the user. To set different interaction limits for individual repositories owned by the user, use the [Repository](#repository) interactions endpoints instead. +ユーザレベルでインタラクション制限を設定すると、ユーザが所有する個々のリポジトリに設定されているインタラクション制限は上書きされます。 ユーザが所有する個々のリポジトリに対して異なるインタラクション制限を設定するには、かわりに[リポジトリ](#repository)インタラクションエンドポイントを使用してください。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'user' %}{% 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 089ba047dec9..8877ff776439 100644 --- a/translations/ja-JP/content/rest/reference/licenses.md +++ b/translations/ja-JP/content/rest/reference/licenses.md @@ -16,10 +16,10 @@ versions: **注釈:** 以下のエンドポイントも、リポジトリのライセンス情報を返します。 -- [リポジトリの Get](/rest/reference/repos#get-a-repository) +- [リポジトリの取得](/rest/reference/repos#get-a-repository) - [ユーザのリポジトリの一覧表示](/rest/reference/repos#list-repositories-for-a-user) - [Organization リポジトリの一覧表示](/rest/reference/repos#list-organization-repositories) -- [一覧表示のフォーク](/rest/reference/repos#list-forks) +- [フォークの一覧表示](/rest/reference/repos#list-forks) - [ユーザが Watch しているリポジトリの一覧表示](/rest/reference/activity#list-repositories-watched-by-a-user) - [Team リポジトリの一覧表示](/rest/reference/teams#list-team-repositories) diff --git a/translations/ja-JP/content/rest/reference/orgs.md b/translations/ja-JP/content/rest/reference/orgs.md index 32ef1c5cc204..308cea16ff25 100644 --- a/translations/ja-JP/content/rest/reference/orgs.md +++ b/translations/ja-JP/content/rest/reference/orgs.md @@ -38,7 +38,7 @@ Organization に対するブロック呼び出しを実行するには、呼び ## webhook -Organization の webhook を使用すると、Organization で特定のイベントが発生するとき必ず HTTP `POST` ペイロードを受け取ることができます。 Subscribing to these events makes it possible to build integrations that react to events on {% data variables.product.product_name %}. サブスクライブできるアクションの詳細は、「[{% data variables.product.prodname_dotcom %} のイベントタイプ](/developers/webhooks-and-events/github-event-types)」を参照してください。 +Organization の webhook を使用すると、Organization で特定のイベントが発生するとき必ず HTTP `POST` ペイロードを受け取ることができます。 そのようなイベントをサブスクライブすると、 {% data variables.product.product_name %} でのイベントに応答するインテグレーションを構築できます。 サブスクライブできるアクションの詳細は、「[{% data variables.product.prodname_dotcom %} のイベントタイプ](/developers/webhooks-and-events/github-event-types)」を参照してください。 ### スコープと制限事項 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 e181fd677f6b..bfeb14ba671a 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 @@ -135,12 +135,12 @@ _検索_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _アサインされた人_ _イベント_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _ラベル_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) @@ -822,7 +822,7 @@ _Team_ {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} -### Permission on "secret scanning alerts" +### "secret scanning alerts"に対する権限 - [`GET /repos/:owner/:repo/secret-scanning/alerts`](/rest/reference/secret-scanning#list-secret-scanning-alerts-for-a-repository) (:read) diff --git a/translations/ja-JP/content/rest/reference/pulls.md b/translations/ja-JP/content/rest/reference/pulls.md index 7e070a9fd127..8c7eb39b33f8 100644 --- a/translations/ja-JP/content/rest/reference/pulls.md +++ b/translations/ja-JP/content/rest/reference/pulls.md @@ -1,5 +1,5 @@ --- -title: Pulls +title: Pull Request redirect_from: - /v3/pulls versions: diff --git a/translations/ja-JP/content/rest/reference/repos.md b/translations/ja-JP/content/rest/reference/repos.md index f51ada9f279a..d2588f8ba522 100644 --- a/translations/ja-JP/content/rest/reference/repos.md +++ b/translations/ja-JP/content/rest/reference/repos.md @@ -190,10 +190,10 @@ Repo Merging API は、リポジトリ内にあるブランチのマージをサ * `built`: サイトがビルドされています。 * `errored`: ビルド中にエラーが発生したことを示します。 -In {% data variables.product.prodname_pages %} API endpoints that return GitHub Pages site information, the JSON responses include these fields: +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)を公開するために使用するリポジトリのブランチ。 For example, _main_ or _gh-pages_. + - `branch`: [サイトのソースファイル](/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site)を公開するために使用するリポジトリのブランチ。 たとえば、_main_ or _gh-pages_ などです。 - `path`: サイトの公開元のリポジトリディレクトリ。 `/` または `/docs` のどちらかとなります。 {% for operation in currentRestOperations %} @@ -220,7 +220,7 @@ Repository Statistics API を使用すると、{% data variables.product.product リポジトリの統計情報を計算するのは負荷が高い操作なので、可能な限りキャッシュされたデータを返すようにしています。 リポジトリの統計をクエリした際にデータがキャッシュされていなかった場合は、`202` レスポンスを受け取ります。また、この統計をまとめるため、バックグラウンドでジョブが開始します。 このジョブが完了するまで少し待ってから、リクエストを再度サブミットしてください。 ジョブが完了していた場合、リクエストは `200` レスポンスを受けとり、レスポンスの本文には統計情報が含まれています。 -Repository statistics are cached by the SHA of the repository's default branch; pushing to the default branch resets the statistics cache. +リポジトリの統計情報は、リポジトリのデフォルトブランチに SHA でキャッシュされ、デフォルトのブランチにプッシュすると統計情報のキャッシュがリセットされます。 ### 統計で除外されるコミットのタイプ @@ -298,7 +298,7 @@ GitHub は、すべてのリポジトリに対する [PubSubHubbub](https://gith #### コールバック URL コールバック URL は `http://` プロトコルを使用できます。 -{% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.20" %}You can also `github://` callbacks to specify a GitHub service. +{% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.20" %}また、`github://` コールバックで GitHub のサービスを指定することもできます。 {% data reusables.apps.deprecating_github_services_ghe %} {% endif %} diff --git a/translations/ja-JP/content/rest/reference/search.md b/translations/ja-JP/content/rest/reference/search.md index dee7e0969532..2ae53f67fe1e 100644 --- a/translations/ja-JP/content/rest/reference/search.md +++ b/translations/ja-JP/content/rest/reference/search.md @@ -10,7 +10,7 @@ versions: Search API は、見つけたい特定の項目を検索するために役立ちます。 たとえば、リポジトリ内のユーザや特定のファイルを見つけることができます。 Google で検索を実行するのと同じように考えてください。 Search API は、探している 1 つの結果 (または探しているいくつかの結果) を見つけるために役立つよう設計されています。 Google で検索する場合と同じように、ニーズに最も合う項目を見つけるため、検索結果を数ページ表示したい場合もあるでしょう。 こうしたニーズを満たすため、{% data variables.product.product_name %} Search API では**各検索につき 最大 1,000 件の結果**を提供します。 -クエリを使って、検索を絞り込めます。 To learn more about the search query syntax, see "[Constructing a search query](/rest/reference/search#constructing-a-search-query)." +クエリを使って、検索を絞り込めます。 検索クエリ構文の詳細については、「[検索クエリの構築](/rest/reference/search#constructing-a-search-query)」を参照してください。 ### 検索結果を順番づける @@ -18,7 +18,7 @@ Search API は、見つけたい特定の項目を検索するために役立ち ### レート制限 -Search API にはカスタムレート制限があります。 For requests using [Basic Authentication](/rest#authentication), [OAuth](/rest#authentication), or [client ID and secret](/rest#increasing-the-unauthenticated-rate-limit-for-oauth-applications), you can make up to 30 requests per minute. 認証されていないリクエストでは、レート制限により 1 分間あたり最大 10 件のリクエストが行えます。 +Search API にはカスタムレート制限があります。 リクエストに[基本認証](/rest#authentication)、[OAuth](/rest#authentication)、または[クライアント ID とシークレット](/rest#increasing-the-unauthenticated-rate-limit-for-oauth-applications)を使用する場合は、1 分間に最大 30 件のリクエストが行えます。 認証されていないリクエストでは、レート制限により 1 分間あたり最大 10 件のリクエストが行えます。 {% data reusables.enterprise.rate_limit %} @@ -28,7 +28,7 @@ Search API にはカスタムレート制限があります。 For requests usin Search API の各エンドポイントでは、{% data variables.product.product_name %} で検索を行うために[クエリパラメータ](https://en.wikipedia.org/wiki/Query_string)を使用します。 エンドポイントとクエリパラメータを含める例については、Search API の個々のエンドポイントを参照してください。 -A query can contain any combination of search qualifiers supported on {% data variables.product.product_name %}. 検索クエリの形式は次のとおりです。 +クエリには、{% data variables.product.product_name %} でサポートされている検索修飾子を任意に組み合わせて使用できます。 検索クエリの形式は次のとおりです。 ``` SEARCH_KEYWORD_1 SEARCH_KEYWORD_N QUALIFIER_1 QUALIFIER_N @@ -40,7 +40,7 @@ SEARCH_KEYWORD_1 SEARCH_KEYWORD_N QUALIFIER_1 QUALIFIER_N GitHub Octocat in:readme user:defunkt ``` -**Note:** Be sure to use your language's preferred HTML-encoder to construct your query strings. 例: +**ノート:** クエリ文字列の構築には、使用する言語の優先 HTML エンコーダを必ず使用してしてください。 例: ```javascript // JavaScript const queryString = 'q=' + encodeURIComponent('GitHub Octocat in:readme user:defunkt'); diff --git a/translations/ja-JP/content/rest/reference/secret-scanning.md b/translations/ja-JP/content/rest/reference/secret-scanning.md index 6c266b84885a..66b13d1da694 100644 --- a/translations/ja-JP/content/rest/reference/secret-scanning.md +++ b/translations/ja-JP/content/rest/reference/secret-scanning.md @@ -7,6 +7,6 @@ versions: {% data reusables.secret-scanning.api-beta %} -The {% data variables.product.prodname_secret_scanning %} API lets you retrieve and update secret scanning alerts from a private repository. For more information on secret scanning for private repositories, see "[Securing your repository](/github/administering-a-repository/securing-your-repository)." +{% data variables.product.prodname_secret_scanning %} API を使用すると、プライベートリポジトリからシークレットコードスキャンアラートを取得して更新することができます。 プライベートリポジトリのシークレットスキャンに関する詳しい情報については、「[リポジトリを保護する](/github/administering-a-repository/securing-your-repository)」を参照してください。 {% include rest_operations_at_current_path %} diff --git a/translations/ja-JP/content/rest/reference/teams.md b/translations/ja-JP/content/rest/reference/teams.md index 03bbe2cd7b50..56eb08ec1a87 100644 --- a/translations/ja-JP/content/rest/reference/teams.md +++ b/translations/ja-JP/content/rest/reference/teams.md @@ -16,7 +16,7 @@ versions: ## ディスカッション -Team ディスカッション API を使用すると、Team のページに投稿されたディスカッションを取得、作成、編集、削除できます。 Team のディスカッションは、リポジトリやプロジェクトに原生されない会話をするために利用できます。 Team の [Organization](/rest/reference/orgs) に属する全メンバーが、公開のディスカッション投稿を作成や表示できます。 The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. To learn more about commenting on a discussion post, see the [team discussion comments API](/rest/reference/teams#discussion-comments). この API は、Team の Organization の、認証済みメンバーのみが利用できます。 +Team ディスカッション API を使用すると、Team のページに投稿されたディスカッションを取得、作成、編集、削除できます。 Team のディスカッションは、リポジトリやプロジェクトに原生されない会話をするために利用できます。 Team の [Organization](/rest/reference/orgs) に属する全メンバーが、公開のディスカッション投稿を作成や表示できます。 The team discussions API allows you to get, create, edit, and delete discussion posts on a team's page. ディスカッションの投稿に対するコメントの詳細については、「[Team ディスカッションのコメント API](/rest/reference/teams#discussion-comments)」を参照してください。 この API は、Team の Organization の、認証済みメンバーのみが利用できます。 {% for operation in currentRestOperations %} {% if operation.subcategory == 'discussions' %}{% include rest_operation %}{% endif %} diff --git a/translations/ja-JP/content/rest/reference/users.md b/translations/ja-JP/content/rest/reference/users.md index 4b10d2c72a00..9956813da9c4 100644 --- a/translations/ja-JP/content/rest/reference/users.md +++ b/translations/ja-JP/content/rest/reference/users.md @@ -8,7 +8,7 @@ versions: github-ae: '*' --- -ユーザ API のリソースの多くには、現在認証されているユーザについての情報を取得するためのショートカットがあります。 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).{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} 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.{% endif %} +ユーザ API のリソースの多くには、現在認証されているユーザについての情報を取得するためのショートカットがあります。 リクエスト URL に `{username}` パラメータが含まれていない場合、レスポンスはログインしているユーザに対して行われます (リクエストで [認証情報](/rest/overview/resources-in-the-rest-api#authentication) を渡す必要があります)。{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}ユーザが 2 要素認証を有効にしているかなど、その他の個人情報は、基本認証または `user` スコープ付きで OAuth 認証されている場合に含まれます。{% endif %} {% for operation in currentRestOperations %} {% unless operation.subcategory %}{% include rest_operation %}{% endunless %} diff --git a/translations/ja-JP/data/release-notes/2-20/23.yml b/translations/ja-JP/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..bde9f73982f7 --- /dev/null +++ b/translations/ja-JP/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ja-JP/data/release-notes/2-21/14.yml b/translations/ja-JP/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..97d5bac00ab3 --- /dev/null +++ b/translations/ja-JP/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ja-JP/data/release-notes/2-22/6.yml b/translations/ja-JP/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..971924052fb5 --- /dev/null +++ b/translations/ja-JP/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/ja-JP/data/reusables/actions/environments-beta.md b/translations/ja-JP/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ja-JP/data/reusables/actions/forked-secrets.md b/translations/ja-JP/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..93fb22dadbe9 --- /dev/null +++ b/translations/ja-JP/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +`GITHUB_TOKEN`を除き、フォークしたリポジトリからワークフローがトリガーされた場合、シークレットは runner に渡されません。 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 84342d657173..a172d82608b8 100644 --- a/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ja-JP/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn` (v1 only) (specify `npm`) +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`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 %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. diff --git a/translations/ja-JP/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/ja-JP/data/reusables/developer-site/pull_request_forked_repos_link.md index 529943a07b41..e3e41cce9116 100644 --- a/translations/ja-JP/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/ja-JP/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -10,4 +10,4 @@ デフォルトでは、フォークされたリポジトリではワークフローは実行されません。 フォークされたリポジトリの** Actions**タブでGitHub Actionsを有効化しなければなりません。 -フォークしたリポジトリ内の `GITHUB_TOKEN` への権限は、読み取りのみです。 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. 詳しい情報については「[GITHUB_TOKENでの認証](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)」を参照してください。 diff --git a/translations/ja-JP/data/reusables/discussions/click-discussion-in-list.md b/translations/ja-JP/data/reusables/discussions/click-discussion-in-list.md index 8156c86331db..dcb50239d71c 100644 --- a/translations/ja-JP/data/reusables/discussions/click-discussion-in-list.md +++ b/translations/ja-JP/data/reusables/discussions/click-discussion-in-list.md @@ -1 +1 @@ -1. In the list of discussions, click the discussion you want to view. ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) +1. ディスカッションのリストで、表示するディスカッションをクリックします。 ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) diff --git a/translations/ja-JP/data/reusables/discussions/edit-category-details.md b/translations/ja-JP/data/reusables/discussions/edit-category-details.md index 8004b70314c3..f36364f2cdf7 100644 --- a/translations/ja-JP/data/reusables/discussions/edit-category-details.md +++ b/translations/ja-JP/data/reusables/discussions/edit-category-details.md @@ -1 +1 @@ -Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +カテゴリの絵文字、タイトル、説明、ディスカッション形式を編集します。 For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." diff --git a/translations/ja-JP/data/reusables/discussions/marking-a-comment-as-an-answer.md b/translations/ja-JP/data/reusables/discussions/marking-a-comment-as-an-answer.md index bdefffdea0d8..2fe94bf1de0d 100644 --- a/translations/ja-JP/data/reusables/discussions/marking-a-comment-as-an-answer.md +++ b/translations/ja-JP/data/reusables/discussions/marking-a-comment-as-an-answer.md @@ -1,4 +1,4 @@ -You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. 詳しい情報については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)」を参照してください。 When you mark a question as an answer, {% data variables.product.product_name %} will highlight the comment and replies to the comment to help visitors quickly find the answer. diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/ja-JP/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/ja-JP/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/ja-JP/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/gated-features/actions-shared.md b/translations/ja-JP/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..6eb38eb414d3 --- /dev/null +++ b/translations/ja-JP/data/reusables/gated-features/actions-shared.md @@ -0,0 +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 %}は、レガシーのリポジトリごとのプランを使っているアカウントが所有しているプライベートリポジトリでは利用できません。 diff --git a/translations/ja-JP/data/reusables/gated-features/actions.md b/translations/ja-JP/data/reusables/gated-features/actions.md index da659c796c40..bafbe8fae92d 100644 --- a/translations/ja-JP/data/reusables/gated-features/actions.md +++ b/translations/ja-JP/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{{ 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ja-JP/data/reusables/gated-features/auto-merge.md b/translations/ja-JP/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/ja-JP/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/gated-features/environments.md b/translations/ja-JP/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/ja-JP/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ja-JP/data/reusables/github-actions/permissions-statement-environment.md b/translations/ja-JP/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/ja-JP/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/ja-JP/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/ja-JP/data/reusables/github-actions/sidebar-environment.md b/translations/ja-JP/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/ja-JP/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. diff --git a/translations/ja-JP/data/reusables/notifications/outbound_email_tip.md b/translations/ja-JP/data/reusables/notifications/outbound_email_tip.md index ab27e597f5fe..2b9e7018effa 100644 --- a/translations/ja-JP/data/reusables/notifications/outbound_email_tip.md +++ b/translations/ja-JP/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. 詳しい情報については、サイト管理者にお問い合わせください。 {% endnote %} - {% endif %} diff --git a/translations/ja-JP/data/reusables/organizations/add-dns-txt-record.md b/translations/ja-JP/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..9e404c17f073 --- /dev/null +++ b/translations/ja-JP/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. ドメインホスティングサービスで DNS TXT レコードを作成するには、「**DNS TXT レコードを追加する**」の手順に従ってください。 ![DNS テキストレコードを作成するための手順](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/organizations/add-domain.md b/translations/ja-JP/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..54a585b61c35 --- /dev/null +++ b/translations/ja-JP/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. ドメインフィールドに検証するドメインを入力し、[**Add domain**] をクリックします。 ![[Add a domain] フィールド](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/organizations/continue-verifying-domain.md b/translations/ja-JP/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..d25f40fa175d --- /dev/null +++ b/translations/ja-JP/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![ドメインの検証を続行するボタン](/assets/images/help/organizations/continue-verifying-domain.png) +10. [**Verify domain**] をクリックします。 ![ドメイン検証ボタン](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/organizations/restrict-email-notifications.md b/translations/ja-JP/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..e7b8c73d5c86 --- /dev/null +++ b/translations/ja-JP/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. [Enforcement preferences] の下で、[**Restrict email notifications to domain email**] を選択します。 ![メール通知を検証済みドメインのメールに制限するためのチェックボックス](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/organizations/verified-domains-details.md b/translations/ja-JP/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..f19df6236c32 --- /dev/null +++ b/translations/ja-JP/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. Organization のプロフィールに表示されているウェブサイトとメールアドレスが異なるドメインでホストされている場合は、両方のドメインを検証する必要があります。 If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/pages/wildcard-dns-warning.md b/translations/ja-JP/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..414099e86ccf --- /dev/null +++ b/translations/ja-JP/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**警告:** `*.example.com` など、ワイルドカード DNS レコードは使わないでください。 ワイルドカード DNS レコードにより、あなたのサブドメインの 1 つで {% data variables.product.prodname_pages %}サイトを誰でもホストできるようになります。 + +{% endwarning %} 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 e02fdea38195..2bab45542fcc 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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 %} +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)." diff --git a/translations/ja-JP/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/ja-JP/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/ja-JP/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ja-JP/data/reusables/pull_requests/you-can-auto-merge.md b/translations/ja-JP/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..410aec2a8ee8 --- /dev/null +++ b/translations/ja-JP/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." +{% endif %} \ No newline at end of file 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 3a5f57be3338..926657401a5d 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 @@ -117,6 +117,7 @@ runs: {% endraw %} #### `outputs..value` + **Required** The value that the output parameter will be mapped to. You can set this to a `string` or an expression with context. For example, you can use the `steps` context to set the `value` of an output to the output value of a step. 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)". @@ -204,9 +205,11 @@ For example, this `cleanup.js` will only run on Linux-based runners: **Required** The run steps that you plan to run in this action. -##### `runs.steps.run` +##### `runs.steps[*].run` **Required** The command you want to run. This can be inline or a script in your action repository: + +{% raw %} ```yaml runs: using: "composite" @@ -214,6 +217,7 @@ runs: - run: ${{ github.action_path }}/test/script.sh shell: bash ``` +{% endraw %} Alternatively, you can use `$GITHUB_ACTION_PATH`: @@ -227,23 +231,23 @@ runs: For more information, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -##### `runs.steps.shell` +##### `runs.steps[*].shell` **Required** The shell where you want to run the command. You can use any of the shells listed [here](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). -##### `runs.steps.name` +##### `runs.steps[*].name` **Optional** The name of the composite run step. -##### `runs.steps.id` +##### `runs.steps[*].id` **Optional** A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". -##### `runs.steps.env` +##### `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 {% 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` +##### `runs.steps[*].working-directory` **Optional** Specifies the working directory where the command is run. diff --git a/translations/ko-KR/content/actions/guides/about-continuous-integration.md b/translations/ko-KR/content/actions/guides/about-continuous-integration.md index cf480c9c8b52..baf265429346 100644 --- a/translations/ko-KR/content/actions/guides/about-continuous-integration.md +++ b/translations/ko-KR/content/actions/guides/about-continuous-integration.md @@ -25,7 +25,7 @@ Building and testing your code requires a server. You can build and test updates ### 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)." +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. 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 index 54b5a8a71fd7..95de8c5f8fa3 100644 --- a/translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/ko-KR/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% 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)." +To authenticate to your private registry, you'll need to store your npm authentication token as a secret. For example, create a repository 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. +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 `NODE_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). diff --git a/translations/ko-KR/content/actions/guides/building-and-testing-powershell.md b/translations/ko-KR/content/actions/guides/building-and-testing-powershell.md index 4b2ff9372fc0..01d01bcd7851 100644 --- a/translations/ko-KR/content/actions/guides/building-and-testing-powershell.md +++ b/translations/ko-KR/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ The `always()` function configures the job to continue processing even if there ### Publishing to PowerShell Gallery -You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use repository secrets to store any tokens or credentials needed to publish your package. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." +You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use secrets to store any tokens or credentials needed to publish your package. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." The following example creates a package and uses `Publish-Module` to publish it to the PowerShell Gallery: 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 index dcebfbbeb031..ec0b8c3bab1d 100644 --- a/translations/ko-KR/content/actions/guides/building-and-testing-python.md +++ b/translations/ko-KR/content/actions/guides/building-and-testing-python.md @@ -391,7 +391,7 @@ jobs: 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)." +You can store any access tokens or credentials needed to publish your package using 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 diff --git a/translations/ko-KR/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/ko-KR/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..e5cf699608f6 --- /dev/null +++ b/translations/ko-KR/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: Deploying to Amazon Elastic Container Service +intro: You can deploy to Amazon Elastic Container Service (ECS) as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/), and deploy it to [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/). + +On every new release in your {% data variables.product.company_short %} repository, the {% data variables.product.prodname_actions %} workflow builds and pushes a new container image to Amazon ECR, and then deploys a new task definition to Amazon ECS. + +### 빌드전 요구 사양 + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps for Amazon ECR and ECS: + +1. Create an Amazon ECR repository to store your images. + + For example, using [the AWS CLI](https://aws.amazon.com/cli/): + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Ensure that you use the same Amazon ECR repository name (represented here by `MY_ECR_REPOSITORY`) for the `ECR_REPOSITORY` variable in the workflow below. + + Ensure that you use the same AWS region value for the `AWS_REGION` (represented here by `MY_AWS_REGION`) variable in the workflow below. + +2. Create an Amazon ECS task definition, cluster, and service. + + For details, follow the [Getting started wizard on the Amazon ECS console](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), or the [Getting started guide](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) in the Amazon ECS documentation. + + Ensure that you note the names you set for the Amazon ECS service and cluster, and use them for the `ECS_SERVICE` and `ECS_CLUSTER` variables in the workflow below. + +3. Store your Amazon ECS task definition as a JSON file in your {% data variables.product.company_short %} repository. + + The format of the file should be the same as the output generated by: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Ensure that you set the `CONTAINER_NAME` variable in the workflow below as the container name in the `containerDefinitions` section of the task definition. + +4. Create {% data variables.product.prodname_actions %} secrets named `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to store the values for your Amazon IAM access key. + + For more information on creating secrets for {% data variables.product.prodname_actions %}, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + See the documentation for each action used below for the recommended IAM policies for the IAM user, and methods for handling the access key credentials. + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to Amazon ECR. It then updates the task definition with the new image ID, and deploys the task definition to Amazon ECS. + +Ensure that you provide your own values for all the variables in the `env` key of the workflow. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### Additional resources + +For more information on the services used in these examples, see the following documentation: + +* "[Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)" in the Amazon AWS documentation. +* Official AWS "[Configure AWS Credentials](https://github.com/aws-actions/configure-aws-credentials)" action. +* Official AWS [Amazon ECR "Login"](https://github.com/aws-actions/amazon-ecr-login) action. +* Official AWS [Amazon ECS "Render Task Definition"](https://github.com/aws-actions/amazon-ecs-render-task-definition) action. +* Official AWS [Amazon ECS "Deploy Task Definition"](https://github.com/aws-actions/amazon-ecs-deploy-task-definition) action. diff --git a/translations/ko-KR/content/actions/guides/deploying-to-azure-app-service.md b/translations/ko-KR/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..41e19c44f266 --- /dev/null +++ b/translations/ko-KR/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: Deploying to Azure App Service +intro: You can deploy to Azure App Service as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build, test, and deploy an application to [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/). + +Azure App Service can run web apps in several languages, but this guide demonstrates deploying an existing Node.js project. + +### 빌드전 요구 사양 + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps: + +1. Create an Azure App Service plan. + + For example, you can use the Azure CLI to create a new App Service plan: + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + In the command above, replace `MY_RESOURCE_GROUP` with your pre-existing Azure Resource Group, and `MY_APP_SERVICE_PLAN` with a new name for the App Service plan. + + See the Azure documentation for more information on using the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/): + + * For authentication, see "[Sign in with Azure CLI](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)". + * If you need to create a new resource group, see "[az group](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)." + +2. Create a web app. + + For example, you can use the Azure CLI to create an Azure App Service web app with a node runtime: + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + In the command above, replace the parameters with your own values, where `MY_WEBAPP_NAME` is a new name for the web app. + +3. Configure an Azure publish profile and create an `AZURE_WEBAPP_PUBLISH_PROFILE` secret. + + Generate your Azure deployment credentials using a publish profile. For more information, see "[Generate deployment credentials](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" in the Azure documentation. + + In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build, test, and deploy the Node.js project to Azure App Service. + +Ensure that you set `AZURE_WEBAPP_NAME` in the workflow `env` key to the name of the web app you created. + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### Additional resources + +The following resources may also be useful: + +* For the original starter workflow, see [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml) in the {% data variables.product.prodname_actions %} `starter-workflows` repository. +* The action used to deploy the web app is the official Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) action. +* The "[Create a Node.js web app in Azure](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)" quickstart in the Azure web app documentation demonstrates using VS Code with the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). diff --git a/translations/ko-KR/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/ko-KR/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..68ab5f946368 --- /dev/null +++ b/translations/ko-KR/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: Deploying to Google Kubernetes Engine +intro: You can deploy to Google Kubernetes Engine as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to Google Container Registry (GCR), and deploy it to Google Kubernetes Engine (GKE). + +GKE is a managed Kubernetes cluster service from Google Cloud that can host your containerized workloads in the cloud or in your own datacenter. For more information, see [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine). + +### 빌드전 요구 사양 + +Before you proceed with creating the workflow, you will need to complete the following steps for your Kubernetes project. This guide assumes the root of your project already has a `Dockerfile` and a Kubernetes Deployment configuration file. For an example, see [google-github-actions](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke). + +#### Creating a GKE cluster + +To create the GKE cluster, you will first need to authenticate using the `gcloud` CLI. For more information on this step, see the following articles: +- [`gcloud auth login`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI and Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +예시: + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### Enabling the APIs + +Enable the Kubernetes Engine and Container Registry APIs. 예시: + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### Configuring a service account and storing its credentials + +This procedure demonstrates how to create the service account for your GKE integration. It explains how to create the account, add roles to it, retrieve its keys, and store them as a base64-encoded [encrypted repository secret](/actions/reference/encrypted-secrets) named `GKE_SA_KEY`. + +1. Create a new service account: + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. Retrieve the email address of the service account you just created: + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. Add roles to the service account. Note: Apply more restrictive roles to suit your requirements. + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. Download the JSON keyfile for the service account: + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. Store the project ID as a secret named `GKE_PROJECT`: + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### (Optional) Configuring kustomize +Kustomize is an optional tool used for managing YAML specs. After creating a _kustomization_ file, the workflow below can be used to dynamically set fields of the image and pipe in the result to `kubectl`. For more information, see [kustomize usage](https://github.com/kubernetes-sigs/kustomize#usage). + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to GCR. It then uses the Kubernetes tools (such as `kubectl` and `kustomize`) to pull the image into the cluster deployment. + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### Additional resources + +For more information on the tools used in these examples, see the following documentation: + +* For the full starter workflow, see the ["Build and Deploy to GKE" workflow](https://github.com/actions/starter-workflows/blob/master/ci/google.yml). +* For more starter workflows and accompanying code, see Google's [{% data variables.product.prodname_actions %} example workflows](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/). +* The Kubernetes YAML customization engine: [Kustomize](https://kustomize.io/). +* "[Deploying a containerized web application](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)" in the Google Kubernetes Engine documentation. diff --git a/translations/ko-KR/content/actions/guides/index.md b/translations/ko-KR/content/actions/guides/index.md index 64a7ff00c5a1..642a9e37fd3e 100644 --- a/translations/ko-KR/content/actions/guides/index.md +++ b/translations/ko-KR/content/actions/guides/index.md @@ -36,6 +36,14 @@ You can use {% data variables.product.prodname_actions %} to create custom conti {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### Creating custom continuous deployment workflows + +You can use {% data variables.product.prodname_actions %} to create custom continuous deployment (CD) workflows that deploy projects to a number of cloud partner ecosystems. + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### 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 %}. diff --git a/translations/ko-KR/content/actions/guides/publishing-docker-images.md b/translations/ko-KR/content/actions/guides/publishing-docker-images.md index 14b0cade150b..471181a1f11c 100644 --- a/translations/ko-KR/content/actions/guides/publishing-docker-images.md +++ b/translations/ko-KR/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ In this guide, we will use the Docker `build-push-action` action to build the Do 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. +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 "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" 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 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)." +* `username` and `password`: This is your Docker Hub username and password. We recommend storing your Docker Hub username and password as secrets 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 %} diff --git a/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md b/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md index 3a402d35a1a2..63e608ec3d7d 100644 --- a/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/ko-KR/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ If you add steps in your workflow to configure the `publishConfig` fields in you 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)." +To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret. For example, create a repository 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`. diff --git a/translations/ko-KR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/ko-KR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index a2f5f1a7ecd4..b24159ce4967 100644 --- a/translations/ko-KR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/translations/ko-KR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/ko-KR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/ko-KR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md index 22c7a83c6175..bdaeed7caae0 100644 --- a/translations/ko-KR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md +++ b/translations/ko-KR/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/ko-KR/content/actions/index.md b/translations/ko-KR/content/actions/index.md index 4365c6f49508..39b2e0d29179 100644 --- a/translations/ko-KR/content/actions/index.md +++ b/translations/ko-KR/content/actions/index.md @@ -25,6 +25,10 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: + - + title: Workflow visualization + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ - title: Removing set-env and add-path commands on November 16 date: '2020-11-09' @@ -33,14 +37,6 @@ changelog: title: Ubuntu-latest workflows will use Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - - title: MacOS Big Sur Preview - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - - title: Self-Hosted Runner Group Access Changes - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU redirect_from: - /articles/automating-your-workflow-with-github-actions/ 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 index e50e08fbb46a..5bd9b1da4527 100644 --- 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 @@ -76,7 +76,7 @@ steps: #### 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`: +Referring to a specific branch means that the action will always use 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: 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 index 4a13f941e639..13deaaa494bd 100644 --- 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 @@ -1,7 +1,7 @@ --- 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.' +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,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} environments,{% endif %} and labels.' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Using environments + +You can configure environments with protection rules and secrets. Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." +{% endif %} + ### 다음 단계 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-jenkins-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md index 836994f01bba..6c7b2ae264ef 100644 --- 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 @@ -57,7 +57,7 @@ Jenkins uses directives to manage _Declarative Pipelines_. These directives defi | 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) | +| [`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) | diff --git a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index 83f15f782d56..1f2dabdd03b7 100644 --- a/translations/ko-KR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/ko-KR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ When migrating from Travis CI, consider the following key features in {% data va #### Storing secrets -{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} also includes policies that allow you to limit access to secrets at the repository and organization level. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." +{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} organizations can limit which repositories can access organization secrets. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Environment protection rules can require manual approval for a workflow to access environment secrets. {% endif %}For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." #### Sharing files between jobs and workflows 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 index b22d715c606c..f6968cbd0fb1 100644 --- 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 @@ -19,7 +19,7 @@ This guide explains how to configure security hardening for certain {% data vari ### 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 %}. +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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environment{% else %} or repository{% endif %} 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. @@ -38,6 +38,10 @@ To help prevent accidental disclosure, {% data variables.product.product_name %} - **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. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Environments](/actions/reference/environments)." +{% endif %} ### Using third-party actions @@ -66,13 +70,13 @@ This means that a compromise of a single action within a workflow can be very si ### 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. +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` 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 a workflow, 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. +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. 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** +1. **The `GITHUB_TOKEN`** - 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** 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 index f28a20c8b64e..a4787be05af4 100644 --- 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 @@ -13,6 +13,9 @@ versions: 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/index.md b/translations/ko-KR/content/actions/managing-workflow-runs/index.md index 8905d8b08742..4d5e7554b128 100644 --- a/translations/ko-KR/content/actions/managing-workflow-runs/index.md +++ b/translations/ko-KR/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- 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.' +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}review deployments, {% endif %}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 @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/ko-KR/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/ko-KR/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..cbeb7fe2ce54 --- /dev/null +++ b/translations/ko-KR/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: Reviewing deployments +intro: You can approve or reject jobs awaiting review. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About required reviews in workflows + +Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled. + +For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." + +### Approving or rejecting a job + +1. Navigate to the workflow run that requires review. For more information about navigating to a workflow run, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." +2. Click **Review deployments**. ![Review deployments](/assets/images/actions-review-deployments.png) +3. Select the job environment(s) to approve or reject. Optionally, leave a comment. ![Approve deployments](/assets/images/actions-approve-deployments.png) +4. Approve or reject: + - To approve the job, click **Approve and deploy**. Once a job is approved (and any other environment protection rules have passed), the job will proceed. At this point, the job can access any secrets stored in the environment. + - To reject the job, click **Reject**. If a job is rejected, the workflow will fail. 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 index 04790351aa7c..c48612c32a71 100644 --- a/translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/ko-KR/content/actions/reference/authentication-in-a-workflow.md @@ -14,8 +14,6 @@ versions: {% 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. diff --git a/translations/ko-KR/content/actions/reference/encrypted-secrets.md b/translations/ko-KR/content/actions/reference/encrypted-secrets.md index 25d65026bffd..27718794c104 100644 --- a/translations/ko-KR/content/actions/reference/encrypted-secrets.md +++ b/translations/ko-KR/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- title: Encrypted secrets -intro: Encrypted secrets allow you to store sensitive information in your repository or organization. +intro: Encrypted secrets allow you to store sensitive information in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environments{% else %} or repository{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,14 +12,19 @@ versions: --- {% data reusables.actions.enterprise-beta %} +{% data reusables.actions.environments-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. +Secrets are encrypted environment variables that you create in an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environment{% else %} or repository{% endif %}. The secrets that 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +For secrets stored at the environment level, you can enable required reviewers to control access to the secrets. A workflow job cannot access environment secrets until approval is granted by required approvers. +{% endif %} + #### Naming your secrets The following rules apply to secret names: @@ -27,7 +32,10 @@ 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. +* Secret names are not case-sensitive. +* Secret names must be unique at the level they are created at. For example, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}a secret created at the environment level must have a unique name in that environment, {% endif %}a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level. + + If a secret with the same name exists at multiple levels, the secret at the lower level takes precedence. For example, if an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Similarly, if an organization, repository, and environment all have a secret with the same name, the environment-level secret takes precedence.{% endif %} 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. @@ -43,6 +51,10 @@ You can use and read encrypted secrets in a workflow file if you have access to {% endwarning %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Organization and repository secrets are read when a workflow run is queued, and environment secrets are read when a job referencing the environment starts. +{% endif %} + You can also manage secrets using the REST API. For more information, see "[Secrets](/rest/reference/actions#secrets)." #### Limiting credential permissions @@ -56,12 +68,27 @@ When generating credentials, we recommend that you grant the minimum permissions {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.github-actions.sidebar-secret %} -1. Click **Add a new secret**. +1. Click **New repository 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. +If your repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}has environment secrets or {% endif %}can access secrets from the parent organization, then those secrets are also listed on this page. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Creating encrypted secrets for an environment + +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click on the environment that you want to add a secret to. +1. Under **Environment secrets**, click **Add secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the value for your secret. +1. Click **Add secret**. +{% endif %} ### Creating encrypted secrets for an organization @@ -72,7 +99,7 @@ When creating a secret in an organization, you can use a policy to limit which r {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.sidebar-secret %} -1. Click **New secret**. +1. Click **New organization 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. @@ -90,7 +117,7 @@ You can check which access policies are being applied to a secret in your organi ### 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. +{% data reusables.actions.forked-secrets %} 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)." @@ -150,7 +177,7 @@ steps: ### Limits for secrets -Your workflow can have up to 100 secrets. The names of secret environment variables must be unique in a repository. +You can store up to 1,000 secrets per organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 secrets per repository, and 100 secrets per environment{% else %} and 100 secrets per repository{% endif %}. A workflow may use up to 100 organization secrets and 100 repository secrets.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Additionally, a job referencing an environment may use up to 100 environment secrets.{% endif %} 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)." diff --git a/translations/ko-KR/content/actions/reference/environment-variables.md b/translations/ko-KR/content/actions/reference/environment-variables.md index 84a90d824029..dfe3f897f0b8 100644 --- a/translations/ko-KR/content/actions/reference/environment-variables.md +++ b/translations/ko-KR/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)." +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: @@ -51,8 +51,8 @@ We strongly recommend that actions use environment variables to access the files | `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_HEAD_REF` | Only set for pull request events. The name of the head branch. | +| `GITHUB_BASE_REF` | Only set for pull request events. The name of the base branch. | | `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 %}`. | diff --git a/translations/ko-KR/content/actions/reference/environments.md b/translations/ko-KR/content/actions/reference/environments.md new file mode 100644 index 000000000000..58585b2950b1 --- /dev/null +++ b/translations/ko-KR/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: Environments +intro: You can configure environments with protection rules and secrets. A workflow job can reference an environment to use the environment's protection rules and secrets. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About environments + +You can configure environments with protection rules and secrets. When a workflow job references an environment, the job won't start until all of the environment's protection rules pass. A job also cannot access secrets that are defined in an environment until all the environment protection rules pass. + +{% if currentVersion == "free-pro-team@latest" %} +Environment protection rules and environment secrets are only available on public repositories. If you convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. +{% endif %} + +#### Environment protection rules + +Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use environment protection rules to require a manual approval or to delay a job. + +##### Required reviewers + +Use required reviewers to require a specific person or team to approve workflow jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed. + +For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +##### Wait timer + +Use a wait timer to delay a job for a specific amount of time after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days). + +#### Environment secrets + +Secrets stored in an environment are only available to workflow jobs that reference the environment. If the environment requires approval, a job cannot access environment secrets until one of the required reviewers approves it. For more information about secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Creating an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click **New environment**. +1. Enter a name for the environment, then click **Configure environment**. Environment names are not case sensitive. An environment name may not exceed 255 characters and must be unique within the repository. +1. Configure any environment protection rules or environment secrets. + +Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment. + +### Referencing an environment + +Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. When the job is sent to the runner, the job can access the environment's secrets. + +For more information on syntax to reference environments in workflows, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)." For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +When a workflow references an environment, the environment will appear in the repository's deployments. For more information about viewing current and previous deployments, see "[Viewing deployment history](/developers/overview/viewing-deployment-history)." + +### Deleting an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +Deleting an environment will delete all secrets and protection rules associated with the environment. Any jobs currently waiting because of protection rules from the deleted environment will automatically fail. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Next the the environment that you want to delete, click {% octicon "trashcan" aria-label="The trashcan icon" %}. +2. Click **I understand, delete this environment**. 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 5fda97dde63d..e0a6771dd96a 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 @@ -309,9 +309,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`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -576,7 +576,13 @@ on: #### `pull_request_target` -This event is similar to `pull_request`, except that it runs in the context of the base repository of the pull request, rather than in the merge commit. This means that you can more safely make your secrets available to the workflows triggered by the pull request, because only workflows defined in the commit on the base repository are run. For example, this event allows you to create workflows that label and comment on pull requests, based on the contents of the event payload. +This event runs in the context of the base of the pull request, rather than in the merge commit as the `pull_request` event does. This prevents executing unsafe workflow code from the head of the pull request that could alter your repository or steal any secrets you use in your workflow. This event allows you to do things like create workflows that label and comment on pull requests based on the contents of the event payload. + +{% warning %} + +**Warning:** The `pull_request_target` event is granted a read/write repository token and can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch, and to help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. + +{% endwarning %} | Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | @@ -725,4 +731,4 @@ on: {% 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)." -If you would like to trigger a workflow from a workflow run, you can trigger the event using a personal access token. You'll need to create a personal access token and store it as a secret. To minimize your {% data variables.product.prodname_actions %} usage costs, ensure that you don't create recursive or unintended workflow runs. For more information, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." +If you would like to trigger a workflow from a workflow run, you can trigger the event using a personal access token. You'll need to create a personal access token and store it as a secret. To minimize your {% data variables.product.prodname_actions %} usage costs, ensure that you don't create recursive or unintended workflow runs. For more information on storing a personal access token as a secret, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." diff --git a/translations/ko-KR/content/actions/reference/index.md b/translations/ko-KR/content/actions/reference/index.md index 14ce3baec307..39bfc39f5c85 100644 --- a/translations/ko-KR/content/actions/reference/index.md +++ b/translations/ko-KR/content/actions/reference/index.md @@ -27,11 +27,19 @@ You can configure workflows to run when specific GitHub events occur, at a sched ### 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. +{% 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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environments{% else %} or repository{% endif %}. {% data variables.product.prodname_dotcom %} encrypts all secrets. {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Environments + +Workflow jobs can reference environments that have protection rules or environment-specific secrets. + +{% link_in_list /environments %} +{% endif %} + ### {% 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. 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 c541de20278d..8056b1f8aec9 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 @@ -305,11 +305,13 @@ steps: `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. +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### 예시 +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 7a269bf6c464..7a63ff729da6 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 @@ -187,7 +187,7 @@ For more information about cron syntax, see "[Events that trigger workflows](/ac ### `env` -A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: A workflow run is made up of one or more jobs. Jobs run in parallel by default. To run jobs sequentially, you can define dependencies on other jobs using the `jobs..needs` keyword. -Each job runs in an environment specified by `runs-on`. +Each job runs in a runner 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 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. @@ -320,6 +320,39 @@ 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)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +The environment that the job references. All environment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." + +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[Deployments](/rest/reference/repos#deployments)." + +##### Example using a single environment name + +```yaml +environment: staging_environment +``` + +##### Example using environment name and URL + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +The URL can be an expression and can use any context except for the `secrets` context. For more information about expressions, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +#### 예시 +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `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). @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `jobs..steps[*].id` A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." -### `jobs..steps.if` +### `jobs..steps[*].if` You can use the `if` conditional to prevent a step from running unless a condition is met. You can use any supported context and expression to create a conditional. @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` A name for your step to display on {% data variables.product.prodname_dotcom %}. -### `jobs..steps.uses` +### `jobs..steps[*].uses` Selects an action to run as part of a step in your job. An action is a reusable unit of code. You can use an action defined in the same repository as the workflow, a public repository, or in a [published Docker container image](https://hub.docker.com/). @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` Runs command-line programs using the operating system's shell. If you do not provide a `name`, the step name will default to the text specified in the `run` command. @@ -675,7 +708,7 @@ For built-in shell keywords, we provide the following defaults that are executed - There doesn't seem to be a way to fully opt into fail-fast behavior other than writing your script to check each error code and respond accordingly. Because we can't actually provide that behavior by default, you need to write this behavior into your script. - `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. This behavior is internally consistent with the previous `sh` and `pwsh` default behavior and is the `cmd.exe` default, so this behavior remains intact. -### `jobs..steps.with` +### `jobs..steps[*].with` A `map` of the input parameters defined by the action. Each input parameter is a key/value pair. Input parameters are set as environment variables. The variable is prefixed with `INPUT_` and converted to upper case. @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` A `string` that defines the inputs for a Docker container. {% data variables.product.prodname_dotcom %} passes the `args` to the container's `ENTRYPOINT` when the container starts up. An `array of strings` is not supported by this parameter. @@ -718,7 +751,7 @@ 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` +### `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. @@ -734,7 +767,7 @@ steps: The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs. -### `jobs..steps.env` +### `jobs..steps[*].env` Sets environment variables for steps to use in the runner environment. You can also set environment variables for the entire workflow or a job. For more information, see [`env`](#env) and [`jobs..env`](#jobsjob_idenv). @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` Prevents a job from failing when a step fails. Set to `true` to allow a job to pass when this step fails. -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` The maximum number of minutes to run the step before killing the process. @@ -769,7 +802,7 @@ The maximum number of minutes to let a job run before {% data variables.product. ### `jobs..strategy` -A strategy creates a build matrix for your jobs. You can define different variations of an environment to run each job in. +A strategy creates a build matrix for your jobs. You can define different variations to run each job in. ### `jobs..strategy.matrix` diff --git a/translations/ko-KR/content/admin/configuration/configuring-email-for-notifications.md b/translations/ko-KR/content/admin/configuration/configuring-email-for-notifications.md index 5ed5607bf3b5..03d990e4b93d 100644 --- a/translations/ko-KR/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/ko-KR/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ Your dedicated technical account manager in {% data variables.contact.github_support %} can configure email for notifications to be sent through your SMTP server. Make sure you include the following details in your support request. - Your SMTP server address +- Login information to authenticate to the server: username and password - The port your SMTP server uses to send email - The domain name that your SMTP server will send with a HELO response, if any - The type of encryption used by your SMTP server diff --git a/translations/ko-KR/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/ko-KR/content/admin/enterprise-support/about-github-enterprise-support.md index a3e54c5e3bb2..1825fd327334 100644 --- a/translations/ko-KR/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/ko-KR/content/admin/enterprise-support/about-github-enterprise-support.md @@ -94,7 +94,7 @@ For urgent issues, we can help you in English 24 hours per day, 7 days per week, | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | New Year's Eve | December 31 | #### Holidays in Japan 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 c55070a9cf44..1a2443f5325a 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 @@ -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. -| U.S. holiday | Date observed in 2018 | +| U.S. holiday | Date observed | | --------------------------- | --------------------------- | | New Year's Day | January 1 | | Martin Luther King, Jr. Day | Third Monday in January | @@ -57,7 +57,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | New Year's Eve | December 31 | ### Installing {% data variables.product.prodname_advanced_security %} updates 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 26731d2fac88..4c37b9eed58f 100644 --- a/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md +++ b/translations/ko-KR/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ An enterprise account allows you to manage multiple organizations{% if enterpris - Security {% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication) - Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} 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 332a10367342..dc9c4161eaa8 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 @@ -51,6 +51,7 @@ GitHub Desktop keyboard shortcuts on macOS | ⌘2 | Show your commit history | | ⌘B | Show all your branches | | ⌘G | Go to the commit summary field | +| ⌘Enter | Commit changes when summary or description field is active | | space | Select or deselect all highlighted files | | ⇧⌘N | Create a new branch | | ⇧⌘R | Rename the current branch | @@ -104,6 +105,7 @@ GitHub Desktop keyboard shortcuts on Windows | Ctrl2 | Show your commit history | | CtrlB | Show all your branches | | CtrlG | Go to the commit summary field | +| CtrlEnter | Commit changes when summary or description field is active | | space | Select or deselect all highlighted files | | CtrlShiftN | Create a new branch | | CtrlShiftR | Rename the current branch | 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 fb00d5b28ac1..afeb51ed3186 100644 --- a/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ko-KR/content/developers/apps/authorizing-oauth-apps.md @@ -265,7 +265,9 @@ The optional `redirect_uri` parameter can also be used for localhost URLs. If th For the `http://localhost/path` callback URL, you can use this `redirect_uri`: - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### Creating multiple tokens for OAuth Apps 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 aa11e4c59ac8..fe46ea022c23 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 @@ -49,39 +49,39 @@ The complete list of available query parameters, permissions, and events is list 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](/rest/reference/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](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`. | +| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | +| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/rest/reference/users#emails). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/users#keys). 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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/orgs#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/rest/reference/interactions#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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/repos#hooks). 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](/rest/reference/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](/rest/reference/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](/rest/reference/projects). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} | [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Grants access to the [Secret scanning API](/rest/reference/secret-scanning). Can be one of: `none`, `read`, or `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | Grants access to the [Code scanning API](/rest/reference/code-scanning/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/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`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/teams#discussion-comments). Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `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`.{% endif %} +| `시청` | 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 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 c16a98f38e8c..06d02a63f01d 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 @@ -85,7 +85,7 @@ Unlike OAuth apps, GitHub Apps have targeted permissions that allow them to requ | GitHub Apps | OAuth Apps | | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they needs to receive events from. | +| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they need to receive events from. | | GitHub Apps receive certain organization-level events with the organization member's permission. | OAuth Apps request the organization webhook scope to create an organization webhook for each organization they need to receive organization-level events from. | ### Git access 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 eac9f713c3a5..a72e7f2d98fa 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 @@ -67,7 +67,7 @@ If the user accepts your request, GitHub redirects back to your site with a temp {% endnote %} -Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." +Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." 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 %} 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 caf739366085..bccc484a16f3 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 @@ -7,13 +7,11 @@ versions: free-pro-team: '*' --- -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} -{% endif %} ### Suspending a GitHub App diff --git a/translations/ko-KR/content/developers/apps/using-content-attachments.md b/translations/ko-KR/content/developers/apps/using-content-attachments.md index bcd3a0572048..435e2653b6b8 100644 --- a/translations/ko-KR/content/developers/apps/using-content-attachments.md +++ b/translations/ko-KR/content/developers/apps/using-content-attachments.md @@ -166,7 +166,7 @@ To create a Probot App, follow these steps: } ``` -4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to [localhost:3000](http://localhost:3000), and click the **Register GitHub App** button: +4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to `http://localhost:3000`, and click the **Register GitHub App** button: ![Register a Probot GitHub App](/assets/images/github-apps/github_apps_probot-registration.png) diff --git a/translations/ko-KR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/ko-KR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index 9252c41ece19..342754e94dfb 100644 --- a/translations/ko-KR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/ko-KR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -4,6 +4,5 @@ intro: 'You can list free and paid tools for developers to use in {% data variab mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/ko-KR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/ko-KR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index aa9d924b4990..8e765778101b 100644 --- a/translations/ko-KR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/ko-KR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -48,7 +48,7 @@ Customers can start a free trial for any paid plan on a Marketplace listing that Free trials have a fixed length of 14 days. Customers are notified 4 days before the end of their trial period (on day 11 of the free trial) that their plan will be upgraded. At the end of a free trial, customers will be auto-enrolled into the plan they are trialing if they do not cancel. -For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)." +For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/handling-new-purchases-and-free-trials/)." {% note %} diff --git a/translations/ko-KR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/ko-KR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index 3c8a760f5854..0264e77e2ec2 100644 --- a/translations/ko-KR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/ko-KR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -13,8 +13,14 @@ versions: -After your {% data variables.product.prodname_marketplace %} listing is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the onboarding process. +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -Once your revenue reaches a minimum of $500 U.S. Dollars for the month, you'll receive an electronic payment from {% data variables.product.product_name %} for 75% of the sales price. +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/ko-KR/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/ko-KR/content/developers/github-marketplace/requirements-for-listing-an-app.md index 2ae24c334eef..aed7c5d235d1 100644 --- a/translations/ko-KR/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/ko-KR/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -53,7 +53,7 @@ In addition to the requirements for all apps above, each app that you offer as a - {% data variables.product.prodname_github_app %}s should have a minimum of 100 installations. - {% data variables.product.prodname_oauth_app %}s should have a minimum of 200 users. - All paid apps must handle {% data variables.product.prodname_marketplace %} purchase events for new purchases, upgrades, downgrades, cancellations, and free trials. For more information, see "[Billing requirements for paid apps](#billing-requirements-for-paid-apps)" below. -- Publishing organizations must have a verified domain and must enable two-factor authentication. 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.") +- Publishing organizations must have a verified domain and must enable two-factor authentication. 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)." When you are ready to publish the app on {% data variables.product.prodname_marketplace %} you must request verification for the listing. diff --git a/translations/ko-KR/content/developers/overview/index.md b/translations/ko-KR/content/developers/overview/index.md index df3d394a6ca9..dddfd05c5ce7 100644 --- a/translations/ko-KR/content/developers/overview/index.md +++ b/translations/ko-KR/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 e6ed78de8f0c..fc1af62d4102 100644 --- a/translations/ko-KR/content/developers/overview/managing-deploy-keys.md +++ b/translations/ko-KR/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ If you don't want to use SSH keys, you can use [HTTPS with OAuth tokens][git-aut * Users don't have to change their local SSH settings. * Multiple tokens (one for each user) are not needed; one token per server is enough. * A token can be revoked at any time, turning it essentially into a one-use password. +{% if enterpriseServerVersions contains currentVersion %} * Generating new tokens can be easily scripted using [the OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization). +{% endif %} ##### Cons diff --git a/translations/ko-KR/content/developers/overview/viewing-deployment-history.md b/translations/ko-KR/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..bd0b394f48d5 --- /dev/null +++ b/translations/ko-KR/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: Viewing deployment history +intro: View current and previous deployments for your repository. +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +You can deliver deployments through {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %} and environments or with {% endif %}the REST API and third party apps. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}For more information about {% data variables.product.prodname_actions %}, see "[{% data variables.product.prodname_actions %}](/actions)." {% endif %}For more information about deployments with the REST API, see "[Repositories](/rest/reference/repos#deployments)." + +To view current and past deployments, click **Environments** on the home page of your repository. ![Environments](/assets/images/environments-sidebar.png) + +The deployments page displays the last active deployment of each environment for your repository. If the deployment includes an environment URL, a "View deployment" button that links to the URL is shown next to the deployment. + +The activity log shows the deployment history for your environments. By default, only the most recent deployment for an environment has an `Active` status; all previously active deployments have an `Inactive` status. For more information on automatic inactivation of deployments, see "[Inactive deployments](/rest/reference/repos#inactive-deployments)." + +You can also use the REST API to get information about deployments. For more information, see "[Repositories](/rest/reference/repos#deployments)." 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 f07e12d2d7b2..d1de9d6936c2 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 @@ -91,7 +91,7 @@ The base reference branch of the pull request changed. |:------------------------- |:----------------:|:-------------------:| |
    • Pull requests
    | **X** | | - ### Event object properties +#### Event object properties {% data reusables.issue-events.issue-event-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 558685831253..600e65ad1cfe 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 @@ -71,7 +71,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) 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 83942fe2e356..ff10f4f2ceda 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 @@ -430,7 +430,7 @@ When someone revokes their authorization of a {% data variables.product.prodname {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} For more information, see "[Suspending a {% data variables.product.prodname_github_app %} installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." @@ -715,7 +715,7 @@ The webhook this event is configured on was deleted. This event will only listen ### 패키지 -Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/rest/reference/orgs#blocking)" REST API. For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. +Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. #### Availability @@ -1125,9 +1125,11 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory Activity related to a security advisory. A security advisory provides information about security-related vulnerabilities in software on GitHub. The security advisory dataset also powers the GitHub security alerts, see "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies/)." +{% endif %} #### Availability diff --git a/translations/ko-KR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/ko-KR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index 723b65c9b1d0..2cf06b586653 100644 --- a/translations/ko-KR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/ko-KR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -28,4 +28,4 @@ To create and access the feedback pull request, you must enable the feedback pul ### 더 읽을거리 -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/ko-KR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/ko-KR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index be796f414d55..5dd91189f5de 100644 --- a/translations/ko-KR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/ko-KR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -18,7 +18,7 @@ To be eligible for the {% data variables.product.prodname_student_pack %}, you m - Have a [{% data variables.product.prodname_dotcom %} user account](/articles/signing-up-for-a-new-github-account) - Be at least 13 years old -Documents that prove your current student status include a picture of your school ID, class schedule, transcript, and affiliation or enrollment verification letter. +Documents that prove your current student status include a picture of your school ID with current enrollment date, class schedule, transcript, and affiliation or enrollment verification letter. During your tenure as a student, you may be prompted to periodically re-verify your current academic status. diff --git a/translations/ko-KR/content/github/administering-a-repository/about-protected-branches.md b/translations/ko-KR/content/github/administering-a-repository/about-protected-branches.md index f5155972c0ad..13bde7762136 100644 --- a/translations/ko-KR/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/ko-KR/content/github/administering-a-repository/about-protected-branches.md @@ -11,12 +11,16 @@ versions: github-ae: '*' --- +### About protected branches + {% data reusables.pull_requests.about-protected-branches %} You can choose to enforce restrictions on how a pull request is merged into your repository. Repository owners and people with admin permissions for a repository can enforce certain workflows or requirements, before a collaborator can merge a branch in your repository by creating protected branch rules. {% data reusables.repositories.branch-rules-example %} For more information, see "[Configuring protected branches](/articles/configuring-protected-branches/)." +{% data reusables.pull_requests.you-can-auto-merge %} + ### Prioritization of protected branch rules If a repository has multiple protected branch rules that affect the same branches, the rules that include a specific branch name have the highest priority. If there is more than one protected branch rule that references the same specific branch name, then the branch rule created first will have higher priority. diff --git a/translations/ko-KR/content/github/administering-a-repository/configuring-pull-request-merges.md b/translations/ko-KR/content/github/administering-a-repository/configuring-pull-request-merges.md index 6a34fe2d0d6a..f42c9d2a9a30 100644 --- a/translations/ko-KR/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/ko-KR/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: Configuring pull request merges -intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history by enabling, disabling, or enforcing standard merge commits, squashed commits, or rebased commits on all pull requests in your repository.' +intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 e3831cad2104..34e848ad4e2c 100644 --- a/translations/ko-KR/content/github/administering-a-repository/index.md +++ b/translations/ko-KR/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/ko-KR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/ko-KR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..e19203c0666a --- /dev/null +++ b/translations/ko-KR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Managing auto-merge for pull requests in your repository +intro: "You can allow or disallow auto-merge for pull requests in your repository." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Under "Merge button", select or deselect **Allow auto-merge**. ![Checkbox to allow or disallow auto-merge](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file diff --git a/translations/ko-KR/content/github/administering-a-repository/setting-repository-visibility.md b/translations/ko-KR/content/github/administering-a-repository/setting-repository-visibility.md index e3422e7084f3..b6106c1a28f8 100644 --- a/translations/ko-KR/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/ko-KR/content/github/administering-a-repository/setting-repository-visibility.md @@ -24,7 +24,7 @@ We recommend reviewing the following caveats before you change the visibility of * 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. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}The visibility of any forks will also change to private.{% elsif currentVersion == "github-ae@latest" %}If the internal repository has any forks, the visibility of the forks is already private.{% 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)"{% 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 %}{% endif %} * Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -* {% 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 enterpriseServerVersions contains currentVersion %} +* {% data variables.product.prodname_dotcom %} will no longer include 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 enterpriseServerVersions contains currentVersion %} * 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 %} {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 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 c664a1be5e57..576af27fd1a6 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 @@ -38,7 +38,7 @@ When an {% data variables.product.prodname_oauth_app %} wants to identify you by *Scopes* are named groups of permissions that an {% data variables.product.prodname_oauth_app %} can request to access both public and non-public data. -When you want to use an {% data variables.product.prodname_oauth_app %} that integrates with {% data variables.product.product_name %}, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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)." +When you want to use an {% data variables.product.prodname_oauth_app %} that integrates with {% data variables.product.product_name %}, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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 %} 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 4cf6fcd978b0..2033e76639ee 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 @@ -32,7 +32,7 @@ Applications can have *read* or *write* access to your {% data variables.product *Scopes* are named groups of permissions that an application can request to access both public and non-public data. -When you want to use a third-party application that integrates with {% data variables.product.product_name %}, that application lets you know what type of access to your data will be required. If you grant access to the application, then the application will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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)." +When you want to use a third-party application that integrates with {% data variables.product.product_name %}, that application lets you know what type of access to your data will be required. If you grant access to the application, then the application will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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 %} diff --git a/translations/ko-KR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/ko-KR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index 3fac8ec0bb95..658c35c25e3d 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/ko-KR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -127,7 +127,7 @@ Before adding a new SSH key to the ssh-agent to manage your keys, you should hav 1. Ensure the ssh-agent is running. You can use the "Auto-launching the ssh-agent" instructions in "[Working with SSH key passphrases](/articles/working-with-ssh-key-passphrases)", or start it manually: ```shell # start the ssh-agent in the background - $ eval $(ssh-agent -s) + $ eval `ssh-agent -s` > Agent pid 59566 ``` diff --git a/translations/ko-KR/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/ko-KR/content/github/authenticating-to-github/testing-your-ssh-connection.md index 12b3e26732f7..14137184345d 100644 --- a/translations/ko-KR/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/ko-KR/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -31,7 +31,7 @@ When you test your connection, you'll need to authenticate this action using you > Are you sure you want to continue connecting (yes/no)? ``` -3. Verify that the fingerprint in the message you see matches one of the messages in step 2, then type `yes`: +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Hi username! You've successfully authenticated, but GitHub does not > provide shell access. diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..378da8df6d57 --- /dev/null +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: Automatically merging a pull request +intro: 'You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### About auto-merge + +If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks. + +Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)." + +You can provide feedback about auto-merge by [contacting us](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback). + +### Enabling auto-merge + +People with write permissions to a repository can enable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to auto-merge. +1. Optionally, to choose a merge method, select the **Enable auto-merge** drop-down menu, then click a merge method. For more information, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)." !["Enable auto-merge" drop-down menu](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. Click **Enable auto-merge**. ![Button to enable auto-merge](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. If you chose the merge or squash and merge methods, type a commit message and description and choose the email address you want to author the merge commit. ![Fields to enter commit message and description and choose commit author email](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. Click **Confirm auto-merge**. ![Button to confirm auto-merge](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### Disabling auto-merge + +People with write permissions to a repository and pull request authors can disable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to disable auto-merge for. +1. In the merge box, click **Disable auto-merge**. ![Button to disable auto-merge](/assets/images/help/pull_requests/disable-auto-merge-button.png) diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md index 06dfc6b389b2..e5871840672d 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md @@ -3,7 +3,7 @@ title: Creating a pull request from a fork intro: You can create a pull request to propose changes you've made to a fork of an upstream repository. redirect_from: - /articles/creating-a-pull-request-from-a-fork -permissions: Anyone with write access to a repository can create a pull request from user-owned fork. +permissions: Anyone with write access to a repository can create a pull request from a user-owned fork. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/index.md index ae4915c00270..1e666ca019af 100644 --- a/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/ko-KR/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 2f82905ec6b6..505a76c8cee6 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 @@ -14,6 +14,8 @@ versions: In a pull request, you propose that changes you've made on a head branch should be merged into a base branch. {% data reusables.pull_requests.about-protected-branches %} However, there may be restrictions on when you can merge a pull request into a specific branch. For example, you may only be able to merge a pull request into the default branch if required status checks are passing. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +{% data reusables.pull_requests.you-can-auto-merge %} + If the pull request has merge conflicts, or if you'd like to test the changes before merging, you can [check out the pull request locally](/articles/checking-out-pull-requests-locally) and merge it using the command line. You can't merge a draft pull request. For more information about draft pull requests, see "[About pull requests](/articles/about-pull-requests#draft-pull-requests)." 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 877edcc652b9..bf973e9662b4 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 @@ -294,7 +294,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Accessing private repositories -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)." +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 `ghost/foo`, `ghost/bar`, and `ghost/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. 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 index c7e1cf8ad260..d825538c9916 100644 --- 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 @@ -54,7 +54,7 @@ On Windows, the `codeql-runner-win.exe` file usually requires no change to permi 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 +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux chmod +x codeql-runner-linux ``` @@ -129,7 +129,7 @@ This example is similar to the previous example, however this time the repositor > ... > 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 " + Please export these variables to future processes so that CodeQL can monitor the build, for example by running " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` diff --git a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index 4cb5408b6384..66278fee4464 100644 --- a/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/ko-KR/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -11,7 +11,7 @@ To help you understand your subscriptions and decide whether to unsubscribe, see {% note %} -**Note:** Instead of unsubscribing, you have the option to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% 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 %} +**Note:** Instead of unsubscribing, you have the option to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% if currentVersion == "free-pro-team@latest" %}If you're experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 0d48d8a6a3e1..a74df499359c 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 @@ -33,7 +33,7 @@ You can also watch and unwatch releases in a repository. For more information, s {% note %} -**Note:** You can also choose to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% 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 %} +**Note:** You can also choose to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} diff --git a/translations/ko-KR/content/github/searching-for-information-on-github/searching-code.md b/translations/ko-KR/content/github/searching-for-information-on-github/searching-code.md index 62ea1db6cef8..856c4fdee6e9 100644 --- a/translations/ko-KR/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/ko-KR/content/github/searching-for-information-on-github/searching-code.md @@ -27,7 +27,8 @@ Due to the complexity of searching code, there are some restrictions on how sear - Only the _default branch_ is indexed for code search.{% if currentVersion == "free-pro-team@latest" %} - Only files smaller than 384 KB are searchable.{% else %}* Only files smaller than 5 MB are searchable. - Only the first 500 KB of each file is searchable.{% endif %} -- Only repositories with fewer than 500,000 files are searchable. +- Only repositories with fewer than 500,000 files are searchable.{% if currentVersion == "free-pro-team@latest" %} +- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} - Except with [`filename`](#search-by-filename) searches, you must always include at least one search term when searching source code. For example, searching for [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) is not valid, while [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) is. - At most, search results can show two fragments from the same file, but there may be more results within the file. - You can't use the following wildcard characters as part of your search query: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. The search will simply ignore these symbols. 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 642309de493d..49f490dad7ba 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 @@ -39,6 +39,7 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late | 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** | | | +| Restrict email notifications to verified domains (see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-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** | | 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 a4c4374335eb..70abab0725be 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 @@ -60,7 +60,8 @@ In addition to managing organization-level settings, organization owners have ad | [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} | Apply labels | | **X** | **X** | **X** | **X** | | Create, edit, delete labels | | | **X** | **X** | **X** | -| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | +| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Enable and disable auto-merge on a pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | 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** | diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index 1390c58840de..6e0924546a21 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -When restricted email notifications are enabled in an organization, members can only receive email notifications about organization activity at an email address associated with the organization's verified domain. For more information, see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)." +### About email restrictions + +When restricted email notifications are enabled in an organization, members can only use an email address associated with the organization's verified domains to receive email notifications about organization activity. For more information, see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)." Outside collaborators are not subject to restrictions on email notifications for verified domains. For more information on outside collaborators, see "[Permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)." +If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +### Restricting email notifications to an approved domain + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. Under "Enforcement preferences", select **Restrict email notifications to domain email**. ![Checkbox to restrict email notifications to verified domain emails](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. Click **Save**. diff --git a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index 9bef1adc2503..335556dcc858 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### About domain verification + To verify domains on {% data variables.product.product_name %}, you must have owner permissions in the organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." You will also need access to modify domain records with your domain hosting service. After verifying ownership of your organization's domains, a "Verified" badge will display on the organization's profile. If your organization is on {% data variables.product.prodname_ghe_cloud %} and has agreed to the Corporate Terms of Service, organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. For more information, see "[About your organization's profile page](/articles/about-your-organization-s-profile/)" and "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." -To display a "Verified" badge, the website and email information shown on your organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. - -{% note %} - -**Note:** If the email address and website shown on your organization's profile use variants of the same domain, you must verify both variants. For example, if your organization's profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. +If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." -{% endnote %} +{% data reusables.organizations.verified-domains-details %} On {% data variables.product.prodname_ghe_cloud %}, after verifying ownership of your organization's domain, you can restrict email notifications for the organization to that domain. For more information, see "[Restricting email notifications to an approved domain](/articles/restricting-email-notifications-to-an-approved-domain)." +### Verifying your organization's domain + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. Click **Add a domain**. ![Add a domain button](/assets/images/help/organizations/add-a-domain-button.png) -6. In the domain field, type the domain you'd like to verify, then click **Add domain**. ![Add a domain field](/assets/images/help/organizations/add-domain-field.png) -7. Follow the instructions under **Add a DNS TXT record** to create a DNS TXT record with your domain hosting service. It may take up to 72 hours for your DNS configuration to change. Once your DNS configuration has changed, continue to the next step. ![Instructions to create a DNS txt record](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **Tip:** You can confirm your DNS configuration has changed by running the `dig` command on the command line. In the example command, replace `ORGANIZATION` with the name of your organization, and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ORGANIZATION` with the name of your organization and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - 8. After confirming your TXT record is added to your DNS, navigate to the Verified domains tab in your organization's settings. You can follow steps one through four above to locate the Verified domains tab. ![Verified domains settings page with pending domain](/assets/images/help/organizations/pending-domain-verification.png) -9. Next to the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Continue verifying domain button](/assets/images/help/organizations/continue-verifying-domain.png) -10. Click **Verify domain**. ![Verify domain button](/assets/images/help/organizations/verify-domain-final-button.png) +{% data reusables.organizations.continue-verifying-domain %} 11. Optionally, once the "Verified" badge is visible on your organization's profile page, you can delete the TXT entry from the DNS record at your domain hosting service. ![Verified badge](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/index.md index 54e9cb224115..6d144e7ecc7d 100644 --- a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..e02bb0e7c057 --- /dev/null +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restricting email notifications for your enterprise account to approved domains +intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can restrict email notifications for an enterprise account. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About email restrictions for your enterprise account + +When you restrict email notifications to verified domains, enterprise members can only use an email address associated with a verified domain to receive email notifications about activity in organizations owned by your enterprise account. The domains can be inherited from the enterprise account or configured for the specific organization. For more information about email restrictions for organizations, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +If email restrictions are enabled for an enterprise account, organization owners cannot disable email restrictions for any organization owned by the enterprise account. If changes occur that result in an organization having no verified domains, either inherited from an enterprise account that owns the organization or for the specific organization, email restrictions will be disabled for the organization. + +### Restricting email notifications for your enterprise account + +Before you can restrict email notifications for your enterprise account, you must verify at least one domain for the enterprise account. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. Click **Save**. diff --git a/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..54f209077175 --- /dev/null +++ b/translations/ko-KR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verifying your enterprise account's domain +intro: 'You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can verify an enterprise account's domain. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About domain verification + +You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. For more information, see "[Verifying your organization's domain](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)." + +After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. {% data reusables.organizations.verified-domains-details %} + +Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. + +After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "[Restricting email notifications for your enterprise account to approved domains](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)." + +Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +### Verifying your enterprise account's domain + +To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. Click **Add a domain**. ![Add a domain button](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ENTERPRISE-ACCOUNT` with the name of your enterprise account, and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. ![Verified badge](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 661c7281e1e2..9a65b427d8ff 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 @@ -46,7 +46,8 @@ The repository owner has full control of the repository. In addition to the acti | Define code owners for the repository | "[About code owners](/github/creating-cloning-and-archiving-repositories/about-code-owners)" | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Create security advisories | "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| 동작 | More information | -|:----------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Fork the repository | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | "[Creating and editing milestones for issues and pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | "[Creating a pull request from a fork](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | -| Submit a review on a pull request that affects the mergeability of the pull request | "[Reviewing proposed changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | -| Create and edit a wiki for the repository | "[About wikis](/github/building-a-strong-community/about-wikis)" | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| 동작 | More information | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Fork the repository | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | "[Creating and editing milestones for issues and pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | "[Creating a pull request from a fork](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | +| Submit a review on a pull request that affects the mergeability of the pull request | "[Reviewing proposed changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | +| Create and edit a wiki for the repository | "[About wikis](/github/building-a-strong-community/about-wikis)" | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| Remove themselves as collaborators on the repository | "[Removing yourself from a collaborator's repository](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | +| Remove themselves as collaborators on the repository | "[Removing yourself from a collaborator's repository](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | ### 더 읽을거리 diff --git a/translations/ko-KR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/ko-KR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index 52a69a7135ca..70d4eb12aa38 100644 --- a/translations/ko-KR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/ko-KR/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} analyzes your {% data var product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. diff --git a/translations/ko-KR/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/ko-KR/content/github/site-policy/github-marketplace-developer-agreement.md index 78c0ff86a6e8..6fc85ce49d2b 100644 --- a/translations/ko-KR/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/ko-KR/content/github/site-policy/github-marketplace-developer-agreement.md @@ -8,7 +8,7 @@ versions: **THESE TERMS AND CONDITIONS (THE "AGREEMENT") GOVERN YOUR PARTICIPATION IN GITHUB’S MARKETPLACE PROGRAM. BY ENROLLING TO PARTICIPATE IN THE MARKETPLACE PROGRAM OR BY CLICKING “I ACCEPT” BELOW, YOU ARE CONFIRMING THAT YOU UNDERSTAND THIS AGREEMENT, AND THAT YOU ACCEPT ALL OF ITS TERMS AND CONDITIONS. IF YOU ARE ENTERING INTO THIS AGREEMENT ON BEHALF OF A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THE ENTITY TO THIS AGREEMENT, IN WHICH CASE “YOU” WILL MEAN THE ENTITY YOU REPRESENT.** -Effective Date: July 21, 2020 +Effective Date: January 1, 2021 ### 1. DEFINITIONS @@ -143,7 +143,7 @@ In the event that your Listing is involuntarily removed because it is defective, **6.1** GitHub will be the merchant of record for Developer Products purchased by End Users via Marketplace. -**6.2** Prices for Marketplace Listings of Developer Applications will be set in US Dollars (USD). Developer has complete control over setting pricing for each Listing, and once set, such pricing cannot be changed. You may retire a pricing plan for an existing Listing and add a new pricing plan for such Listing, provided that such new pricing plan shall not negatively impact existing End Users. The prices you set for Developer Products will determine the amount of payment you will receive. GitHub will remit 75% of the sale price in USD without reduction for Taxes except for any withholding taxes that are required under applicable law. The remaining 25% of the sales price will be allotted to and retained by GitHub. At the end of each month and upon reaching a minimum value of $500 USD, GitHub will remit your share of payments. +**6.2** Prices for Marketplace Listings of Developer Applications will be set in US Dollars (USD). Developer has complete control over setting pricing for each Listing, and once set, such pricing cannot be changed. You may retire a pricing plan for an existing Listing and add a new pricing plan for such Listing, provided that such new pricing plan shall not negatively impact existing End Users. The prices you set for Developer Products will determine the amount of payment you will receive. GitHub will remit 95% of the sale price in USD without reduction for Taxes except for any withholding taxes that are required under applicable law. The remaining 5% of the sales price will be allotted to and retained by GitHub. At the end of each month and upon reaching a minimum value of $500 USD, GitHub will remit your share of payments. **6.3** Refund Requirements. You will be responsible for specifying the terms and conditions regarding refunds to your End Users. In no event shall GitHub be responsible for providing any support for refunds, nor shall GitHub be liable for payment of any refund. @@ -169,7 +169,7 @@ UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY (WHETHER IN CONTRACT, TORT, NEG **10.3** GitHub may terminate this Agreement at any time if (a) you have breached any provision of this Agreement or (b) GitHub is required to do so by law. -**10.4** Effects of Termination by Developer. Upon receiving forty-five (45) days’ advanced written notice of termination from Developer, Developer will be disabled from taking on new customers via Marketplace. Any outstanding fees shall be remitted upon termination and removal of the Developer Product from Marketplace. If termination is initiated as a result of a GitHub modication to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. +**10.4** Effects of Termination by Developer. Upon receiving forty-five (45) days’ advanced written notice of termination from Developer, Developer will be disabled from taking on new customers via Marketplace. Any outstanding fees shall be remitted upon termination and removal of the Developer Product from Marketplace. If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** The obligations in Sections 2, 3, 4, 5, 8, 9 and 12-18 will survive any expiration or termination of this Agreement. 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 fdb3688b7232..9586c9a460c7 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: November 16, 2020 +Effective date: December 19, 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. @@ -26,24 +26,24 @@ Of course, the short version and the Summary below don't tell you everything, so ### Summary -| Section | What can you find there? | -| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [What information GitHub collects](#what-information-github-collects) | GitHub collects information directly from you for your registration, payment, transactions, and user profile. We also automatically collect from you your usage information, cookies and similar technologies, and device information, subject, where necessary, to your consent. GitHub may also collect User Personal Information from third parties. We only collect the minimum amount of personal information necessary from you, unless you choose to provide more. | -| [What information GitHub does _not_ collect](#what-information-github-does-not-collect) | We don’t knowingly collect information from children under 13, and we don’t collect [Sensitive Personal Information](https://gdpr-info.eu/art-9-gdpr/). | -| [How GitHub uses your information](#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. We also describe the legal basis upon which we process your information, where legally required. | -| [How we share the information we collect](#how-we-share-the-information-we-collect) | We may share your information with third parties under one of the following circumstances: with your consent, with our service providers, for security purposes, to comply with our legal obligations, or when there is a change of control or sale of corporate entities or business units. We do not sell your personal information and we do not host advertising on GitHub. You can see a list of the service providers that access your information. | -| [Other important information](#other-important-information) | We provide additional information specific to repository contents, public information, and Organizations on GitHub. | -| [Additional services](#additional-services) | We provide information about additional service offerings, including third-party applications, GitHub Pages, and GitHub applications. | -| [How you can access and control the information we collect](#how-you-can-access-and-control-the-information-we-collect) | We provide ways for you to access, alter, or delete your personal information. | -| [Our use of cookies and tracking](#our-use-of-cookies-and-tracking) | We use cookies for the overall functionality of our Website, and we use a small number of tracking and analytics services on a few parts of our site. We offer a page that makes this very transparent. Please see this section for more information. | -| [How GitHub secures your information](#how-github-secures-your-information) | We take all measures reasonably necessary to protect the confidentiality, integrity, and availability of your personal information on GitHub and to protect the resilience of our servers. | -| [GitHub's global privacy practices](#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](#how-we-communicate-with-you) | We communicate with you by email. You can control the way we contact you in your account settings, or by contacting us. | -| [Resolving complaints](#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](#changes-to-our-privacy-statement) | We notify you of material changes to this Privacy Statement 30 days before any such changes become effective. You may also track changes in our Site Policy repository. | -| [라이선스](#license) | This Privacy Statement is licensed under the [Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/). | -| [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. | +| Section | What can you find there? | +| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [What information GitHub collects](#what-information-github-collects) | GitHub collects information directly from you for your registration, payment, transactions, and user profile. We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. GitHub may also collect User Personal Information from third parties. We only collect the minimum amount of personal information necessary from you, unless you choose to provide more. | +| [What information GitHub does _not_ collect](#what-information-github-does-not-collect) | We don’t knowingly collect information from children under 13, and we don’t collect [Sensitive Personal Information](https://gdpr-info.eu/art-9-gdpr/). | +| [How GitHub uses your information](#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. We also describe the legal basis upon which we process your information, where legally required. | +| [How we share the information we collect](#how-we-share-the-information-we-collect) | We may share your information with third parties under one of the following circumstances: with your consent, with our service providers, for security purposes, to comply with our legal obligations, or when there is a change of control or sale of corporate entities or business units. We do not sell your personal information and we do not host advertising on GitHub. You can see a list of the service providers that access your information. | +| [Other important information](#other-important-information) | We provide additional information specific to repository contents, public information, and Organizations on GitHub. | +| [Additional services](#additional-services) | We provide information about additional service offerings, including third-party applications, GitHub Pages, and GitHub applications. | +| [How you can access and control the information we collect](#how-you-can-access-and-control-the-information-we-collect) | We provide ways for you to access, alter, or delete your personal information. | +| [Our use of cookies and tracking](#our-use-of-cookies-and-tracking) | We only use strictly necessary cookies to provide, secure and improve our service. We offer a page that makes this very transparent. Please see this section for more information. | +| [How GitHub secures your information](#how-github-secures-your-information) | We take all measures reasonably necessary to protect the confidentiality, integrity, and availability of your personal information on GitHub and to protect the resilience of our servers. | +| [GitHub's global privacy practices](#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](#how-we-communicate-with-you) | We communicate with you by email. You can control the way we contact you in your account settings, or by contacting us. | +| [Resolving complaints](#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](#changes-to-our-privacy-statement) | We notify you of material changes to this Privacy Statement 30 days before any such changes become effective. You may also track changes in our Site Policy repository. | +| [라이선스](#license) | This Privacy Statement is licensed under the [Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/). | +| [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 개인 정보 보호 명세서 @@ -74,8 +74,8 @@ If you have a paid Account with us, sell an application listed on [GitHub Market ##### Usage information If you're accessing our Service or Website, we automatically collect the same basic information that most services collect, subject, where necessary, to your consent. This includes information about how you use the Service, such as the pages you view, the referring site, your IP address and session information, and the date and time of each request. This is information we collect from every visitor to the Website, whether they have an Account or not. This information may include User Personal information. -##### Cookies and similar technologies information -As further described below, and subject, where applicable, to your consent, we automatically collect information from cookies and similar technologies (such as cookie ID and settings) to keep you logged in, to remember your preferences, and to identify you and your device. +##### Cookies +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### Device information We may collect certain information about your device, such as its IP address, browser or client application information, language preference, operating system and application version, device type and ID, and device model and manufacturer. This information may include User Personal information. @@ -235,15 +235,17 @@ That said, the email address you have supplied [via your Git commit settings](/g #### Cookies -GitHub uses cookies and similar technologies (e.g., HTML5 localStorage) 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 (hereafter collectively "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. +GitHub only uses strictly necessary cookies. Cookies are small text files that websites often store on computer hard drives or mobile devices of visitors. -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. +We use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### Tracking and analytics +By using our service, 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 our service. -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. +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. -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. +#### DNT + +"[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://privacybadger.org/). ### 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 90e76e0821d0..682a7ad013ca 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,9 +10,9 @@ versions: free-pro-team: '*' --- -Effective date: **October 2, 2020** +Effective date: **December 30, 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). +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), and how we use [cookies](#cookies-on-github). ### GitHub Subprocessors @@ -29,14 +29,13 @@ When we share your information with third party subprocessors, such as our vendo | Eloqua | Marketing campaign automation | United States | United States | | Google Apps | Internal company infrastructure | United States | United States | | Google Analytics | Analytics and performance | United States | United States | -| LinkedIn Navigator | Marketing data enrichment service | United States | United States | +| LinkedIn Navigator | 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 | | Mailgun | Transactional mail services provider | United States | United States | | Microsoft | Microsoft Services | United States | United States | | Monday.com | Team collaboration and project management platform | United States | Israel | | Nexmo | SMS notification provider | United States | United States | -| Oracle | Corporate financial system | United States | United States | | Salesforce.com | Customer relations management | United States | United States | | Sendgrid | Transactional mail services provider | United States | United States | | Sentry.io | Application monitoring provider | United States | United States | @@ -49,49 +48,35 @@ When we bring on a new subprocessor who handles our Users' Personal Information, ### Cookies on GitHub -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. +GitHub uses 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 | +| 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 | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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 for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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 us to customize timestamps to your time zone. | 세션 | +| GitHub | `user_session` | This cookie is used to log you in. | two weeks | _*_ 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 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. +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, 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. diff --git a/translations/ko-KR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/ko-KR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index 57ba08fe00a8..8f50e7c5d406 100644 --- a/translations/ko-KR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/ko-KR/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -163,8 +163,6 @@ c/o Corporation Service Company Sacramento, CA 95833-3505 ``` -You may also send a courtesy copy to legal@support.github.com. - Please make your requests as specific and narrow as possible, including the following information: - Full information about authority issuing the request for information 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 6cc777d54ac0..632cc5e5173e 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 @@ -39,12 +39,6 @@ If vulnerabilities have been detected in the repository, these are shown at the 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_alerts %}. -{% note %} - -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. - -{% endnote %} - ![의존성 그래프](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ Any direct and indirect dependencies that are specified in the repository's mani {% if enterpriseServerVersions contains currentVersion 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. - -{% endnote %} - ![의존성 그래프](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,6 +81,24 @@ You can also enable or disable the dependency graph for all repositories owned b 4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} ### Troubleshooting the dependency graph 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 8ff575aad3ab..1a0eab500d92 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,8 +40,9 @@ 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` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% 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 @@ -72,6 +73,8 @@ To set up an apex domain, such as `example.com`, you must configure a _CNAME_ fi 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _EXAMPLE.COM_ with your apex domain. Confirm that the results match the IP addresses for {% data variables.product.prodname_pages %} above. ```shell diff --git a/translations/ko-KR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/ko-KR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index cf13090436ee..132048eabb99 100644 --- a/translations/ko-KR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/ko-KR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -39,11 +39,7 @@ Make sure your site does not: - Use more than one `www` subdomain. For example, both `www.example.com` and `www.anotherexample.com`. - Use both an apex domain and custom subdomain. For example, both `example.com` and `docs.example.com`. -{% warning %} - -**Warning:** We strongly recommend not using wildcard DNS records, such as `*.example.com`. A wildcard DNS record will allow anyone to host a {% data variables.product.prodname_pages %} site at one of your subdomains. - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} For a list of supported custom domains, see "[About custom domains and {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages/#supported-custom-domains)." diff --git a/translations/ko-KR/content/graphql/overview/resource-limitations.md b/translations/ko-KR/content/graphql/overview/resource-limitations.md index d0714a5d93c8..e7e574bb2f5f 100644 --- a/translations/ko-KR/content/graphql/overview/resource-limitations.md +++ b/translations/ko-KR/content/graphql/overview/resource-limitations.md @@ -117,7 +117,7 @@ These two examples show how to calculate the total nodes in a call. = 22,060 total nodes -### Rate limit +## Rate limit The GraphQL API v4 limit is different from the REST API v3's [rate limits](/rest/overview/resources-in-the-rest-api#rate-limiting). @@ -130,12 +130,6 @@ To accurately represent the server cost of a query, the GraphQL API v4 calculate The GraphQL API v4 rate limit is **5,000 points per hour**. -{% if currentVersion == "free-pro-team@latest" %} - -For {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s that belong to a {% data variables.product.prodname_ghe_cloud %} account, requests to resources owned by the same {% data variables.product.prodname_ghe_cloud %} account have an increased limit of 15,000 points per hour. - -{% endif %} - Note that 5,000 points per hour is not the same as 5,000 calls per hour: the GraphQL API v4 and REST API v3 use different rate limits. {% note %} diff --git a/translations/ko-KR/content/graphql/reference/enums.md b/translations/ko-KR/content/graphql/reference/enums.md index f87cc2e4ccd3..50ff25548cab 100644 --- a/translations/ko-KR/content/graphql/reference/enums.md +++ b/translations/ko-KR/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: Enums redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/input-objects.md b/translations/ko-KR/content/graphql/reference/input-objects.md index 423c6511c8b7..ad927ff2bbd6 100644 --- a/translations/ko-KR/content/graphql/reference/input-objects.md +++ b/translations/ko-KR/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: Input objects redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/interfaces.md b/translations/ko-KR/content/graphql/reference/interfaces.md index bfc411d7967c..492e7b535c62 100644 --- a/translations/ko-KR/content/graphql/reference/interfaces.md +++ b/translations/ko-KR/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: Interfaces redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/mutations.md b/translations/ko-KR/content/graphql/reference/mutations.md index e42955c3d30c..387dcd51ac14 100644 --- a/translations/ko-KR/content/graphql/reference/mutations.md +++ b/translations/ko-KR/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: Mutations redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/objects.md b/translations/ko-KR/content/graphql/reference/objects.md index 345786d5e1fc..7872b01baa65 100644 --- a/translations/ko-KR/content/graphql/reference/objects.md +++ b/translations/ko-KR/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: Objects redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/queries.md b/translations/ko-KR/content/graphql/reference/queries.md index e9d3c92baf6b..7df254873bbd 100644 --- a/translations/ko-KR/content/graphql/reference/queries.md +++ b/translations/ko-KR/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: Queries miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/scalars.md b/translations/ko-KR/content/graphql/reference/scalars.md index 338b4f42c7ee..2863a61f0de0 100644 --- a/translations/ko-KR/content/graphql/reference/scalars.md +++ b/translations/ko-KR/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: Scalars redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/graphql/reference/unions.md b/translations/ko-KR/content/graphql/reference/unions.md index 5a87c63fc0a6..2c9b6a786244 100644 --- a/translations/ko-KR/content/graphql/reference/unions.md +++ b/translations/ko-KR/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: Unions redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index 229475a6836c..2bb04dff75d2 100644 --- a/translations/ko-KR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/ko-KR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ You can choose which contributors are included in metrics and create teams of co ### 더 읽을거리 - "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" \ No newline at end of file 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 d0c8f74fee6e..811f412aace7 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 @@ -99,4 +99,4 @@ To configure {% data variables.product.prodname_insights %} to connect to {% dat ### 더 읽을거리 - "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" diff --git a/translations/ko-KR/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/ko-KR/content/packages/guides/configuring-npm-for-use-with-github-packages.md index a7b7163cfee6..fc4e09b87750 100644 --- a/translations/ko-KR/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/ko-KR/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: {% data reusables.package_registry.admins-can-configure-package-types %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Limits for published npm versions + +If you publish over 1,000 npm package versions to {% data variables.product.prodname_registry %}, you may see performance issues and timeouts occur during usage. + +To reduce the number of versions you have published for your npm package, consider deleting package versions. For more information, see "[Deleting a package](/packages/manage-packages/deleting-a-package)." + +In the future, {% data variables.product.company_short %} will enforce a hard limit on publishing more than 1,000 versions of an npm package. When we start enforcing the 1,000 versions limit for each npm package hosted on {% data variables.product.prodname_registry %}, we will offer more guidance on how to manage your package versions. + +{% endif %} + ### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/ko-KR/content/packages/guides/deleting-a-container-image.md b/translations/ko-KR/content/packages/guides/deleting-a-container-image.md index 33451deeaa34..e3e6c5254f83 100644 --- a/translations/ko-KR/content/packages/guides/deleting-a-container-image.md +++ b/translations/ko-KR/content/packages/guides/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 %}.' +intro: 'You can delete a specific version or all versions of a private or public container image on {% data variables.product.prodname_dotcom %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ When deleting public packages, be aware that you may break projects that depend ### Deleting a version of a user-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "[Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-a-user-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-user-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### Deleting a version of an organization-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "[Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-an-organization-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-org-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-user-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-org-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/ko-KR/content/packages/index.md b/translations/ko-KR/content/packages/index.md index c40765a9dc5d..1defcebba01f 100644 --- a/translations/ko-KR/content/packages/index.md +++ b/translations/ko-KR/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: + - + title: ghcr.io container names redirect to the container page + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: Filter for tagged and untagged containers + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ - title: Packages container support is an opt-in beta date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: Organization admins access to containers - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: Packages now respects IP allow list settings - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/ko-KR/content/rest/overview/libraries.md b/translations/ko-KR/content/rest/overview/libraries.md index c44db06aa8ed..6f14bb96cf5d 100644 --- a/translations/ko-KR/content/rest/overview/libraries.md +++ b/translations/ko-KR/content/rest/overview/libraries.md @@ -7,6 +7,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
    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 76a15da76320..9067d671ac01 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 @@ -41,8 +41,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -214,7 +215,7 @@ All error objects have resource and field properties so that your client can tel | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `missing` | A resource does not exist. | | `missing_field` | A required field on a resource has not been set. | -| `invalid` | The formatting of a field is invalid. Review the documentation for the for more specific information. | +| `invalid` | The formatting of a field is invalid. Review the documentation for more specific information. | | `already_exists` | Another resource has the same value as this field. This can happen in resources that must have some unique key (such as label names). | | `unprocessable` | The inputs provided were invalid. | @@ -235,14 +236,14 @@ Other redirection status codes may be used in accordance with the HTTP 1.1 spec. Where possible, API v3 strives to use appropriate HTTP verbs for each action. -| Verb | 설명 | -| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `HEAD` | Can be issued against any resource to get just the HTTP header info. | -| `GET` | Used for retrieving resources. | -| `POST` | Used for creating resources. | -| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A PATCH request may accept one or more of the attributes to update the resource. PATCH is a relatively new and uncommon HTTP verb, so resource endpoints also accept `POST` requests. | -| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | -| `DELETE` | Used for deleting resources. | +| Verb | 설명 | +| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `HEAD` | Can be issued against any resource to get just the HTTP header info. | +| `GET` | Used for retrieving resources. | +| `POST` | Used for creating resources. | +| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A `PATCH` request may accept one or more of the attributes to update the resource. | +| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | +| `DELETE` | Used for deleting resources. | ### Hypermedia diff --git a/translations/ko-KR/content/rest/reference/enterprise-admin.md b/translations/ko-KR/content/rest/reference/enterprise-admin.md index 8db2a549e6b1..bfd7b4d00b47 100644 --- a/translations/ko-KR/content/rest/reference/enterprise-admin.md +++ b/translations/ko-KR/content/rest/reference/enterprise-admin.md @@ -40,7 +40,7 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### Authentication -Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** (which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} OAuth tokens must have the `site_admin` [OAuth scope](/developers/apps/scopes-for-oauth-apps#available-scopes) when used with Enterprise-specific endpoints.{% endif %} +Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** {% if enterpriseServerVersions contains currentVersion %}(which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) {% endif %}or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} 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 administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% if enterpriseServerVersions contains currentVersion %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% endif %}. 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 3ce558cad2a6..fbe9b763a6a9 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 @@ -135,12 +135,12 @@ _검색_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _Assignees_ _이벤트_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _Labels_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) diff --git a/translations/ko-KR/data/release-notes/2-20/23.yml b/translations/ko-KR/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..bde9f73982f7 --- /dev/null +++ b/translations/ko-KR/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ko-KR/data/release-notes/2-21/14.yml b/translations/ko-KR/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..97d5bac00ab3 --- /dev/null +++ b/translations/ko-KR/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ko-KR/data/release-notes/2-22/6.yml b/translations/ko-KR/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..971924052fb5 --- /dev/null +++ b/translations/ko-KR/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/ko-KR/data/reusables/actions/environments-beta.md b/translations/ko-KR/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ko-KR/data/reusables/actions/forked-secrets.md b/translations/ko-KR/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..600bc85a9587 --- /dev/null +++ b/translations/ko-KR/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +With the exception of `GITHUB_TOKEN`, secrets are not passed to the runner when a workflow is triggered from a forked repository. 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 b36b0b6cb7da..a217ad81ee02 100644 --- a/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ko-KR/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn` (v1 only) (specify `npm`) +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`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 %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. diff --git a/translations/ko-KR/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/ko-KR/data/reusables/developer-site/pull_request_forked_repos_link.md index fe27ee792430..144420eb2f7e 100644 --- a/translations/ko-KR/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/ko-KR/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -10,4 +10,4 @@ When you create a pull request from a forked repository to the base repository, Workflows don't run on forked repositories by default. You must enable GitHub Actions in the **Actions** tab of the forked repository. -The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. 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/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/ko-KR/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/ko-KR/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/ko-KR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/ko-KR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/gated-features/actions-shared.md b/translations/ko-KR/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..57b1ab7a7d9f --- /dev/null +++ b/translations/ko-KR/data/reusables/gated-features/actions-shared.md @@ -0,0 +1 @@ +{% data variables.product.prodname_actions %} 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 %}, and {% 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. diff --git a/translations/ko-KR/data/reusables/gated-features/actions.md b/translations/ko-KR/data/reusables/gated-features/actions.md index 5d2317297b3b..bafbe8fae92d 100644 --- a/translations/ko-KR/data/reusables/gated-features/actions.md +++ b/translations/ko-KR/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{% data variables.product.prodname_actions %} 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 %}, and {% 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ko-KR/data/reusables/gated-features/auto-merge.md b/translations/ko-KR/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/ko-KR/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/gated-features/environments.md b/translations/ko-KR/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/ko-KR/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ko-KR/data/reusables/github-actions/permissions-statement-environment.md b/translations/ko-KR/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/ko-KR/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/ko-KR/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/ko-KR/data/reusables/github-actions/sidebar-environment.md b/translations/ko-KR/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/ko-KR/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. diff --git a/translations/ko-KR/data/reusables/notifications/outbound_email_tip.md b/translations/ko-KR/data/reusables/notifications/outbound_email_tip.md index 1cd91b0775f1..ccc963059312 100644 --- a/translations/ko-KR/data/reusables/notifications/outbound_email_tip.md +++ b/translations/ko-KR/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. For more information, contact your site administrator. {% endnote %} - {% endif %} diff --git a/translations/ko-KR/data/reusables/organizations/add-dns-txt-record.md b/translations/ko-KR/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..d079bac20fe0 --- /dev/null +++ b/translations/ko-KR/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. Follow the instructions under **Add a DNS TXT record** to create a DNS TXT record with your domain hosting service. ![Instructions to create a DNS txt record](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/organizations/add-domain.md b/translations/ko-KR/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..0d28d2b11f74 --- /dev/null +++ b/translations/ko-KR/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. In the domain field, type the domain you'd like to verify, then click **Add domain**. ![Add a domain field](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/organizations/continue-verifying-domain.md b/translations/ko-KR/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..0f9978775267 --- /dev/null +++ b/translations/ko-KR/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Continue verifying domain button](/assets/images/help/organizations/continue-verifying-domain.png) +10. Click **Verify domain**. ![Verify domain button](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/organizations/restrict-email-notifications.md b/translations/ko-KR/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..a662e4a74bd7 --- /dev/null +++ b/translations/ko-KR/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. Under "Enforcement preferences", select **Restrict email notifications to domain email**. ![Checkbox to restrict email notifications to verified domain emails](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/organizations/verified-domains-details.md b/translations/ko-KR/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..da065f8dd0b7 --- /dev/null +++ b/translations/ko-KR/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/pages/wildcard-dns-warning.md b/translations/ko-KR/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..468c509c00a5 --- /dev/null +++ b/translations/ko-KR/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**Warning:** We strongly recommend not using wildcard DNS records, such as `*.example.com`. A wildcard DNS record will allow anyone to host a {% data variables.product.prodname_pages %} site at one of your subdomains. + +{% endwarning %} 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 e02fdea38195..2bab45542fcc 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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 %} +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)." diff --git a/translations/ko-KR/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/ko-KR/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/ko-KR/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ko-KR/data/reusables/pull_requests/you-can-auto-merge.md b/translations/ko-KR/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..410aec2a8ee8 --- /dev/null +++ b/translations/ko-KR/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." +{% endif %} \ No newline at end of file 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 494debeaace2..14ba855124c8 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 @@ -176,7 +176,7 @@ git tag -a -m "Versão da minha primeira ação" v1 git push --follow-tags ``` -Checking in your `node_modules` directory can cause problems. As an alternative, you can use a tool called [`@vercel/ncc`](https://github.com/vercel/ncc) to compile your code and modules into one file used for distribution. +Verificar seu diretório `node_modules` pode causar problemas. Como alternativa, você pode usar uma ferramenta denominada [`@vercel/ncc`](https://github.com/vercel/ncc) para compilar o seu código e módulos em um arquivo usado para distribuição. 1. Instale o `vercel/ncc` executando este comando no seu terminal. `npm i -g @vercel/ncc` 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 c0c90c4d3405..e35c2198e1b4 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 @@ -117,6 +117,7 @@ runs: {% endraw %} #### `outputs..value` + **Obrigatório** O valor com o qual o parâmetro de saída será mapeado. Você pode defini-lo como uma `string` ou uma expressão com contexto. Por exemplo, você pode usar o contexto das `etapas` para definir o `valor` de uma saída como o valor de saída de uma etapa. Para obter mais informações sobre como usar a sintaxe de contexto e expressão, consulte "[Sintaxe de contexto e expressão para {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". @@ -204,9 +205,11 @@ Por exemplo, este `cleanup.js` só será executado em executores baseados no Lin **Obrigatório** As etapas de execução que você planeja executar nesta ação. -##### `runs.steps.run` +##### `runs.steps[*].run` **Obrigatório** O comando que você deseja executar. Isso pode ser inline ou um script no seu repositório de ação: + +{% raw %} ```yaml runs: using: "composite" @@ -214,6 +217,7 @@ runs: - run: ${{ github.action_path }}/test/script.sh shell: bash ``` +{% endraw %} Como alternativa, você pode usar `$GITHUB_ACTION_PATH`: @@ -227,23 +231,23 @@ runs: Para obter mais informações, consulte "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -##### `runs.steps.shell` +##### `runs.steps[*].shell` **Obrigatório** O shell onde você quer executar o comando. Você pode usar qualquer um dos shells listados [aqui](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). -##### `runs.steps.name` +##### `runs.steps[*].name` **Opcional** O nome da etapa de execução composta. -##### `runs.steps.id` +##### `runs.steps[*].id` **Opcional** Um identificador único para a etapa. Você pode usar `id` para fazer referência à etapa em contextos. 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)". -##### `runs.steps.env` +##### `runs.steps[*].env` **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` +##### `runs.steps[*].working-directory` **Opcional** Especifica o diretório de trabalho onde o comando é executado. diff --git a/translations/pt-BR/content/actions/guides/about-continuous-integration.md b/translations/pt-BR/content/actions/guides/about-continuous-integration.md index 324fe19c9563..83014b908f12 100644 --- a/translations/pt-BR/content/actions/guides/about-continuous-integration.md +++ b/translations/pt-BR/content/actions/guides/about-continuous-integration.md @@ -25,7 +25,7 @@ Para compilar e testar seu código, é necessário usar um servidor. Você pode ### 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)." +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. 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 index 868fb76eff47..16f59d7ca99c 100644 --- a/translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/pt-BR/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% 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)". +Para efetuar a autenticação com seu registro privado, você precisará armazenar seu token de autenticação npm como um segredo. Por exemplo, crie um repositório secreto 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. +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 `NODE_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). diff --git a/translations/pt-BR/content/actions/guides/building-and-testing-powershell.md b/translations/pt-BR/content/actions/guides/building-and-testing-powershell.md index 298386cec825..f6d007864b9b 100644 --- a/translations/pt-BR/content/actions/guides/building-and-testing-powershell.md +++ b/translations/pt-BR/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ A função `always()` configura o trabalho para continuar processando mesmo se h ### Publicar na Galeria do PowerShell -Você pode configurar o seu fluxo de trabalho para publicar o seu módulo do PowerShell para a Galeria PowerShell quando o seu teste de passar. Você pode usar segredos do repositório para armazenar quaisquer tokens ou credenciais necessárias para publicar seu pacote. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". +Você pode configurar o seu fluxo de trabalho para publicar o seu módulo do PowerShell para a Galeria PowerShell quando o seu teste de passar. Você pode usar segredos para armazenar quaisquer tokens ou credenciais necessárias para publicar seu pacote. Para obter mais informações, consulte "[Criando e usando segredos encriptados](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)". O exemplo a seguir cria um pacote e usa `Publish-Module` para publicá-lo na Galeria do PowerShell: 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 index 4ae797f17740..737e265f7f7d 100644 --- a/translations/pt-BR/content/actions/guides/building-and-testing-python.md +++ b/translations/pt-BR/content/actions/guides/building-and-testing-python.md @@ -391,7 +391,7 @@ jobs: 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)". +Você pode armazenar qualquer token de acesso ou credenciais necessárias para publicar seu pacote usando segredos. 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 diff --git a/translations/pt-BR/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/pt-BR/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..e2272a0061dd --- /dev/null +++ b/translations/pt-BR/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: Implantar no Amazon Elastic Container Service +intro: Você pode fazer implantação no Amazon Elastic Container Service (ECS) como parte de fluxos de trabalho para implantação contínua (CD). +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 %} + +### Introdução + +Este guia explica como usar {% data variables.product.prodname_actions %} para construir um aplicativo containerizado, fazer push no [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/) e fazer a implantação no [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/). + +Em cada nova versão no seu repositório de {% data variables.product.company_short %}, os fluxos de trabalho de {% data variables.product.prodname_actions %} criam e fazem push de uma nova imagem de contêiner para o Amazon ECR e, em seguida, implementa uma nova definição de tarefa para o Amazon ECS. + +### Pré-requisitos + +Antes de criar seu fluxo de trabalho de {% data variables.product.prodname_actions %}, primeiro você precisa concluir as etapas a seguir para o Amazon ECR e ECS: + +1. Crie um repositório Amazon ECR para armazenar suas imagens. + + Usando, por exemplo, [CLI AWS](https://aws.amazon.com/cli/): + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Certifique-se de usar o mesmo nome de repositório do Amazon ECR (representado aqui por `MY_ECR_REPOSITORY`) para a variável `ECR_REPOSITORY` no fluxo de trabalho abaixo. + + Certifique-se de usar o mesmo valor de região do AWS para a variável `AWS_REGION` (representada aqui pela variável `MY_AWS_REGION`) no fluxo de trabalho abaixo. + +2. Crie uma definição de tarefa e serviço do Amazon ECS. + + Para obter informações, siga o [Assistente de introdução no console do Amazon ECS](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), ou o [Guia de introdução](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) na documentação do Amazon ECS. + + Certifique-se de anotar os nomes que você definiu para o serviço do Amazon ECS e do cluster e use-os para as variáveis `ECS_SERVICE` e `ECS_CLUSTER` no fluxo de trabalho abaixo. + +3. Armazene sua definição de tarefa do Amazon ECS como um arquivo JSON no seu repositório de {% data variables.product.company_short %}. + + O formato do arquivo deve ser o mesmo que a saída gerada por: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Certifique-se de definir a variável `CONTAINER_NAME` no fluxo de trabalho abaixo como o nome do contêiner na seção `containerDefinitions` da definição da tarefa. + +4. Crie segredos de {% data variables.product.prodname_actions %} denominados `AWS_ACCESS_KEY_ID` e `AWS_SECRET_ACCESS_KEY` para armazenar os valores para sua chave de acesso ao Amazon IAM. + + Para obter mais informações sobre a criação de segredos para {% data variables.product.prodname_actions %}, consulte "[segredos criptografados](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + Veja a documentação para cada ação usada abaixo para as políticas recomendadas de IAM para o usuário de IAM, bem como os métodos para lidar com as credenciais de acesso. + +### Criar o fluxo de trabalho + +Depois que tiver preenchido os pré-requisitos, você poderá prosseguir com a criação do fluxo de trabalho. + +O fluxo de trabalho a seguir demonstra como construir uma imagem de contêiner e enviá-lo para o Amazon ECR. Em seguida, ele atualiza a definição da tarefa com o novo ID de imagem e implanta a definição da tarefa no Amazon ECS. + +Certifique-se de fornecer seus próprios valores para todas as variáveis na chave `env` do fluxo de trabalho. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### Recursos adicionais + +Para mais informações sobre os serviços utilizados nestes exemplos, veja a seguinte documentação: + +* "[Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)" na documentação da Amazon AWS. +* Ação oficial de "[Configurar credenciais](https://github.com/aws-actions/configure-aws-credentials) do AWS. +* Ação oficial de ["Login" do Amazon ECR](https://github.com/aws-actions/amazon-ecr-login) do AWS. +* Ação oficial de [Definição de tarefa de renderização do Amazon ECS"](https://github.com/aws-actions/amazon-ecs-render-task-definition) do AWS. +* Ação oficial de ["Definição de tarefa de implantação do Amazon ECS"](https://github.com/aws-actions/amazon-ecs-deploy-task-definition) do AWS. diff --git a/translations/pt-BR/content/actions/guides/deploying-to-azure-app-service.md b/translations/pt-BR/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..0e140cf995f0 --- /dev/null +++ b/translations/pt-BR/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: Implantar no Azure App Service +intro: Você pode fazer a implantação no Azure App Service como parte dos fluxos de trabalho com implantação contínua (CD). +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 %} + +### Introdução + +Este guia explica como usar {% data variables.product.prodname_actions %} para criar, testar e publicar um aplicativo no [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/). + +O Azure App Service pode executar aplicativos web em várias linguagens, mas este guia mostra a implantação de um projeto Node.js existente. + +### Pré-requisitos + +Antes de criar seu fluxo de trabalho de {% data variables.product.prodname_actions %}, primeiro você precisa concluir as etapas de configuração a seguir: + +1. Crie um plano do Azure App Service. + + Por exemplo, você pode usar o CLI do Azure para criar um novo plano de App Service: + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + No comando acima, substitua `MY_RESOURCE_GROUP` pelo seu Grupo de Recursos do Azure pré-existente, e `MY_APP_SERVICE_PLAN` por um novo nome para o plano do App Service. + + Para obter mais informações, consulte a documentação do Azure usando o [CLI do Azure](https://docs.microsoft.com/en-us/cli/azure/): + + * Para autenticação, consulte "[Efetuar login com o CLI do Azure](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)". + * Se você precisar criar um novo grupo de recursos, consulte "[grupo az](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)". + +2. Crie um aplicativo web. + + Por exemplo, você pode usar o CLI do Azure para criar um aplicativo web do Azure App Service com um tempo de execução de nó: + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + No comando acima, substitua os parâmetros pelos seus próprios valores, em que `MY_WEBAPP_NAME` é um novo nome para o aplicativo web. + +3. Configure um perfil de publicação do Azure e crie um segredo de `AZURE_WEBAPP_PUBLISH_PROFILE`. + + Gere suas credenciais de implantação do Azure usando um perfil de publicação. Para obter mais informações, consulte "[Gerar credenciais de implantação](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" na documentação do Azure. + + No seu repositório {% data variables.product.prodname_dotcom %}, crie um segredo denominado `AZURE_WEBAPP_PUBLISH_PROFILE` que contém o conteúdo do perfil de publicação. Para obter mais informações sobre a criação de segredos, consulte "[Segredos criptografados](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)". + +### Criar o fluxo de trabalho + +Depois de preencher os pré-requisitos, você pode prosseguir com a criação do fluxo de trabalho. + +O exemplo a seguir mostra como compilar, testar e implantar o projeto Node.js no Azure App Service. + +Certifique-se de definir `AZURE_WEBAPP_NAME` na chave de fluxo de trabalho `env` como o nome do aplicativo web que você criou. + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### Recursos adicionais + +Os seguintes recursos também podem ser úteis: + +* Para o fluxo de trabalho inicial original, consulte [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml) no repositório `starter-workflows` de {% data variables.product.prodname_actions %}. +* A ação usada para fazer a implantação do aplicativo web é a ação oficial [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) do Azure. +* O início rápido de "[Criar um aplicativo web Node.js no Azure](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)" na documentação do aplicativo web do Azure mostra como usar o VS Code com a [extensão do Azure App Service](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). diff --git a/translations/pt-BR/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/pt-BR/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..f3727e523d8f --- /dev/null +++ b/translations/pt-BR/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: Implantar no Google Kubernetes Engine +intro: Você pode realizar a implantação no Google Kubernetes Engine como parte dos seus fluxos de trabalho de implantação contínua (CD). +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 %} + +### Introdução + +Este guia explica como usar {% data variables.product.prodname_actions %} para construir um aplicativo conteinerizado, fazer push no Google Container Registry (GCR) e fazer a implantação no Google Kubernetes Engine (GKE). + +O GKE é um serviço de cluster gerenciado do Kubernetes pelo Google Cloud que pode hospedar suas cargas de trabalho containerizadas na nuvem ou em seu próprio centro de dados. Para obter mais informações, consulte [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine). + +### Pré-requisitos + +Antes de prosseguir com a criação do fluxo de trabalho, você precisará concluir as etapas a seguir para seu projeto do Kubernetes. Este guia assume que a raiz do seu projeto já possui um `arquivo Docker` e um arquivo de configuração de implantação do Kubernetes. Por exemplo, consulte [google-github-actions](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke). + +#### Criar um cluster do GKE + +Para criar o cluster do GKE, primeiro você precisará efetuar a autenticação usando o CLI de `gcloud`. Para obter mais informações sobre esta etapa, veja os artigos a seguir: +- [`gcloud auth login`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI e Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +Por exemplo: + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### Habilitar as APIs + +Habilitar as APIs do Kubernetes Engine e do Registro de Contêiner. Por exemplo: + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### Configurar uma conta de serviço e armazenar as suas credenciais + +Este procedimento demonstra como criar a conta de serviço para sua integração com o GKE. Ele explica como criar a conta, adicionar funções, recuperar suas chaves, e armazená-las como um [secreto de repositório criptografado](/actions/reference/encrypted-secrets) codificado em base 64 denominado `GKE_SA_KEY`. + +1. Crie uma nova conta de serviço: + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. Recupere o endereço de e-mail da conta de serviço que você acabou de criar: + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. Adicionar funções à conta de serviço. Observação: Aplique funções mais restritivas para atender aos seus requisitos. + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. Faça o download do arquivo chave do JSON para a conta de serviço: + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. Armazene o ID do projeto como um segredo denominado `GKE_PROJECT`: + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### (Opcional) Configurar kustomize +Kustomize é uma ferramenta opcional usada para gerenciar especificações do YAML. Depois de criar um arquivo do _kustomization_, o fluxo de trabalho abaixo pode ser usado para definir dinamicamente os campos da imagem e adicionar o resultado ao `kubectl`. Para obter mais informações, consulte [uso de kustomize](https://github.com/kubernetes-sigs/kustomize#usage). + +### Criar o fluxo de trabalho + +Depois de preencher os pré-requisitos, você pode prosseguir com a criação do fluxo de trabalho. + +O fluxo de trabalho a seguir mostra como construir uma imagem de contêiner e como carregá-los no GCR. Em seguida, ele usa as ferramentas do Kubernetes (como `kubectl` e `kustomize`) para mover a imagem para a implantação do cluster. + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### Recursos adicionais + +Para mais informações sobre as ferramentas usadas nesses exemplos, consulte a documentação a seguir: + +* Para o fluxo de trabalho inicial completo, consulte o [Fluxo de trabalho de "criar e implantar no GKE"](https://github.com/actions/starter-workflows/blob/master/ci/google.yml). +* Para mais fluxos de trabalho iniciais e código de acompanhamento, consulte o [fluxos de trabalho de exemplos de {% data variables.product.prodname_actions %} do Google](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/). +* Mecanismo de personalização do YAML do Kubernetes: [Kustomize](https://kustomize.io/). +* "[Implantarum aplicativo web conteinerizado](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)" na documentação do Google Kubernetes Engine . diff --git a/translations/pt-BR/content/actions/guides/index.md b/translations/pt-BR/content/actions/guides/index.md index 8774c1a09cf3..26ee8a09354a 100644 --- a/translations/pt-BR/content/actions/guides/index.md +++ b/translations/pt-BR/content/actions/guides/index.md @@ -36,6 +36,14 @@ Você pode usar o {% data variables.product.prodname_actions %} para criar fluxo {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### Criar fluxos de trabalho personalizados de de implantação contínua + +Você pode usar {% data variables.product.prodname_actions %} para criar fluxos de trabalho personalizados de implantação contínua (CDD) que implementam projetos em vários ecossistemas parceiros em nuvem. + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### 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 %}. diff --git a/translations/pt-BR/content/actions/guides/publishing-docker-images.md b/translations/pt-BR/content/actions/guides/publishing-docker-images.md index e7f9aa9fe304..f8445c5ffdfd 100644 --- a/translations/pt-BR/content/actions/guides/publishing-docker-images.md +++ b/translations/pt-BR/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ Neste guia, usaremos a ação `build-push-action` do Docker para criar a imagem 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. +Para fazer push para o Docker Hub, você deverá ter uma conta Docker Hub e ter criado um repositório Docker Hub. For more information, see "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" in the Docker documentation. 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 seu repositório de {% 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)". +* `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 para que não estejam 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 %} diff --git a/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md b/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md index 2883119128bf..01b61818fd1e 100644 --- a/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/pt-BR/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ Se você adicionar etapas ao seu fluxo de trabalho para configurar os campos `pu 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)". +Para executar operações autenticadas para o registro npm em seu fluxo de trabalho, você precisará armazenar seu token de autenticação npm como um segredo. Por exemplo, crie um repositório secreto 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`. diff --git a/translations/pt-BR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/pt-BR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index a1cfb94f094e..91bdf822e16f 100644 --- a/translations/pt-BR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/translations/pt-BR/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} 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 39ef9703651e..f5732142bf09 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 @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/pt-BR/content/actions/index.md b/translations/pt-BR/content/actions/index.md index 7de361318f69..9fa1e6562f50 100644 --- a/translations/pt-BR/content/actions/index.md +++ b/translations/pt-BR/content/actions/index.md @@ -1,7 +1,7 @@ --- -title: GitHub Actions Documentation +title: Documentação do GitHub Actions shortTitle: GitHub Actions -intro: 'Automate, customize, and execute your software development workflows right in your repository with {% data variables.product.prodname_actions %}. You can discover, create, and share actions to perform any job you''d like, including CI/CD, and combine actions in a completely customized workflow.' +intro: 'Automatize, personalize e execute seus fluxos de trabalho de desenvolvimento do software diretamente no seu repositório com o {% data variables.product.prodname_actions %}. Você pode descobrir, criar e compartilhar ações para realizar qualquer trabalho que desejar, incluindo CI/CD, bem como combinar ações em um fluxo de trabalho completamente personalizado.' introLinks: quickstart: /actions/quickstart reference: /actions/reference @@ -25,21 +25,19 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: - - title: Removing set-env and add-path commands on November 16 + - + title: Visualização do fluxo de trabalho + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ + - + title: Remover comandos set-env e add-path em 16 de novembro date: '2020-11-09' href: https://github.blog/changelog/2020-10-01-github-actions-deprecating-set-env-and-add-path-commands/ - - title: Ubuntu-latest workflows will use Ubuntu-20.04 + - + title: Os últimos fluxos de trabalho do Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - title: MacOS Big Sur Preview - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - title: Self-Hosted Runner Group Access Changes - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ - product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU - redirect_from: - /articles/automating-your-workflow-with-github-actions/ - /articles/customizing-your-project-with-github-actions/ @@ -65,23 +63,23 @@ versions: {% assign actionsCodeExamples = site.data.variables.action_code_examples %} {% if actionsCodeExamples %}
    -

    Code examples

    +

    Exemplos de códigos

    - +
    {% render 'code-example-card' for actionsCodeExamples as example %}
    - +
    {% octicon "search" width="24" %}
    -

    Sorry, there is no result for

    -

    It looks like we don't have an example that fits your filter.
    Try another filter or add your code example

    - Learn how to add a code example {% octicon "arrow-right" %} +

    Desculpe, não há resultados para

    +

    Parece que não temos um exemplo que se encaixa no seu filtro.
    Tente outro filtro ou adicione seu exemplo de código

    + Saiba como adicionar um exemplo de código {% octicon "arrow-right" %}
    {% endif %} 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 index 27acef164a8f..75468b9522cb 100644 --- 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 @@ -76,7 +76,7 @@ etapas: #### 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`: +Fazer referência a um branch específico significa que a ação sempre usará 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: 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 index 877ed92f9056..e2c861794564 100644 --- 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 @@ -1,7 +1,7 @@ --- 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.' +intro: 'Este guia mostra como usar os recursos avançados de {% data variables.product.prodname_actions %}, com gestão de segredo, trabalhos dependentes, cache, matrizes de compilação{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} ambientes,{% endif %} e etiquetas.' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: Para obter mais informações, consulte ["Usar etiquetas com executores auto-hospedados](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)". +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Usar ambientes + +Você pode configurar ambientes com regras de proteção e segredos. Cada trabalho em um fluxo de trabalho pode fazer referência a um único ambiente. Todas as regras de proteção configuradas para o ambiente têm de ser aprovadas antes que um trabalho de referência ao ambiente seja enviado a um executor. Para obter mais informações, consulte "[Ambientes](/actions/reference/environments)". +{% endif %} + ### 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-jenkins-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md index 5fd8f915ad9b..b65744e7819a 100644 --- 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 @@ -57,7 +57,7 @@ O Jenkins usa diretivas para gerenciar os _Declarative Pipelines_. Essas diretiv | 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) | +| [`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) | diff --git a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index c63dd16fe90a..38f4f27efc27 100644 --- a/translations/pt-BR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/pt-BR/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ Ao fazer a migração do Travis CI, considere os recursos principais a seguir em #### Armazenar segredos -{% data variables.product.prodname_actions %} permite armazenar segredos e referenciá-los em seus trabalhos. {% data variables.product.prodname_actions %} também inclui políticas que permitem limitar o acesso a segredos no nível do repositório e da organização. Para obter mais informações, consulte "[Segredos criptografados](/actions/reference/encrypted-secrets)". +{% data variables.product.prodname_actions %} permite armazenar segredos e referenciá-los em seus trabalhos. Organizações de {% data variables.product.prodname_actions %} podem limitar quais repositórios podem acessar segredos da organização. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}As regras de proteção de ambiente podem exigir a aprovação manual de um fluxo de trabalho para acessar segredos de ambiente. {% endif %}Para obter mais informações, consulte "[Segredos criptografados](/actions/reference/encrypted-secrets)". #### Compartilhar arquivos entre trabalhos e fluxos de trabalho 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 index 8d55d5d08306..67c1c0836504 100644 --- 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 @@ -19,7 +19,7 @@ Este guia explica como configurar o fortalecimento de segurança para certos rec ### 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 %}. +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 na organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repositório, ambiente{% else %} ou níveis do repositório{% endif %} 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. @@ -38,6 +38,10 @@ Para ajudar a prevenir a divulgação acidental, o {% data variables.product.pro - **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. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **Considere a necessidade de revisão para acesso a segredos** + - Você pode usar revisores necessários para proteger os segredos do ambiente. Um trabalho de fluxo de trabalho não pode acessar segredos de ambiente até que a aprovação seja concedida por um revisor. Para mais informações sobre armazenar segredos em ambientes ou exigir revisões para ambientes, consulte "[segredos criptografados](/actions/reference/encrypted-secrets)" e "[Ambientes](/actions/reference/environments)". +{% endif %} ### Usando ações de terceiros @@ -66,13 +70,13 @@ Isso significa que comprometer uma única ação dentro de um fluxo de trabalho ### 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. +O {% data variables.product.product_name %} tem um escopo intencional para um único repositório por vez. O `GITHUB_TOKEN` 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 de {% data variables.product.prodname_dotcom %} a um 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. +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 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** +1. **O `GITHUB_TOKEN`** - 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** 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 index 483598d3c7bc..8091fa50c26f 100644 --- 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 @@ -13,6 +13,9 @@ versions: 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/index.md b/translations/pt-BR/content/actions/managing-workflow-runs/index.md index d7a79763ae52..3bf3a1e51ce2 100644 --- a/translations/pt-BR/content/actions/managing-workflow-runs/index.md +++ b/translations/pt-BR/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- 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.' +intro: 'Você pode visualizar o status e os resultados de cada etapa de seu fluxo de trabalho, cancelar um fluxo de trabalho pendente, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}implantar revisão, {% endif %}visualizar minutos de execução de trabalhos faturáveis, depurar e executar novamente um fluxo de trabalho, pesquisar e fazer download de logs e artefatos.' redirect_from: - /actions/configuring-and-managing-workflows/managing-a-workflow-run - /articles/viewing-your-repository-s-workflows @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/pt-BR/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/pt-BR/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..db2896e70a7d --- /dev/null +++ b/translations/pt-BR/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: Revisar implantações +intro: Você pode aprovar ou rejeitar trabalhos que estão aguardando revisão. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### Sobre revisões necessárias nos fluxos de trabalho + +Os trabalhos que fazem referência a um ambiente configurado com os revisores necessários irão aguardar a aprovação antes de serem iniciados. Enquanto um trabalho está aguardando aprovação, ele tem um status de "Aguardando". Se um trabalho não for aprovado em 30 dias, a execução do fluxo de trabalho será automaticamente cancelada. + +Para obter mais informações sobre ambientes e aprovações necessárias, consulte "[Ambientes](/actions/reference/environments)". + +### Aprovar ou rejeitar um trabalho + +1. Acesse a execução do fluxo de trabalho que requer revisão. Para obter mais informações sobre navegação até uma execução do fluxo de trabalho, consulte "[Visualizar histórico de execução de fluxo de trabalho](/actions/managing-workflow-runs/viewing-workflow-run-history)". +2. Clique em **Revisar implantações**. ![Revisar implantações](/assets/images/actions-review-deployments.png) +3. Selecione o(s) ambiente(s) de trabalho a serem aprovados ou rejeitados. Opcionalmente, deixe um comentário. ![Aprovar implantações](/assets/images/actions-approve-deployments.png) +4. Aprovar ou rejeitar: + - Para aprovar o trabalho, clique em **Aprovar e implantar**. Assim que um trabalho for aprovado (e quaisquer outras regras de proteção do ambiente serem aprovadas), o trabalho prosseguirá. Nesta altura, o trabalho pode acessar quaisquer segredos armazenados no ambiente. + - Para rejeitar o trabalho, clique em **Rejeitar**. Se um trabalho for rejeitado, o fluxo de trabalho falhará. 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 index 3362ce34d19f..73230c8e507b 100644 --- a/translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/pt-BR/content/actions/reference/authentication-in-a-workflow.md @@ -14,8 +14,6 @@ versions: {% 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. diff --git a/translations/pt-BR/content/actions/reference/encrypted-secrets.md b/translations/pt-BR/content/actions/reference/encrypted-secrets.md index e624cd1cf8fa..53d0328a21ed 100644 --- a/translations/pt-BR/content/actions/reference/encrypted-secrets.md +++ b/translations/pt-BR/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- title: Segredos criptografados -intro: Os segredos encriptados permitem que você armazene informações confidenciais no seu repositório ou organização. +intro: Segredos criptografados permitem que você armazene informações confidenciais na organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repositório ou ambientes de repositórios{% else %} ou repositório{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,14 +12,19 @@ versions: --- {% data reusables.actions.enterprise-beta %} +{% data reusables.actions.environments-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. +Os segredos são variáveis de ambiente criptografadas que você cria em uma organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repositório ou ambiente do repositório{% else %} ou repositório{% endif %}. Os segredos que você cria estão disponíveis para utilização nos fluxos de trabalho em {% data variables.product.prodname_actions %}. {% data variables.product.prodname_dotcom %} usa uma [caixa selada libsodium](https://libsodium.gitbook.io/doc/public-key_cryptography/sealed_boxes) para ajudar a garantir que os segredos sejam criptografados antes de chegarem a {% data variables.product.prodname_dotcom %} e permaneçam criptografados até que você os use em um fluxo de trabalho. {% data reusables.github-actions.secrets-org-level-overview %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Para segredos armazenados no nível do ambiente, você pode habilitar os revisores necessários para controlar o acesso aos segredos. Um trabalho de fluxo de trabalho não pode acessar segredos de ambiente até que a aprovação seja concedida por aprovadores necessários. +{% endif %} + #### Nomear os seus segredos As regras a seguir aplicam-se aos nomes dos segredos: @@ -27,7 +32,10 @@ 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á. +* Nomes dos segredos não diferenciam maiúsculas de minúsculas. +* Os nomes dos segredos devem ser únicos no nível em que são criados. Por exemplo, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}um segredo criado no nível de ambiente deve ter um nome exclusivo nesse ambiente, {% endif %}um segredo criado no nível do repositório deve ter um nome exclusivo nesse repositório, e um segredo criado no nível da organização deve ter um nome exclusivo nesse nível. + + Se existir um segredo com o mesmo nome em vários níveis, o segredo no nível inferior tem prioridade. Por exemplo, se um segredo a nível de organização tiver o mesmo nome que um segredo a nível de repositório, o segredo a nível de repositório terá prioridade.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Da mesma forma, se uma organização, repositório e ambiente tiverem um segredo com o mesmo nome, o segredo do ambiente terá prioridade.{% endif %} 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. @@ -43,6 +51,10 @@ Você pode usar e ler segredos encriptados em um arquivo de fluxo de trabalho se {% endwarning %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Os segredos da organização e do repositório são lidos quando uma execução de fluxo de trabalho é enfileirada e os segredos de ambiente são lidos quando um trabalho que faz referência ao ambiente é iniciado. +{% endif %} + Você também pode gerenciar segredos usando o API REST. Para obter mais informações, consulte "[Segredos](/rest/reference/actions#secrets)". #### Permissões limitadas de credenciais @@ -56,12 +68,27 @@ Ao gerar credenciais, recomendamos que você conceda as permissões mínimas pos {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.github-actions.sidebar-secret %} -1. Clique em **Adicionar novo segredo**. +1. Clique em **Novo segredo do repositório**. 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. +Se o seu repositório {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}tiver segredos de ambiente ou {% endif %}puderem acessar os segredos da organização principal, esses segredos também serão listados nesta página. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Criar segredos criptografados para um ambiente + +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Clique no ambiente ao qual você deseja adicionar um segredo. +1. Em **Segredos do ambiente**, clique em **Adicionar 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). +{% endif %} ### Criar segredos encriptados para uma organização @@ -72,7 +99,7 @@ Ao criar um segredo em uma organização, você pode usar uma política para lim {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.sidebar-secret %} -1. Clique em **Novo segredo**. +1. Clique em **Novo segredo da organização**. 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. @@ -90,7 +117,7 @@ Você pode verificar quais políticas de acesso são aplicadas a um segredo na s ### 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. +{% data reusables.actions.forked-secrets %} 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)." @@ -150,7 +177,7 @@ etapas: ### 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. +Você pode armazenar até 1.000 segredos por organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 segredos por repositório e 100 segredos por ambiente{% else %} e 100 segredos por repositório{% endif %}. Um fluxo de trabalho pode usar até 100 segredos da organização e 100 segredos de repositório.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Além disso, um trabalho que faz referência a um ambiente pode usar até 100 segredos de ambiente.{% endif %} 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)". diff --git a/translations/pt-BR/content/actions/reference/environment-variables.md b/translations/pt-BR/content/actions/reference/environment-variables.md index ece38c87c3de..e25c71a480ab 100644 --- a/translations/pt-BR/content/actions/reference/environment-variables.md +++ b/translations/pt-BR/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)". +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 um 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), and [`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: @@ -51,8 +51,8 @@ Você também pode usar o {% if currentVersion == "free-pro-team@latest" or curr | `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_HEAD_REF` | Definir somente para eventos de pull request. O nome do branch principal. | +| `GITHUB_BASE_REF` | Definir somente para eventos de pull request. O nome do branch de 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`. | diff --git a/translations/pt-BR/content/actions/reference/environments.md b/translations/pt-BR/content/actions/reference/environments.md new file mode 100644 index 000000000000..75492a337d2d --- /dev/null +++ b/translations/pt-BR/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: Ambientes +intro: Você pode configurar ambientes com regras de proteção e segredos. Um trabalho de fluxo de trabalho pode fazer referência a um ambiente para usar as regras de proteção e os segredos do ambiente. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### Sobre ambientes + +Você pode configurar ambientes com regras de proteção e segredos. Quando um trabalho de fluxo de trabalho faz referência a um ambiente, o trabalho não será iniciado até que todas as regras de proteção do ambiente sejam aprovadas. Um trabalho também não pode acessar segredos definidos em ambiente até que todas as regras de proteção do ambiente sejam aprovadas. + +{% if currentVersion == "free-pro-team@latest" %} +As regras de proteção do ambiente e os segredos de ambiente só estão disponíveis em repositórios públicos. Se você converter um repositório de público em privado, todas as regras de proteção ou segredos de ambiente configurados serão ignorados, e você não conseguirá configurar nenhum ambiente. Se você converter seu repositório de volta para público, você terá acesso a todas as regras de proteção e segredos de ambiente previamente configurados. +{% endif %} + +#### Regras de proteção de ambiente + +As normas de proteção do ambiente exigem a aprovação de condições específicas antes que um trabalho que faz referência ao ambiente possa prosseguir. Você pode usar regras de proteção ambiental para exigir uma aprovação manual ou para atrasar um trabalho. + +##### Revisores necessários + +Use os revisores necessários para exigir que uma pessoa ou equipe específica aprove os trabalhos do fluxo de trabalho que fazem referência ao ambiente. Você pode listar até seis usuários ou equipes como revisores. Os revisores devem ter, pelo menos, acesso de leitura ao repositório. Apenas um dos revisores precisam aprovar o trabalho para que prossiga. + +Para obter mais informações sobre os trabalhos de revisão que fazem referência a um ambiente com os revisores necessários, consulte "[Revisar implantações](/actions/managing-workflow-runs/reviewing-deployments)". + +##### Temporizador de espera + +Use o temporizador de espera para atrasar o trabalho por um período específico de tempo depois que o trabalho for inicialmente acionado. O tempo (em minutos) deve ser um número inteiro entre 0 e 43.200 (30 dias). + +#### Segredos de ambiente + +Os segredos armazenados em um ambiente só estão disponíveis para trabalhos de fluxo de trabalho que fazem referência ao ambiente. Se o ambiente exigir aprovação, um trabalho não poderá acessar segredos de ambiente até que um dos revisores necessários o aprove. Para obter mais informações sobre segredos, consulte "[Segredos criptografados](/actions/reference/encrypted-secrets)". + +### Criar um ambiente + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Clique em **Novo ambiente**. +1. Insira um nome para o ambiente e clique em **Configurar ambiente**. Os nomes de ambiente não diferenciam maiúsculas de minúsculas. Um nome de ambiente não pode exceder 255 caracteres e deve ser único dentro do repositório. +1. Configure todas as regras de proteção de ambiente ou segredos de ambiente. + +Executar um fluxo de trabalho que faz referência a um ambiente que não existe criará um ambiente com o nome referenciado. O novo ambiente não terá nenhuma regra de proteção ou segredos configurados. Qualquer pessoa que possa editar fluxos de trabalho no repositório pode criar ambientes por meio de um arquivo de fluxo de trabalho, mas apenas os administradores do repositório podem configurar o ambiente. + +### Fazer referência a um ambiente + +Cada trabalho em um fluxo de trabalho pode fazer referência a um único ambiente. Todas as regras de proteção configuradas para o ambiente têm de ser aprovadas antes que um trabalho de referência ao ambiente seja enviado a um executor. Quando o trabalho é enviado para o executor, o trabalho poderá acessar os segredos do ambiente. + +Para obter mais informações sobre sintaxe para ambientes de referência em fluxos de trabalho, consulte "[Sintaxe do fluxo de trabalho para GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)". Para obter mais informações sobre os trabalhos de revisão que fazem referência a um ambiente com os revisores necessários, consulte "[Revisar implantações](/actions/managing-workflow-runs/reviewing-deployments)". + +Quando um fluxo de trabalho faz referência a um ambiente, o ambiente aparecerá nas implantações do repositório. Para obter mais informações sobre a visualização de implementações atuais e anteriores, consulte "[Visualizar histórico de implantação](/developers/overview/viewing-deployment-history)". + +### Excluir um ambiente + +{% data reusables.github-actions.permissions-statement-environment %} + +A exclusão de um ambiente apagará todos os segredos e regras de proteção associados ao ambiente. Todos os trabalhos que estejam atualmente em espera devido às regras de proteção do ambiente eliminado falharão automaticamente. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Próximo o ambiente que você deseja excluir, clique em {% octicon "trashcan" aria-label="The trashcan icon" %}. +2. Clique em **Eu entendi, exclua este ambiente**. 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 d35c6d577981..46241217e8c3 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 @@ -309,9 +309,9 @@ Executa o fluxo de trabalho sempre que o evento `issue_comment` ocorre. {% data {% data reusables.github-actions.branch-requirement %} -| 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 | +| Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------ | ------------- | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Último commit no branch padrão | Branch padrão | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -576,7 +576,13 @@ on: #### `pull_request_target` -Este evento é semelhante ao `pull_request`, exceto que é executado no contexto do repositório-base do pull request, em vez de ser executado no commit de merge. Isso significa que você pode disponibilizar os seus segredos de forma mais segura nos fluxos de trabalho acionados pelo pull request, porque apenas os fluxos de trabalho definidos no commit no repositório-base são executados. Por exemplo, este evento permite que você crie fluxos de trabalho que etiquetam e façam comentários em pull requests, com base no conteúdo da carga do evento. +Este evento é executado no contexto da base do pull request, em vez de no commit de merge como o evento `pull_request` faz. Isso impede a execução de código de fluxo de trabalho inseguro do cabeçalho do pull request que poderia alterar seu repositório ou roubar quaisquer segredos que você usa no fluxo de trabalho. Este evento permite que você faça coisas como criar fluxos de trabalho que etiquetam e comentam em pull requests com base no conteúdo da carga do evento. + +{% warning %} + +**Aviso:** O evento `pull_request_target` recebe um token de repositório de leitura/gravação e pode acessar segredos, mesmo quando é acionado a partir de uma bifurcação. Embora o fluxo de trabalho seja executado no contexto da base do pull request, você deve certificar-se de que você não irá fazer checkout, construir ou executar o código não confiável do pull request com este evento. Além disso, qualquer cache compartilham o mesmo escopo do branch de base e ajuda a evitar envenenamento do cache. Você não deve salvar o cache se houver a possibilidade de que o conteúdo de cache ter sido alterado. + +{% endwarning %} | Carga de evento webhook | Tipos de atividade | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- | --------------------------- | @@ -725,4 +731,4 @@ on: {% 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)". -Se você deseja acionar um fluxo de trabalho a partir de uma execução do fluxo de trabalho, você pode acionar o evento usando um token de acesso pessoal. Você deverá criar um token de acesso pessoal e armazená-lo como um segredo. Para minimizar seus custos de uso {% data variables.product.prodname_actions %}, certifique-se de que você não cria execução de fluxo de trabalho recursivo ou não intencional. Para obter mais informações, consulte "[Criar e armazenar segredos encriptados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". +Se você deseja acionar um fluxo de trabalho a partir de uma execução do fluxo de trabalho, você pode acionar o evento usando um token de acesso pessoal. Você deverá criar um token de acesso pessoal e armazená-lo como um segredo. Para minimizar seus custos de uso {% data variables.product.prodname_actions %}, certifique-se de que você não cria execução de fluxo de trabalho recursivo ou não intencional. Para mais informações sobre como armazenar um token de acesso pessoal como segredo, consulte "[Criar e armazenar segredos criptografados](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)". diff --git a/translations/pt-BR/content/actions/reference/index.md b/translations/pt-BR/content/actions/reference/index.md index 3c098b0320b4..68d9c56955db 100644 --- a/translations/pt-BR/content/actions/reference/index.md +++ b/translations/pt-BR/content/actions/reference/index.md @@ -27,11 +27,19 @@ Você pode configurar fluxos de trabalho para serem executados quando eventos es ### 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. +{% 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 sensíveis como um segredo na sua organização{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repositório ou ambientes{% else %} ou repositório{% endif %}. {% data variables.product.prodname_dotcom %} criptografa todos os segredos. {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Ambientes + +Os trabalhos do fluxo de trabalho podem fazer referência a ambientes que possuem regras de proteção ou segredos específicos do ambiente. + +{% link_in_list /environments %} +{% endif %} + ### 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. 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 056b5a3f1a12..fd32c916748b 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 @@ -305,11 +305,13 @@ steps: `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. +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### Exemplo +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 863f1adadae3..7f993432080d 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 @@ -187,7 +187,7 @@ For more information about cron syntax, see "[Events that trigger workflows](/ac ### `env` -A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: A workflow run is made up of one or more jobs. Jobs run in parallel by default. To run jobs sequentially, you can define dependencies on other jobs using the `jobs..needs` keyword. -Each job runs in an environment specified by `runs-on`. +Each job runs in a runner 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 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. @@ -320,6 +320,39 @@ 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)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +The environment that the job references. All environment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." + +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[Deployments](/rest/reference/repos#deployments)." + +##### Example using a single environment name + +```yaml +environment: staging_environment +``` + +##### Example using environment name and URL + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +The URL can be an expression and can use any context except for the `secrets` context. For more information about expressions, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +#### Example +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `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). @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `jobs..steps[*].id` A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." -### `jobs..steps.if` +### `jobs..steps[*].if` You can use the `if` conditional to prevent a step from running unless a condition is met. You can use any supported context and expression to create a conditional. @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` A name for your step to display on {% data variables.product.prodname_dotcom %}. -### `jobs..steps.uses` +### `jobs..steps[*].uses` Selects an action to run as part of a step in your job. An action is a reusable unit of code. You can use an action defined in the same repository as the workflow, a public repository, or in a [published Docker container image](https://hub.docker.com/). @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` Runs command-line programs using the operating system's shell. If you do not provide a `name`, the step name will default to the text specified in the `run` command. @@ -675,7 +708,7 @@ For built-in shell keywords, we provide the following defaults that are executed - There doesn't seem to be a way to fully opt into fail-fast behavior other than writing your script to check each error code and respond accordingly. Because we can't actually provide that behavior by default, you need to write this behavior into your script. - `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. This behavior is internally consistent with the previous `sh` and `pwsh` default behavior and is the `cmd.exe` default, so this behavior remains intact. -### `jobs..steps.with` +### `jobs..steps[*].with` A `map` of the input parameters defined by the action. Each input parameter is a key/value pair. Input parameters are set as environment variables. The variable is prefixed with `INPUT_` and converted to upper case. @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` A `string` that defines the inputs for a Docker container. {% data variables.product.prodname_dotcom %} passes the `args` to the container's `ENTRYPOINT` when the container starts up. An `array of strings` is not supported by this parameter. @@ -718,7 +751,7 @@ 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` +### `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. @@ -734,7 +767,7 @@ steps: The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs. -### `jobs..steps.env` +### `jobs..steps[*].env` Sets environment variables for steps to use in the runner environment. You can also set environment variables for the entire workflow or a job. For more information, see [`env`](#env) and [`jobs..env`](#jobsjob_idenv). @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` Prevents a job from failing when a step fails. Set to `true` to allow a job to pass when this step fails. -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` The maximum number of minutes to run the step before killing the process. @@ -769,7 +802,7 @@ The maximum number of minutes to let a job run before {% data variables.product. ### `jobs..strategy` -A strategy creates a build matrix for your jobs. You can define different variations of an environment to run each job in. +A strategy creates a build matrix for your jobs. You can define different variations to run each job in. ### `jobs..strategy.matrix` diff --git a/translations/pt-BR/content/admin/configuration/configuring-email-for-notifications.md b/translations/pt-BR/content/admin/configuration/configuring-email-for-notifications.md index 28a6f4a3e0e8..c8c74cc42ce7 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/pt-BR/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ O seu gerente de contas técnico dedicado em {% data variables.contact.github_support %} pode configurar o e-mail para notificações serem enviadas através de seu servidor SMTP. Certifique-se de incluir os detalhes a seguir na sua solicitação de suporte. - O endereço do seu servidor SMTP +- Informações de login para efetuar a autenticação no servidor: nome de usuário e senha - A porta que o seu servidor SMTP usa para enviar e-mail - O nome de domínio que o seu servidor SMTP enviará com uma resposta HELO, se houver - O tipo de criptografia usado pelo seu servidor SMTP 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 e3335854c4cf..7cf42d633043 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 @@ -94,7 +94,7 @@ O {% data variables.contact.enterprise_support %} observa esses feriados dos EUA | Ação de Graças (Dia 2) | 4ª sexta-feira de novembro | | Natal (Dia 1) | 24 de dezembro | | Natal (Dia 2) | 25 de dezembro | -| Natal (Dia 3) | 26 de dezembro | +| Natal (Dia 3) | 28 de dezembro | | Ano-Novo | 31 de dezembro | #### Feriados no Japão 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 3780d47a7c21..1813c564c039 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 @@ -44,7 +44,7 @@ Oferecemos suporte para {% data variables.product.prodname_advanced_security %}, O {% data variables.contact.enterprise_support %} observa esses feriados dos EUA. feriados. -| EUA Feriado | Datas em 2018 | +| EUA Feriado | Data de observação | | ----------------------- | ----------------------------- | | Fraternidade Universal | 1º de janeiro | | Martin Luther King, Jr. | 3ª segunda-feira de janeiro | @@ -57,7 +57,7 @@ O {% data variables.contact.enterprise_support %} observa esses feriados dos EUA | Ação de Graças (Dia 2) | 4ª sexta-feira de novembro | | Natal (Dia 1) | 24 de dezembro | | Natal (Dia 2) | 25 de dezembro | -| Natal (Dia 3) | 26 de dezembro | +| Natal (Dia 3) | 28 de dezembro | | Ano-Novo | 31 de dezembro | ### Instalando as atualizações do {% data variables.product.prodname_advanced_security %} 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 9d0fb4fc2e01..6d55813c0c11 100644 --- a/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md +++ b/translations/pt-BR/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ Uma conta corporativa permite gerenciar várias organizações{% if enterpriseSe - Segurança {% if enterpriseServerVersions contains currentVersion %}(logon único, autenticação de dois fatores) - Compartilhamento de pacotes de solicitação e {% if enterpriseServerVersions contains currentVersion %}suporte {% endif %} com {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} Para ver mais informações sobre como gerenciar sua assinatura de {% data variables.product.prodname_ghe_cloud %}, consulte "[Visualizar a assinatura e o uso para sua conta corporativa](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}Para obter mais informações sobre como gerenciar suas configurações de cobrança de {% data variables.product.product_name %}, consulte "[Gerenciar cobrança para sua empresa](/admin/overview/managing-billing-for-your-enterprise)". +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}Para obter mais informações sobre como gerenciar suas configurações de cobrança de {% data variables.product.product_name %}, consulte "[Gerenciar cobrança para sua empresa](/admin/overview/managing-billing-for-your-enterprise)". + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} diff --git a/translations/pt-BR/content/admin/user-management/managing-organizations-in-your-enterprise.md b/translations/pt-BR/content/admin/user-management/managing-organizations-in-your-enterprise.md index cf6fd593f218..183b3d71329d 100644 --- a/translations/pt-BR/content/admin/user-management/managing-organizations-in-your-enterprise.md +++ b/translations/pt-BR/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: 'As organizações são uma forma excelente de criar conjuntos distintos de usuários na empresa, como divisões ou grupos que trabalham em projetos semelhantes. {% if currentVersion == "github-ae@latest" %}Internal{% else %}Public and internal{% endif %} 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 that are granted access.' +intro: 'As organizações são uma forma excelente de criar conjuntos distintos de usuários na empresa, como divisões ou grupos que trabalham em projetos semelhantes. {% if currentVersion == "github-ae@latest" %}Repositórios internos{% else %}Públicos e internos{% endif %} que pertencem a uma organização podem ser acessados pelos usuários de outras organizações, enquanto repositórios privados podem ser acessados por qualquer pessoa, exceto por integrantes da organização que recebem acesso.' mapTopic: true versions: enterprise-server: '*' 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 e1b7d1ce071a..48280ed68c53 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 @@ -45,20 +45,21 @@ Atalhos de teclado do GitHub Desktop no macOS ### 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 | +| 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 | +| ⌘Enter | Realizar commit de alterações quando o campo de resumo ou descrição estiver ativo | +| 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 %} @@ -98,20 +99,21 @@ Atalhos de teclado do GitHub Desktop no Windows ### 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 | +| 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 | +| CtrlEnter | Realizar commit de alterações quando o campo de resumo ou descrição estiver ativo | +| 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 %} 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 0cfcdc820eb9..a69a98cceafd 100644 --- a/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/pt-BR/content/developers/apps/authorizing-oauth-apps.md @@ -265,7 +265,9 @@ O parâmetro opcional `redirect_uri` também pode ser usado para URLs do localhh Para a URL de retorno de chamada `http://localhost/path`, você poderá usar este `redirect_uri`: - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### Criar vários tokens para aplicativos OAuth 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 9a5a4fc628cf..5a65213a1abc 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 @@ -49,39 +49,39 @@ Lista completa de parâmetros de consulta, permissões e eventos disponíveis en 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`. -| Permissão | Descrição | -| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 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](/rest/reference/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](/rest/reference/checks). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| `content_references` | Concede acesso ao ponto final "[Criar um anexo de conteúdo](/rest/reference/apps#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`. | +| [`Verificações`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Concede acesso à [API de verificação](/rest/reference/checks). Pode ser: `nenhum`, `leitura` ou `gravação`. | +| `content_references` | Concede acesso ao ponto final "[Criar um anexo de conteúdo](/rest/reference/apps#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](/rest/reference/repos#deployments). Pode ser um das: `none`, `read`, ou `write`{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Concede acesso à [API de e-mails](/rest/reference/users#emails). Pode ser: `nenhum`, `leitura` ou `gravação`.{% endif %} -| [`seguidores`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Concede acesso à [API de seguidores](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/users#keys). Pode ser: `nenhum`, `leitura` ou `gravação`. | +| [`seguidores`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Concede acesso à [API de seguidores](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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 %}. | +| [`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](/rest/reference/orgs#update-an-organization)" ponto final e Pa [API de restrições de interação da organização](/rest/reference/interactions#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](/rest/reference/orgs#webhooks/). 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](/rest/reference/orgs#get-an-organization)". Pode ser: `nenhum` ou `leitura`. | +| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | Concede acesso à [API de webhooks da organização](/rest/reference/orgs#webhooks/). 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](/rest/reference/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](/rest/reference/projects). Pode ser: `nenhum`, `leitura`, `gravação` ou `admin`. {% 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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/projects). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} -| [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Concede acesso à [API de varredura de segredo](/rest/reference/secret-scanning). Can be one of: `none`, `read`, or `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| [`Páginas`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | Concede acesso à [API de páginas](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/projects). Pode ser: `none`, `read`, `write`, ou `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +| [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Concede acesso à [API de varredura de segredo](/rest/reference/secret-scanning). Pode ser: `none`, `read` ou `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | Concede acesso à [API de varredura de código](/rest/reference/code-scanning/). Pode ser: `nenhum`, `leitura` ou `gravação`.{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Concede acesso à [API de conteúdo](/rest/reference/repos#contents). Pode ser: `nenhum`, `leitura` ou `gravação`. | -| [`estrela`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Concede acesso à [API estrelada](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) e à [API de comentários de discussão de equipe](/rest/reference/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`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Concede acesso à [API de conteúdo](/rest/reference/repos#contents). Pode ser: `nenhum`, `leitura` ou `gravação`. | +| [`estrela`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | Concede acesso à [API estrelada](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) e à [API de comentários de discussão de equipe](/rest/reference/teams#discussion-comments). Pode ser: `none`, `read` ou `write`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `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. Can be one of: `none` or `read`.{% endif %} +| `inspecionando` | Concede acesso à lista e alterações de repositórios que um usuário assinou. Pode ser: `nenhum`, `leitura` ou `gravação`. | ### Eventos webhook do {% data variables.product.prodname_github_app %} 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 82e88f73a256..4f1b8247154b 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 @@ -85,7 +85,7 @@ Ao contrário dos aplicativos OAuth, os aplicativos GitHub têm permissões dire | Aplicativos do GitHub | Aplicativos OAuth | | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Por padrão, os aplicativos GitHub têm um único webhook que recebe os eventos que estão configurados para receber para cada repositório ao qual têm acesso. | Os aplicativos OAuth solicitam o escopo do webhook para criar um webhook do repositório para cada repositório do qual precisam receber eventos. | +| Por padrão, os aplicativos GitHub têm um único webhook que recebe os eventos que estão configurados para receber para cada repositório ao qual têm acesso. | OAuth Apps request the webhook scope to create a repository webhook for each repository they need to receive events from. | | O aplicativo GitHub recebe certos eventos a nível da organização com a permissão do integrante da organização. | Os aplicativos OAuth solicitam o escopo do webhook da organização para criar um webhook da organização para cada organização da qual precisam para receber eventos a nível da organização. | ### Acesso Git 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 b2ab669b8405..c091a91e07de 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 @@ -67,7 +67,7 @@ Se o usuário aceitar o seu pedido, O GitHub irá fazer o redirecionamento para {% endnote %} -Troque este `código` por um token de acesso. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} Quando os tokens com expiração estão habilitados, o token de acesso expira em 8 horas e o token de atualização expira em 6 meses. Toda vez que você atualizar o token, você receberá um novo token de atualização. Para obter mais informações, consulte "[Atualizando tokens de acesso do usuário para servidor](/developers/apps/refreshing-user-to-server-access-tokens)." +Troque este `código` por um token de acesso. {% if currentVersion == "free-pro-team@latest" %} Quando os tokens vencidos estiverem habilitados, 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 obter mais informações, consulte "[Atualizando tokens de acesso do usuário para servidor](/developers/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 %} 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 71e00597caeb..b88c9088c19b 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: Scopes for OAuth Apps +title: Escopos para aplicativos OAuth 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/ @@ -11,19 +11,20 @@ versions: github-ae: '*' --- -When setting up an OAuth App on GitHub, requested scopes are displayed to the user on the authorization form. +Ao configurar um aplicativo OAuth no GitHub, os escopos solicitados são exibidos para o usuário no formulário de autorização. {% note %} -**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/)." +**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/)". {% endnote %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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)." +Se o seu +{% data variables.product.prodname_oauth_app %} não tem acesso a um navegador, como uma ferramenta CLI, você não precisa 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)". {% endif %} -Check headers to see what OAuth scopes you have, and what the API action accepts: +Verifique os cabeçalhos para ver quais escopos do OAuth você tem e o que a ação da API aceita: ```shell $ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre %}/users/codertocat -I @@ -32,53 +33,52 @@ X-OAuth-Scopes: repo, user X-Accepted-OAuth-Scopes: user ``` -* `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 enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} -**`site_admin`** | Grants site administrators access to [{% data variables.product.prodname_ghe_server %} Administration API endpoints](/rest/reference/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](/rest/reference/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@3.0" %} - `security_events` | Grants:
    read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/rest/reference/code-scanning).
    read and write access to security events in the [{% data variables.product.prodname_secret_scanning %} API](/rest/reference/secret-scanning).{% endif %}{% if currentVersion ver_gt "enterprise-server@2.21" and currentVersion ver_lt "enterprise-server@3.1" %} - `security_events` | Grants read and write access to security events in the [{% data variables.product.prodname_code_scanning %} API](/rest/reference/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. Workflow files can expose `GITHUB_TOKEN` which may have a different set of scopes, see https://docs.github.com/en/free-pro-team@latest/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token for details.{% endif %} +* `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 de perfil do usuário público, informações de repositório público e gists){% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} +| **`site_admin`** | Concede acesso de administrador aos pontos de extremidades da API de administração [{% data variables.product.prodname_ghe_server %}](/rest/reference/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](/rest/reference/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@3.0" %} +|  `security_events` | Concede:
    acesso de leitura e gravação para eventos de segurança na [ API de {% data variables.product.prodname_code_scanning %}](/rest/reference/code-scanning).
    acesso de leitura e gravação para eventos de segurança da [ API de {% data variables.product.prodname_secret_scanning %} ](/rest/reference/secret-scanning).{% endif %}{% if currentVersion ver_gt "enterprise-server@2.21" and currentVersion ver_lt "enterprise-server@3.1" %} +|  `security_events` | Concede acesso de leitura e escrita a eventos de segurança na [API {% data variables.product.prodname_code_scanning %}](/rest/reference/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 as discussões de 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` | Liste e visualize informações para as 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. Os arquivos do fluxo de trabalho podem expor `GITHUB_TOKEN` que pode ter um conjunto diferente de escopos. Consulte https://docs.github.com/en/free-pro-team@latest/actions/reference/authentication-in-a-workflow#permissions-for-the-github_token para detalhes.{% 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: +**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: https://github.com/login/oauth/authorize? client_id=...& @@ -86,31 +86,16 @@ can specify multiple scopes by separating them with a space: {% endnote %} -### Requested scopes and granted scopes +### Escopos solicitados e escopos concedidos -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. +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. -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. +É 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. -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. +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. -Check out the [Basics of Authentication guide](/guides/basics-of-authentication/), which -provides tips on handling modifiable token scopes. +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. -### Normalized scopes +### Escopos normalizados -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. +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`. 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 a14fc4a18833..9c2239cf5bf8 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 @@ -7,13 +7,11 @@ versions: free-pro-team: '*' --- -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Observação:** {% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} -{% endif %} ### Suspender um aplicativo GitHub diff --git a/translations/pt-BR/content/developers/apps/using-content-attachments.md b/translations/pt-BR/content/developers/apps/using-content-attachments.md index 3b4914fb4f82..9127a33db2c6 100644 --- a/translations/pt-BR/content/developers/apps/using-content-attachments.md +++ b/translations/pt-BR/content/developers/apps/using-content-attachments.md @@ -166,7 +166,7 @@ Para criar um aplicativo Probot, siga as etapas a seguir: } ``` -4. [Execute o aplicativo GitHub localmente](https://probot.github.io/docs/development/#running-the-app-locally). Navegue até [localhost:3000](http://localhost:3000)e clique no botão **Registrar aplicativo GitHub**: +4. [Execute o aplicativo GitHub localmente](https://probot.github.io/docs/development/#running-the-app-locally). Acesse `http://localhost:3000` e clique no botão **Registrar aplicativo GitHub**: ![Registrar um aplicativo GitHub do Probot](/assets/images/github-apps/github_apps_probot-registration.png) diff --git a/translations/pt-BR/content/developers/github-marketplace/billing-customers.md b/translations/pt-BR/content/developers/github-marketplace/billing-customers.md index 818abf691a95..68b78962c107 100644 --- a/translations/pt-BR/content/developers/github-marketplace/billing-customers.md +++ b/translations/pt-BR/content/developers/github-marketplace/billing-customers.md @@ -33,7 +33,7 @@ Quando um cliente atualiza seu plano de preços ou altera seu ciclo de cobrança {% data reusables.marketplace.marketplace-failed-purchase-event %} -For information about building upgrade and downgrade workflows into your app, see "[Handling plan changes](/developers/github-marketplace/handling-plan-changes)." +Para obter informações sobre a criação fluxos de trabalho de atualização e downgrade no seu aplicativo, consulte "[Gerenciando alterações do plano](/developers/github-marketplace/handling-plan-changes)". #### Downgrades e cancelamentos diff --git a/translations/pt-BR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/pt-BR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index dd9e76aedf45..5ca36850bd1a 100644 --- a/translations/pt-BR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/pt-BR/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -4,6 +4,5 @@ intro: 'Você pode listar ferramentas gratuitas e pagas para os desenvolvedores mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/pt-BR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/pt-BR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index 8e0e8df6b44f..0f21246681ce 100644 --- a/translations/pt-BR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/pt-BR/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -48,7 +48,7 @@ Os clientes podem iniciar uma avaliação gratuita para qualquer plano pago de u Os testes gratuitos têm uma duração fixa de 14 dias. Os clientes são notificados 4 dias antes do final do período de teste (no 11o dia do teste grátis) de que seu plano será atualizado. No final do teste grátis, os clientes serão inscritos automaticamente no plano que estão testando, caso não efetuem o cancelamento. -Para mais informações, consulte: "[Como gerenciar novas compras e testes grátis](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)". +Para mais informações, consulte: "[Como gerenciar novas compras e testes grátis](/developers/github-marketplace/handling-new-purchases-and-free-trials/)". {% note %} diff --git a/translations/pt-BR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/pt-BR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index b85949706e5d..628aed3dd84e 100644 --- a/translations/pt-BR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/pt-BR/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -13,8 +13,14 @@ versions: -Após a sua listagem de {% data variables.product.prodname_marketplace %} for criada e aprovada, você fornecerá as informações de pagamento para {% data variables.product.product_name %} como parte do processo de integração. +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -Uma vez que sua receita atinja, no mínimo, US$ 500. Dólares do mês, você receberá um pagamento eletrônico de {% data variables.product.product_name %} referente a 75% do preço de venda. +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/pt-BR/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/pt-BR/content/developers/github-marketplace/requirements-for-listing-an-app.md index b1f4925f6b57..fc213a86bf66 100644 --- a/translations/pt-BR/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/pt-BR/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -14,7 +14,7 @@ versions: -The requirements for listing an app on {% data variables.product.prodname_marketplace %} vary according to whether you want to offer a free or a paid app. +Os requisitos para a anunciar um aplicativo em {% data variables.product.prodname_marketplace %} variam de acordo com o fato de você desejar oferecer um aplicativo grátis ou pago. ### Requisitos para todos os anúncios de {% data variables.product.prodname_marketplace %} @@ -24,7 +24,7 @@ Todos os anúncios em {% data variables.product.prodname_marketplace %} devem se Todos os anúncios devem atender aos requisitos a seguir, independentemente de serem para um aplicativo grátis ou pago. -- Listings must not actively persuade users away from {% data variables.product.product_name %}. +- Os anúncios não devem persuadir ativamente os usuários para fora de {% data variables.product.product_name %}. - Os anúncios devem incluir informações de contato válidas para o editor. - Os anúncios devem ter uma descrição relevante do aplicativo. - Os anúncios devem especificar um plano de preços. @@ -53,7 +53,7 @@ Além dos requisitos para todos os aplicativos acima, cada aplicativo que você - Os {% data variables.product.prodname_github_app %}s deve ter, no mínimo, 100 instalações. - Os {% data variables.product.prodname_oauth_app %}s devem ter, no mínimo, 200 usuários. - Todos os aplicativos pagos devem lidar com eventos de compra de {% data variables.product.prodname_marketplace %} para novas compras, atualizações, downgrades, cancelamentos e testes grátis. Para obter mais informações, consulte "[Requisitos de cobrança para aplicativos pagos](#billing-requirements-for-paid-apps)" abaixo. -- As organizações publicadoras devem ter um domínio verificado e devem habilitar a autenticação de dois fatores. Para obter 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.") +- As organizações publicadoras devem ter um domínio verificado e devem habilitar a autenticação de dois fatores. Para obter 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)." Quando estiver pronto para publicar o aplicativo em {% data variables.product.prodname_marketplace %}, você deverá solicitar a verificação para o anúncio. diff --git a/translations/pt-BR/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md b/translations/pt-BR/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md index 5c5ade3356d1..724d9292b877 100644 --- a/translations/pt-BR/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md +++ b/translations/pt-BR/content/developers/github-marketplace/setting-pricing-plans-for-your-listing.md @@ -27,7 +27,7 @@ Se desejar vender um aplicativo em {% data variables.product.prodname_marketplac ### Sobre como salvar planos de preços -Você pode salvar planos de preços com status de rascunho ou publicado. If you haven't submitted your {% data variables.product.prodname_marketplace %} listing for approval, a published plan will function in the same way as a draft plan until your listing is approved and shown on {% data variables.product.prodname_marketplace %}. Draft plans allow you to create and save new pricing plans without making them available on your {% data variables.product.prodname_marketplace %} listing page. Depois de publicar um plano de preços em um anúncio publicado, os clientes poderão comprar imediatamente. Você pode publicar até 10 planos de preços. +Você pode salvar planos de preços com status de rascunho ou publicado. Se você não enviou seu anúncio de {% data variables.product.prodname_marketplace %} para aprovação, um plano publicado funcionará da mesma forma que um plano provisório até que o seu anúncio seja aprovado e exibido em {% data variables.product.prodname_marketplace %}. Os planos de rascunho permitem criar e salvar novos planos de preços sem torná-los disponíveis na sua página de anúncio de {% data variables.product.prodname_marketplace %}. Depois de publicar um plano de preços em um anúncio publicado, os clientes poderão comprar imediatamente. Você pode publicar até 10 planos de preços. Para obter diretrizes sobre os clientes de cobrança, consulte "[Clientes de cobrança](/developers/github-marketplace/billing-customers)". @@ -46,23 +46,23 @@ Ao clicar em **Novo rascunho do plano**, você verá um formulário que permite - Você deve solicitar verificação para publicar um anúncio com um plano pago. - {% data reusables.marketplace.marketplace-pricing-free-trials %} - For detailed information, see "[Pricing plans for {% data variables.product.prodname_marketplace %} apps](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)" and "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." + Para obter informações detalhadas, consulte "[Planos de preços para aplicativos de {% data variables.product.prodname_marketplace %}](/developers/github-marketplace/pricing-plans-for-github-marketplace-apps)" e "[Usar a API de {% data variables.product.prodname_marketplace %} no seu aplicativo](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)". -- **Available for** - {% data variables.product.prodname_marketplace %} pricing plans can apply to **Personal and organization accounts**, **Personal accounts only**, or **Organization accounts only**. Por exemplo, se o seu plano de preços for por unidade e fornecer várias estações, você selecionaria **apenas contas de organização**, porque não há nenhuma maneira de atribuir estações a pessoas de uma organização a partir de uma conta pessoal. +- **Disponível para** - planos de preços de {% data variables.product.prodname_marketplace %} podem ser aplicados a **Contas pessoais e da organização**, **apenas contas pessoais**ou **apenas contas de organização**. Por exemplo, se o seu plano de preços for por unidade e fornecer várias estações, você selecionaria **apenas contas de organização**, porque não há nenhuma maneira de atribuir estações a pessoas de uma organização a partir de uma conta pessoal. -- **Short description** - Write a brief summary of the details of the pricing plan. A descrição pode incluir o tipo de cliente para o qual o plano se destina ou os recursos que o plano inclui. +- **Breve descrição** - Escreva um breve resumo dos detalhes do plano de preços. A descrição pode incluir o tipo de cliente para o qual o plano se destina ou os recursos que o plano inclui. -- **Bullets** - You can write up to four bullets that include more details about your pricing plan. Os marcadores podem incluir casos de uso do seu aplicativo ou listar informações mais detalhadas sobre as características ou os recursos incluídos no plano. +- **Marcadores** - Você pode escrever até quatro marcadores que incluem mais detalhes sobre o seu plano de precificação. Os marcadores podem incluir casos de uso do seu aplicativo ou listar informações mais detalhadas sobre as características ou os recursos incluídos no plano. {% data reusables.marketplace.free-plan-note %} ### Alterar um plano de preços da listagem do {% data variables.product.prodname_marketplace %} -If a pricing plan for your {% data variables.product.prodname_marketplace %} listing is no longer needed, or if you need to adjust pricing details, you can remove it. +Se um plano de preços para o seu anúncio de {% data variables.product.prodname_marketplace %} não for mais necessário, ou se você precisar ajustar os detalhes de preços, você poderá removê-lo. ![Botão para remover o seu plano de preços](/assets/images/marketplace/marketplace_remove_this_plan.png) -Once you publish a pricing plan for an app that is already listed in {% data variables.product.prodname_marketplace %}, you can't make changes to the plan. Em vez disso, você precisará remover o plano de preços e criar um novo plano. Os clientes que já compraram o plano de preços removido continuarão a usá-lo até que optem por sair o plano e passar para um novo plano de preços. Para obter mais informações sobre os planos de preços, consulte[ planos de preços do {% data variables.product.prodname_marketplace %}](/marketplace/selling-your-app/github-marketplace-pricing-plans/)". +Depois de publicar um plano de preços para um aplicativo que já está listado em {% data variables.product.prodname_marketplace %}, você não poderá fazer alterações no plano. Em vez disso, você precisará remover o plano de preços e criar um novo plano. Os clientes que já compraram o plano de preços removido continuarão a usá-lo até que optem por sair o plano e passar para um novo plano de preços. Para obter mais informações sobre os planos de preços, consulte[ planos de preços do {% data variables.product.prodname_marketplace %}](/marketplace/selling-your-app/github-marketplace-pricing-plans/)". Depois de remover um plano de preços, os usuários não poderão comprar seu aplicativo que usa esse plano. Os usuários existentes no plano de preços removido continuarão no plano até que cancelem sua assinatura do plano. diff --git a/translations/pt-BR/content/developers/github-marketplace/submitting-your-listing-for-publication.md b/translations/pt-BR/content/developers/github-marketplace/submitting-your-listing-for-publication.md index 9cbf359890d5..3911035dc74b 100644 --- a/translations/pt-BR/content/developers/github-marketplace/submitting-your-listing-for-publication.md +++ b/translations/pt-BR/content/developers/github-marketplace/submitting-your-listing-for-publication.md @@ -22,16 +22,16 @@ Para uma visão geral do processo de criação e envio de uma listagem, consulte ### Pré-requisitos para publicação com verificação -Before you request verification of your listing, you'll need to integrate the {% data variables.product.prodname_marketplace %} billing flows and webhook into your app. Para obter mais informações, consulte "[Usar a API de {% data variables.product.prodname_marketplace %} no seu aplicativo](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)". +Antes de solicitar a verificação do seu anúncio, você precisará integrar os fluxos de cobrança de {% data variables.product.prodname_marketplace %} e webhook no seu aplicativo. Para obter mais informações, consulte "[Usar a API de {% data variables.product.prodname_marketplace %} no seu aplicativo](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)". Se você cumpriu os requisitos para o anúncio integrou-se à API de {% data variables.product.prodname_marketplace %}, envie o seu anúncio. Para obter mais informações, consulte "[Requisitos para listar um app](/developers/github-marketplace/requirements-for-listing-an-app)". {% data reusables.marketplace.app-transfer-to-org-for-verification %} Para informações sobre como fazer isso, consulte: "[Transferir um aplicativo para uma organização antes de enviar](#transferring-an-app-to-an-organization-before-you-submit)" abaixo. -### Transferring an app to an organization before you submit +### Transferir um aplicativo para uma organização antes de enviar -You cannot sell an app that's owned by a user account. You need to transfer the app to an organization that is already a verified creator, or that can request verification for a listing for the app. For details, see: +Você não pode vender um app que pertence a uma conta de usuário. Você precisa transferir o aplicativo para uma organização que já é um criador verificado ou que possa solicitar verificação para um anúncio do aplicativo. Para detalhes, consulte: -1. "[Creating an organization from scratch](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)" +1. "[Criar uma organização do zero](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)" -1. "[Transferring ownership of a GitHub App](/developers/apps/transferring-ownership-of-a-github-app)" or "[Transferring ownership of an OAuth App](/developers/apps/transferring-ownership-of-an-oauth-app)" +1. "[Transferir a propriedade de um aplicativo GitHub](/developers/apps/transferring-ownership-of-a-github-app)" ou "[Transferir a propriedade de um aplicativo OAuth](/developers/apps/transferring-ownership-of-an-oauth-app)" diff --git a/translations/pt-BR/content/developers/github-marketplace/testing-your-app.md b/translations/pt-BR/content/developers/github-marketplace/testing-your-app.md index 0a809eb43ffe..a1747277bd12 100644 --- a/translations/pt-BR/content/developers/github-marketplace/testing-your-app.md +++ b/translations/pt-BR/content/developers/github-marketplace/testing-your-app.md @@ -13,7 +13,7 @@ versions: ### Testar aplicativos -Você pode usar um rascunho de anúncio de {% data variables.product.prodname_marketplace %} para simular cada um dos fluxos de cobrança. Uma listagem com status de rascunho significa que não foi enviada à aprovação. Qualquer compra que você fizer usando uma listagem de rascunho do {% data variables.product.prodname_marketplace %} _não criará_ transações reais e o GitHub não efetuará nenhuma cobrança no seu cartão de crédito. For more information, see "[Drafting a listing for your app](/developers/github-marketplace/drafting-a-listing-for-your-app)" and "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +Você pode usar um rascunho de anúncio de {% data variables.product.prodname_marketplace %} para simular cada um dos fluxos de cobrança. Uma listagem com status de rascunho significa que não foi enviada à aprovação. Qualquer compra que você fizer usando uma listagem de rascunho do {% data variables.product.prodname_marketplace %} _não criará_ transações reais e o GitHub não efetuará nenhuma cobrança no seu cartão de crédito. Para mais informações, consulte "[Elaborar um anúncio para o seu aplicativo](/developers/github-marketplace/drafting-a-listing-for-your-app)" e "[Usar a API de {% data variables.product.prodname_marketplace %} no seu aplicativo](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)". #### Usar um aplicativo de desenvolvimento com uma listagem de rascunho para testar alterações diff --git a/translations/pt-BR/content/developers/overview/index.md b/translations/pt-BR/content/developers/overview/index.md index 12d0387cb430..e390ad2dfcc0 100644 --- a/translations/pt-BR/content/developers/overview/index.md +++ b/translations/pt-BR/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 3985047aa75b..c6fe921e0826 100644 --- a/translations/pt-BR/content/developers/overview/managing-deploy-keys.md +++ b/translations/pt-BR/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ Se você não quiser usar chaves SSH, você poderá usar [HTTPS com tokens do OA * Os usuários não precisam alterar suas configurações SSH locais. * Não são necessários vários tokens (um para cada usuário); um token por servidor é suficiente. * Um token pode ser revogado a qualquer momento, transformando-o, basicamente, em uma senha de uso único. +{% if enterpriseServerVersions contains currentVersion %} * Gerar novos tokens pode ser facilmente programado usando [a API do OAuth](/rest/reference/oauth-authorizations#create-a-new-authorization). +{% endif %} ##### Contras diff --git a/translations/pt-BR/content/developers/overview/viewing-deployment-history.md b/translations/pt-BR/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..1d28c56aa52d --- /dev/null +++ b/translations/pt-BR/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: Visualizar histórico de implantação +intro: Veja as implantações atuais e anteriores para o seu repositório. +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +Você pode entregar implantações através de {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %} e ambientes ou com {% endif %}API REST e aplicativos de terceiros. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Para mais informações sobre {% data variables.product.prodname_actions %}, consulte "[{% data variables.product.prodname_actions %}](/actions) {% endif %}Para obter mais informações sobre implantações com a API REST, consulte "[Repositórios](/rest/reference/repos#deployments)". + +Para visualizar implantações atuais e anteriores, clique em **Ambientes** na página inicial do repositório. ![Ambientes](/assets/images/environments-sidebar.png) + +A página de implantações exibe a última implantação ativa de cada ambiente do seu repositório. Se a implantação inclui uma URL de ambiente, será exibido um botão "Exibir implantação" que vincula à URL ao lado da implantação. + +O registro da atividade mostra o histórico de implantação para seus ambientes. Por padrão, apenas a implantação mais recente para um ambiente tem um status `Ativo`; todas as implantações ativas anteriormente têm um status `Inativo`. Para obter mais informações sobre inativação automática de implantações, consulte "[Implantações inativas](/rest/reference/repos#inactive-deployments)". + +Você também pode usar a API REST para obter informações sobre implantações. Para obter mais informações, consulte "[Repositórios](/rest/reference/repos#deployments)". 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 e58bb7afec86..23b9830e7066 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 @@ -91,7 +91,7 @@ O branch de referência do pull request alterado. |:------------------------- |:--------------------------:|:--------------------------------:| |
    • Pull requests
    | **X** | | - ### Propriedades do objeto do evento +#### Propriedades do objeto do evento {% data reusables.issue-events.issue-event-common-properties %} 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 9061e6ff10ad..8d9c3fea5c5e 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 @@ -72,7 +72,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) 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 ca9d95fbef7b..c5e7d4cd6b2b 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 @@ -430,7 +430,7 @@ Key | Type | Description {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} For more information, see "[Suspending a {% data variables.product.prodname_github_app %} installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." @@ -715,7 +715,7 @@ Key | Type | Description ### package -Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/rest/reference/orgs#blocking)" REST API. For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. +Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. #### Availability @@ -1124,9 +1124,11 @@ Key | Type | Description {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory Activity related to a security advisory. A security advisory provides information about security-related vulnerabilities in software on GitHub. The security advisory dataset also powers the GitHub security alerts, see "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies/)." +{% endif %} #### Availability diff --git a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index c9f15039a84c..b4927a533135 100644 --- a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -13,42 +13,42 @@ Com {% data variables.product.prodname_discussions %}, a comunidade para o seu p - Compartilhar anúncios e informações, recolher feedback, planejar e tomar decisões - Faça perguntas, discuta e responda às perguntas, e marque as discussões como respondidas -- Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows +- Promova uma atmosfera convidativa para visitantes e contribuidores para discutir objetivos, desenvolvimento, administração e fluxos de trabalho -![Discussions tab for a repository](/assets/images/help/discussions/hero.png) +![Aba de discussões para um repositório](/assets/images/help/discussions/hero.png) -You don't need to close a discussion like you close an issue or a pull request. +Você não precisa fechar uma discussão como você fecha um problema ou um pull request. -If a repository administrator or project maintainer enables discussions for a repository, anyone who visits the repository can create and participate in discussions for the repository. Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. 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)". +Se um administrador de repositório ou mantenedor do projeto permitir discussões em um repositório, qualquer pessoa que visitar o repositório poderá criar e participar de discussões para o repositório. Os administradores de repositório e mantenedores de projetos podem gerenciar as discussões e categorias de discussão em um repositório e fixar discussões para aumentar a visibilidade da discussão. Os moderadores e colaboradores podem marcar comentários como respostas, travar discussões e converter problemas em discussões. 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)". -For more information about management of discussions for your repository, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +Para obter mais informações sobre o gerenciamento de discussões para o repositório, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)". -### About categories and formats for discussions +### Sobre categorias e formatos para discussões {% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %} -For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. {% data reusables.discussions.github-recognizes-members %} +Para discussões com um formato de pergunta/resposta, é possível marcar um comentário individual dentro da discussão como a resposta da discussão. {% data reusables.discussions.github-recognizes-members %} -For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +Para obter mais informações, consulte "[Gerenciar categorias para discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)". -### Best practices for discussions +### Melhores práticas para discussões -As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see "[Collaborating with maintainers using discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)." +Como integrante ou mantenedor da comunidade, inicie uma discussão para fazer uma pergunta ou discutir informações que afetem a comunidade. Para obter mais informações, consulte "[Colaborar com mantenedores usando as discussões](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)". -Participate in a discussion to ask and answer questions, provide feedback, and engage with the project's community. For more information, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +Participe de uma discussão para fazer e responder a perguntas, fornecer feedback e envolver-se com a comunidade do projeto. Para obter mais informações, consulte "[Participar de uma discussão](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)". -You can spotlight discussions that contain important, useful, or exemplary conversations among members in the community. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +Você pode destacar discussões que contenham conversas importantes, úteis ou exemplares entre os integrantes da comunidade. Para obter mais informações, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)". -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %} Para obter mais informações, consulte "[Moderar discussões no seu repositório](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)". ### Compartilhando feedback -You can share your feedback about {% data variables.product.prodname_discussions %} with {% data variables.product.company_short %}. To join the conversation, see [`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22). +Você pode compartilhar seus comentários sobre {% data variables.product.prodname_discussions %} com {% data variables.product.company_short %}. Para se juntar à conversa, consulte [`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22). ### Leia mais -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" +- "[Sobre escrita e formatação em {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +- "[Pesquisar discussões](/github/searching-for-information-on-github/searching-discussions)" - "[Sobre notificações](/github/managing-subscriptions-and-notifications-on-github/about-notifications)" - "[Moderar comentários e conversas](/github/building-a-strong-community/moderating-comments-and-conversations)" - "[Mantendo sua segurança no {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" diff --git a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index 828f2145e12a..5f3123e503f9 100644 --- a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md @@ -1,48 +1,48 @@ --- -title: Collaborating with maintainers using discussions -shortTitle: Collaborating with maintainers -intro: You can contribute to the goals, plans, health, and community for a project on {% data variables.product.product_name %} by communicating with the maintainers of the project in a discussion. -permissions: People with read permissions to a repository can start and participate in discussions in the repository. +title: Colaboração com mantenedores usando as discussões +shortTitle: Colaborando com mantenedores +intro: Você pode contribuir para objetivos, planos, saúde e comunidade para um projeto em {% data variables.product.product_name %} comunicando-se com os mantenedores do projeto em uma discussão. +permissions: Pessoas com permissões de leitura em um repositório podem iniciar e participar de discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About collaboration with maintainers using discussions +### Sobre colaboração com mantenedores usando discussões -{% data reusables.discussions.about-discussions %} If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "[‎About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} Se você usar ou contribuir para um projeto, você pode iniciar uma discussão para fazer sugestões e envolver-se com mantenedores e integrantes da comunidade sobre seus planos, dúvidas, ideias e feedback. Para obter mais informações, consulte "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". -{% data reusables.discussions.about-categories-and-formats %} Repository administrators and project maintainers can delete a discussion. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)." +{% data reusables.discussions.about-categories-and-formats %} Os administradores do repositório e mantenedores do projeto podem excluir uma discussão. Para obter mais informações, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)". -{% data reusables.discussions.github-recognizes-members %} These members appear in a list of the most helpful contributors to the project's discussions. As your project grows, you can grant higher access permissions to active members of your community. For more information, see "[Granting higher permissions to top contributors](/discussions/guides/granting-higher-permissions-to-top-contributors)" +{% data reusables.discussions.github-recognizes-members %} Estes membros aparecem em uma lista dos colaboradores mais úteis para as discussões do projeto. À medida que o seu projeto cresce, você pode conceder mais permissões de acesso aos integrantes ativos da sua comunidade. Para obter mais informações, consulte "[Conceder permissões mais elevadas aos melhores contribuidores](/discussions/guides/granting-higher-permissions-to-top-contributors)" -![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) +![Contribuidores mais úteis para discussões para um projeto](/assets/images/help/discussions/most-helpful.png) -For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +Para obter mais informações sobre a participação em discussões, consulte "[Participar de uma discussão](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)". ### Pré-requisitos -To collaborate with maintainers using discussions, a repository administrator or project maintainer must enable discussions for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +Para colaborar com mantenedores usando discussões, um administrador ou mantenedor do projeto deve habilitar discussões para o repositório. Para obter mais informações, consulte "[Habilitar ou desabilitar discussões para um repositório](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository). ". -### Starting a discussion +### Iniciar uma discussão {% data reusables.discussions.starting-a-discussion %} -### Filtering the list of discussions +### Filtrar a lista de discussões -You can search for discussions and filter the list of discussions in a repository. For more information, see "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)." +É possível pesquisar discussões e filtrar a lista de discussões em um repositório. Para obter mais informações, consulte "[Pesquisar discussões](/github/searching-for-information-on-github/searching-discussions)". {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the **Search all discussions** field, type a search query. Optionally, to the right of the search field, click a button to further filter the results. ![Search bar and buttons for filtering discussions](/assets/images/help/discussions/search-and-filter-controls.png) -1. In the list of discussions, click the discussion you want to view. ![Discussion search results](/assets/images/help/discussions/search-result.png) +1. No campo **Pesquisar todas as discussões**, digite uma consulta de pesquisa. Opcionalmente, à direita do campo de pesquisa, clique em um botão para filtrar ainda mais os resultados. ![Barra de pesquisa e botões para filtrar discussões](/assets/images/help/discussions/search-and-filter-controls.png) +1. Na lista de discussões, clique na discussão que você deseja visualizar. ![Resultados da busca de discussões](/assets/images/help/discussions/search-result.png) -### Converting an issue to a discussion +### Converter um problema em uma discussão -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %} Para obter mais informações, consulte "[Moderar discussões no seu repositório](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)". ### Leia mais -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +- "[Sobre escrita e formatação em {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" - "[Mantendo sua segurança no {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)" diff --git a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/index.md b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/index.md index 44aed03c8b9e..2b6d17cac3f0 100644 --- a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/index.md +++ b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/index.md @@ -1,7 +1,7 @@ --- -title: Collaborating with your community using discussions -shortTitle: Collaborating using discussions -intro: Gather and discuss your project with community members and other maintainers. +title: Colaborando com sua comunidade usando discussões +shortTitle: Colaborando usando discussões +intro: Reúna e discuta seu projeto com integrantes da comunidade e outros mantenedores. versions: free-pro-team: '*' --- diff --git a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index 64de4a54960b..d88b78c156bc 100644 --- a/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -1,31 +1,31 @@ --- -title: Participating in a discussion -intro: You can converse with the community and maintainers in a forum within the repository for a project on {% data variables.product.product_name %}. -permissions: People with read permissions to a repository can participate in discussions in the repository. +title: Participando de uma discussão +intro: Você pode conversar com a comunidade e mantenedores em um fórum do repositório para um projeto em {% data variables.product.product_name %}. +permissions: As pessoas com permissões de leitura em um repositório podem participar de discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About participation in a discussion +### Sobre a participação em uma discussão -{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} Para obter mais informações, consulte "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". -In addition to starting or viewing a discussion, you can comment in response to the original comment from the author of the discussion. You can also create a comment thread by replying to an individual comment that another community member made within the discussion, and react to comments with emoji. For more information about reactions, see "[About conversations on {% data variables.product.prodname_dotcom %}](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)." +Além de começar ou visualizar uma discussão, você pode comentar em resposta ao comentário original do autor da discussão. Você também pode criar um tópico de comentário respondendo a um comentário individual feito por outro integrante da comunidade dentro da discussão e reagir aos comentários com emoji. Para obter mais informações sobre reações, consulte "[Sobre conversas em {% data variables.product.prodname_dotcom %}](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)". -You can block users and report disruptive content to maintain a safe and pleasant environment for yourself on {% data variables.product.product_name %}. For more information, see "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)." +Você pode bloquear usuários e reportar conteúdo disruptivo para manter um ambiente seguro e agradável para você mesmo em {% data variables.product.product_name %}. Para obter mais informações, consulte "[Manter sua segurança em {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)". ### Pré-requisitos -Discussions must be enabled for the repository for you to participate in a discussion in the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +As discussões devem ser habilitadas para o repositório para que você possa participar de uma discussão no repositório. Para obter mais informações, consulte "[Habilitar ou desabilitar discussões para um repositório](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository). ". -### Creating a discussion +### Criar uma discussão {% data reusables.discussions.starting-a-discussion %} -### Marking a comment as an answer +### Marcar um comentário como uma resposta -Discussion authors and users with the triage role or greater for a repository can mark a comment as the answer to a discussion in the repository. +Os autores de discussões e usuários com função de triagem ou superior para um repositório podem marcar um comentário como a resposta para uma discussão no repositório. {% data reusables.discussions.marking-a-comment-as-an-answer %} diff --git a/translations/pt-BR/content/discussions/guides/best-practices-for-community-conversations-on-github.md b/translations/pt-BR/content/discussions/guides/best-practices-for-community-conversations-on-github.md index 60b8e1ce37df..c0626e0cc3f5 100644 --- a/translations/pt-BR/content/discussions/guides/best-practices-for-community-conversations-on-github.md +++ b/translations/pt-BR/content/discussions/guides/best-practices-for-community-conversations-on-github.md @@ -1,45 +1,45 @@ --- -title: Best practices for community conversations on GitHub -shortTitle: Best practices for community conversations -intro: 'You can use discussions to brainstorm with your team, and eventually move the conversation to a discussion when you are ready to scope out the work.' +title: Práticas recomendadas para conversas comunitárias no GitHub +shortTitle: Práticas recomendadas para conversas comunitárias +intro: 'Você pode usar discussões para fazer um problema com sua equipe, e, finalmente, mover a conversa para uma discussão quando você estiver pronto para determinar o escopo do trabalho.' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Community conversations in {% data variables.product.prodname_discussions %} +### Conversas comunitárias em {% data variables.product.prodname_discussions %} -Since {% data variables.product.prodname_discussions %} is an open forum, there is an opportunity to bring non-code collaboration into a project's repository and gather diverse feedback and ideas more quickly. You can help drive a productive conversation by: +Como {% data variables.product.prodname_discussions %} é um fórum aberto, há a oportunidade de trazer uma colaboração que não é do código para o repositório de um projeto e coletar diversas sugestões e ideias mais rapidamente. Você pode ajudar a conduzir uma conversa produtiva: -- Asking pointed questions and follow-up questions to garner specific feedback -- Capture a diverse experience and distill it down to main points -- Open an issue to take action based on the conversation, where applicable +- Fazendo pontuais e perguntas complementares para obter feedback específico +- Capturando uma experiência diversificada e até os pontos principais +- Abra um problema para tomar ações com base na conversa, quando aplicável -For more information about opening an issue and cross-referencing a discussion, see "[Opening an issue from a comment](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." +Para mais informações sobre como abrir um problema e fazer referências cruzadas a uma discussão, consulte "[Abrir um problema a partir de um comentário](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)". -### Learning about conversations on GitHub +### Aprender sobre conversas no GitHub -You can create and participate in discussions, issues, and pull requests, depending on the type of conversation you'd like to have. +Você pode criar e participar de discussões, problemas e pull requests, dependendo do tipo de conversa que você gostaria de ter. -You can use {% data variables.product.prodname_discussions %} to discuss big picture ideas, brainstorm, and spike out a project's specific details before committing it to an issue, which can then be scoped. Discussions are useful for teams if: -- You are in the discovery phase of a project and are still learning which director your team wants to go in -- You want to collect feedback from a wider community about a project -- You want to keep bug fixes, feature requests, and general conversations separate +Você pode usar {% data variables.product.prodname_discussions %} para discutir o panorama geral, levantamento de hipóteses e desenvolver detalhes específicos de um projeto antes de vinculá-lo a um problema, que poderá ter o escopo definido. As discussões são úteis para as equipes se: +- Você está na fase de descoberta de um projeto e ainda está aprendendo qual diretor sua equipe quer acessar +- Você deseja coletar comentários de uma comunidade mais ampla sobre um projeto +- Você deseja manter correções de erros, solicitações de recursos e conversas gerais separadas Os problemas são úteis para discutir detalhes específicos de um projeto, como relatórios de erros e melhorias planejadas. Para obter mais informações, consulte "[Sobre problemas](/articles/about-issues)". As pull requests permitem comentar diretamente nas alterações propostas. Para obter mais informações, consulte "[Sobre pull requests](/articles/about-pull-requests)" e "[Comentar em uma pull request](/articles/commenting-on-a-pull-request)". {% data reusables.organizations.team-discussions-purpose %} Para obter mais informações, consulte "[Sobre discussões de equipe](/articles/about-team-discussions)." -### Following contributing guidelines +### Seguir diretrizes de contribuição -Before you open a discussion, check to see if the repository has contributing guidelines. The CONTRIBUTING file includes information about how the repository maintainer would like you to contribute ideas to the project. +Antes de abrir uma discussão, verifique se o repositório tem diretrizes de contribuição. O arquivo CONTRIBUTING inclui informações sobre como o mantenedor do repositório gostaria que você contribuísse com ideias para o projeto. Para obter mais informações, consulte "[Configurando seu projeto para Contribuições Úteis](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)." ### Próximas etapas -To continue learning about {% data variables.product.prodname_discussions %} and quickly create a discussion for your community, see "[Quickstart for {% data variables.product.prodname_discussions %}](/discussions/quickstart)." +Para continuar aprendendo sobre {% data variables.product.prodname_discussions %} e criar rapidamente uma discussão para a sua comunidade, consulte "[Começar rapidamente para {% data variables.product.prodname_discussions %}](/discussions/quickstart). ### Leia mais diff --git a/translations/pt-BR/content/discussions/guides/finding-discussions-across-multiple-repositories.md b/translations/pt-BR/content/discussions/guides/finding-discussions-across-multiple-repositories.md index 418407746cfb..2c3ca53fe407 100644 --- a/translations/pt-BR/content/discussions/guides/finding-discussions-across-multiple-repositories.md +++ b/translations/pt-BR/content/discussions/guides/finding-discussions-across-multiple-repositories.md @@ -1,20 +1,20 @@ --- -title: Finding discussions across multiple repositories -intro: 'You can easily access every discussion you''ve created or participated in across multiple repositories.' +title: Encontrar discussões entre vários repositórios +intro: 'Você pode acessar facilmente todas as discussões que você criou ou participou de vários repositórios.' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Finding discussions +### Encontrar discussões 1. Navegue até o {% data variables.product.prodname_dotcom_the_website %}. -1. In the top-right corner of {% data variables.product.prodname_dotcom_the_website %}, click your profile photo, then click **Your discussions**. !["Your discussions" in drop-down menu for profile photo on {% data variables.product.product_name %}](/assets/images/help/discussions/your-discussions.png) -1. Toggle between **Created** and **Commented** to see the discussions you've created or participated in. +1. No canto superior direito de {% data variables.product.prodname_dotcom_the_website %}, clique na sua foto de perfil e clique em **Suas discussões**. !["Suas discussões" no menu suspenso para a foto de perfil em {% data variables.product.product_name %}](/assets/images/help/discussions/your-discussions.png) +1. Alterne entre **Criada** e **Comentada** para ver as discussões que você criou ou participou. ### Leia mais -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" -- "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" -- "[Managing discussions for your community](/discussions/managing-discussions-for-your-community)" +- "[Pesquisar discussões](/github/searching-for-information-on-github/searching-discussions)" +- "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" +- "[Gerenciar discussões para a sua comunidade](/discussions/managing-discussions-for-your-community)" diff --git a/translations/pt-BR/content/discussions/guides/granting-higher-permissions-to-top-contributors.md b/translations/pt-BR/content/discussions/guides/granting-higher-permissions-to-top-contributors.md index 4b9119fee2e4..8533ad809153 100644 --- a/translations/pt-BR/content/discussions/guides/granting-higher-permissions-to-top-contributors.md +++ b/translations/pt-BR/content/discussions/guides/granting-higher-permissions-to-top-contributors.md @@ -1,6 +1,6 @@ --- -title: Granting higher permissions to top contributors -intro: 'Repository administrators can promote any community member to a moderator and maintainer.' +title: Conceder permissões superiores aos melhores colaboradores +intro: 'Administradores de repositório podem promover qualquer integrante da comunidade a moderador e mantenedor.' versions: free-pro-team: '*' --- @@ -9,24 +9,24 @@ versions: ### Introdução -The most helpful contributors for the past 30 days are highlighted on the {% data variables.product.prodname_discussions %} dashboard, based on how many comments were marked as answers by other community members. Helpful contributors can help drive a healthy community and moderate and guide the community space in addition to maintainers. +Os contribuidores mais úteis dos últimos 30 dias são destacados no painel de {% data variables.product.prodname_discussions %} baseado em quantos comentários foram marcados como respostas de outros integrantes da comunidade. Contribuidores úteis podem ajudar a conduzir uma comunidade saudável e moderada e guiar o espaço da comunidade, além de mantenedores. -### Step 1: Audit your discussions top contributors +### Passo 1: Audite os melhores colaboradores de suas discussões {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. Compare the list of contributors with their access permissions to see who qualifies to moderate the discussion. +1. Compare a lista de contribuidores com suas permissões de acesso para ver quem se qualifica para moderar a discussão. -### Step 2: Review permission levels for discussions +### Passo 2: Revise os níveis de permissão para discussões -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +Pessoas com permissões de triagem para um repositório podem ajudar a moderar as discussões de um projeto marcando comentários como respostas, bloqueando discussões que já não são úteis ou prejudicam a comunidade e convertendo os problemas em discussões quando uma ideia ainda está nos primeiros estágios de desenvolvimento. Para obter mais informações, consulte "[Moderação de discussões](/discussions/managing-discussions-for-your-community/moderating-discussions)". -For more information about repository permission levels and {% data variables.product.prodname_discussions %}, see "[Repository permissions levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." +Para obter mais informações sobre os níveis de permissão do repositório e {% data variables.product.prodname_discussions %}, consulte "[Níveis de permissões do repositório para uma organização](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)". -### Step 3: Change permissions levels for top contributors +### Passo 3: Altere os níveis de permissões para os melhores contribuidores -You can change a contributor's permission levels to give them more access to the tooling they need to moderate GitHub Discussions. To change a person's or team's permission levels, see "[Managing teams and people with access to your repository](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)." +Você pode alterar os níveis de permissão de um contribuidor para dar-lhes mais acesso às ferramentas de que precisam para moderar as discussões no GitHub. Para alterar os níveis de permissão de uma pessoa ou equipe, consulte "[Gerenciar equipes e pessoas com acesso ao seu repositório](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)." -### Step 4: Notify community members of elevated access +### Passo 4: Notifique os integrantes da comunidade sobre acesso elevado -When you change a collaborators permission level, they will receive a notification for the change. +Ao alterar o nível de permissão de colaboradores, eles receberão uma notificação referente à alteração. diff --git a/translations/pt-BR/content/discussions/guides/index.md b/translations/pt-BR/content/discussions/guides/index.md index 287d26a1e84c..d1c30082f1e3 100644 --- a/translations/pt-BR/content/discussions/guides/index.md +++ b/translations/pt-BR/content/discussions/guides/index.md @@ -1,21 +1,21 @@ --- -title: Discussions guides +title: Guias de discussões shortTitle: Guias -intro: 'Discover pathways to get started or learn best practices for participating or monitoring your community''s discussions.' +intro: 'Descubra caminhos para começar ou aprender as práticas recomendadas para participar ou monitorar as discussões da sua comunidade.' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Getting started with discussions +### Introdução às discussões {% link_in_list /about-discussions %} {% link_in_list /best-practices-for-community-conversations-on-github %} {% link_in_list /finding-discussions-across-multiple-repositories %} -### Administering discussions +### Administrando discussões {% link_in_list /granting-higher-permissions-to-top-contributors %} diff --git a/translations/pt-BR/content/discussions/index.md b/translations/pt-BR/content/discussions/index.md index 9925db4e080c..2bdc4547570e 100644 --- a/translations/pt-BR/content/discussions/index.md +++ b/translations/pt-BR/content/discussions/index.md @@ -1,8 +1,8 @@ --- -title: GitHub Discussions Documentation +title: Documentação de discussões do GitHub beta_product: true shortTitle: GitHub Discussions -intro: '{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Community members can ask and answer questions, share updates, have open-ended conversations, and follow along on decisions affecting the community''s way of working.' +intro: '{% data variables.product.prodname_discussions %} é um fórum de comunicação colaborativo para a comunidade sobre um projeto de código aberto. Os integrantes da comunidade podem perguntar e responder a perguntas, compartilhar atualizações, ter conversas abertas e acompanhar decisões que afetam o modo de trabalho da comunidade.' introLinks: quickstart: /discussions/quickstart featuredLinks: @@ -37,19 +37,19 @@ versions: {% assign discussionsCommunityExamples = site.data.variables.discussions_community_examples %} {% if discussionsCommunityExamples %}
    -

    Communities using discussions

    +

    Comunidades que usam discussões

    {% render 'discussions-community-card' for discussionsCommunityExamples as example %}
    {% if discussionsCommunityExamples.length > 6 %} - + {% endif %}
    {% octicon "search" width="24" %}

    Desculpe, não há resultados para

    Parece que não temos um exemplo que se encaixa no seu filtro.
    Tente outro filtro ou adicione seu exemplo de código

    - Add your community {% octicon "arrow-right" %} + Adicione sua comunidade {% octicon "arrow-right" %}
    {% endif %} diff --git a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/index.md b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/index.md index 8ccb2875b2fe..ec30e762d94a 100644 --- a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/index.md +++ b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/index.md @@ -1,7 +1,7 @@ --- -title: Managing discussions for your community -shortTitle: Managing discussions -intro: 'You can enable and configure discussions for your repository, and you can use tools on {% data variables.product.product_name %} to moderate conversations among community members.' +title: Gerenciando discussões para sua comunidade +shortTitle: Gerenciando discussões +intro: 'Você pode habilitar e configurar discussões para o seu repositório e pode usar ferramentas em {% data variables.product.product_name %} para moderar conversas entre os integrantes da comunidade.' versions: free-pro-team: '*' --- diff --git a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md index 39ced19889b9..02d743bdce06 100644 --- a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md +++ b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md @@ -1,56 +1,55 @@ --- -title: Managing categories for discussions in your repository -intro: You can categorize the discussions in your repository to organize conversations for your community members, and you can choose a format for each category. -permissions: Repository administrators and people with write or greater access to a repository can enable discussions in the repository. +title: Gerenciar categorias para discussões no seu repositório +intro: Você pode categorizar as discussões no seu repositório para organizar conversas para integrantes da sua comunidade e você pode escolher um formato para cada categoria. +permissions: Os administradores do repositório e as pessoas com acesso superior ou de gravação a um repositório podem habilitar discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About categories for discussions +### Sobre categorias para discussões {% data reusables.discussions.about-discussions %} {% data reusables.discussions.about-categories-and-formats %} -Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations.{% data reusables.discussions.repository-category-limit %} +Cada categoria deve ter um nome e um pareamento de emojis únicos e pode ser acompanhada de uma descrição detalhada que informa o seu propósito. As categorias ajudam os mantenedores a organizar como as conversas são arquivadas e são personalizáveis para ajudar a distinguir categorias que são Q&A (perguntas e respostas) ou conversas mais abertas.{% data reusables.discussions.repository-category-limit %} -For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +Para obter mais informações, consulte "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)". -### Default categories +### Categorias-padrão -| Categoria | Purpose | Tipo | -|:--------------- |:-------------------------------------------------------------------- |:--------------------- | -| #️⃣ General | Anything and everything relevant to the project | Open-ended discussion | -| 💡Ideas | Ideas to change or improve the project | Open-ended discussion | -| 🙏 Q&A | Questions for the community to answer, with a question/answer format | Question and Answer | -| 🙌 Show and tell | Creations, experiments, or tests relevant to the project | Open-ended discussion | +| Categoria | Finalidade | Tipo | +|:------------------ |:-------------------------------------------------------------------------- |:------------------- | +| #️⃣ Geral | Tudo que for relevante para o projeto | Discussão aberta | +| 💡Ideias | Ideias para alterar ou melhorar o projeto | Discussão aberta | +| 🙏 Q&A | Perguntas para a comunidade responder, com um formato de pergunta/resposta | Pergunta e resposta | +| 🙌 Mostrar e contar | Criações, experimentos ou testes relevantes para o projeto | Discussão aberta | -### Creating a category +### Criar categoria {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.edit-categories %} -1. Click **New category**. !["New category" button above list of discussion categories for a repository](/assets/images/help/discussions/click-new-category-button.png) -1. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." ![Emoji, title, description, and discussion format for new category](/assets/images/help/discussions/edit-category-details.png) -1. Clique em **Criar**. !["Create" button for new category](/assets/images/help/discussions/new-category-click-create-button.png) +1. Clique em **Nova Categoria**. ![Botão "Nova categoria" acima da lista de categorias de discussão para um repositório](/assets/images/help/discussions/click-new-category-button.png) +1. Edite o emoji, título, descrição e formato de discussão para a categoria. Para obter mais informações sobre formatos de discussão, consulte "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)". ![Emoji, título, descrição e formato de discussão para a nova categoria](/assets/images/help/discussions/edit-category-details.png) +1. Clique em **Criar**. ![Botão "Criar" para uma nova categoria](/assets/images/help/discussions/new-category-click-create-button.png) -### Editing a category +### Editar uma categoria -You can edit a category to change the category's emoji, title, description, and discussion format. +Você pode editar uma categoria para alterar o emoji, título, descrição e formato da discussão. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "pencil" aria-label="The pencil icon" %}. ![Edit button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-edit-for-category.png) -1. {% data reusables.discussions.edit-category-details %} -![Editing emoji, title, description, and discussion format for existing category](/assets/images/help/discussions/edit-existing-category-details.png) -1. Clique em **Save changes** (Salvar alterações). !["Save changes" button for existing category](/assets/images/help/discussions/existing-category-click-save-changes-button.png) +1. À direita de uma categoria na lista, clique em {% octicon "pencil" aria-label="The pencil icon" %}. ![Botão de editar à direita da categoria na lista de categorias para um repositório](/assets/images/help/discussions/click-edit-for-category.png) +1. {% data reusables.discussions.edit-category-details %}![Editar emoji, título, descrição e formato de discussão para uma categoria existente](/assets/images/help/discussions/edit-existing-category-details.png) +1. Clique em **Save changes** (Salvar alterações). ![Botão "Salvar as alterações" para a categoria existente](/assets/images/help/discussions/existing-category-click-save-changes-button.png) -### Deleting a category +### Excluir uma categoria -When you delete a category, {% data variables.product.product_name %} will move all discussions in the deleted category to an existing category that you choose. +Ao você excluir uma categoria, {% data variables.product.product_name %} moverá todas as discussões da categoria excluída para uma categoria existente que você escolher. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "trash" aria-label="The trash icon" %}. ![Trash button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-delete-for-category.png) -1. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/choose-new-category.png) -1. Click **Delete & Move**. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/click-delete-and-move-button.png) +1. À direita de uma categoria na lista, clique em {% octicon "trash" aria-label="The trash icon" %}. ![Botão de lixeira à direita da categoria na lista de categorias para um repositório](/assets/images/help/discussions/click-delete-for-category.png) +1. Use o menu suspenso e escolha uma nova categoria para qualquer discussão na categoria que você está excluindo. ![Menu suspenso para escolher nova categoria ao excluir uma categoria existente](/assets/images/help/discussions/choose-new-category.png) +1. Clique em **Excluir & Mover**. ![Menu suspenso para escolher nova categoria ao excluir uma categoria existente](/assets/images/help/discussions/click-delete-and-move-button.png) diff --git a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md index 5332fb059897..d21326f76a13 100644 --- a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md +++ b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md @@ -1,94 +1,94 @@ --- -title: Managing discussions in your repository -intro: You can categorize, spotlight, transfer, or delete the discussions in a repository. -permissions: Repository administrators and people with write or greater access to a repository can manage discussions in the repository. +title: Gerenciar discussões no seu repositório +intro: Você pode categorizar, destacar e transferir ou excluir as discussões de um repositório. +permissions: Os administradores do repositório e as pessoas com acesso superior ou de gravação a um repositório podem gerenciar discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About management of discussions +### Sobre o gerenciamento de discussões -{% data reusables.discussions.about-discussions %} For more information about discussions, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} Para obter mais informações sobre discussões, consulte[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". -Organization owners can choose the permissions required to create a discussion for repositories owned by the organization. For more information, see "[Managing discussion creation for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)." +Os proprietários da organização podem escolher as permissões necessárias para criar uma discussão para repositórios pertencentes à organização. Para obter mais informações, consulte "[Gerenciar a criação de discussões para repositórios na sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)". -As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating a code of conduct or contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)," and "[Setting guidelines for repository contributors](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)." +Como mantenedor de discussões, você pode criar recursos da comunidade para incentivar discussões alinhadas com o objetivo geral do projeto e manter um fórum aberto amigável para os colaboradores. Criar um código de conduta ou diretrizes de contribuição para os colaboradores a seguir ajudará a facilitar um fórum colaborativo e produtivo. Para obter mais informações sobre como criar recursos da comunidade, consulte "[Adicionar um código de conduta ao seu projeto](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" e "[Diretrizes de configuração para contribuidores do repositório](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)". -For more information on facilitating a healthy discussion, see "[Moderating comments and conversations](/github/building-a-strong-community/moderating-comments-and-conversations)." +Para obter mais informações sobre como facilitar uma discussão saudável, consulte "[Moderar comentários e conversas](/github/building-a-strong-community/moderating-comments-and-conversations)". ### Pré-requisitos -To manage discussions in a repository, discussions must be enabled for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +Para gerenciar as discussões em um repositório, as discussões devem ser habilitadas para o repositório. Para obter mais informações, consulte "[Habilitar ou desabilitar discussões para um repositório](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository). ". -### Changing the category for a discussion +### Alterar a categoria para uma discussão -You can categorize discussions to help community members find related discussions. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" article. +Você pode categorizar discussões para ajudar os integrantes da comunidade a encontrar discussões relacionadas. Para obter mais informações, consulte "[Gerenciar categorias de discussões no artigo do seu repositório](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository). -You can also move a discussion to a different category. +Você também pode mover a discussão para uma categoria diferente. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. Na barra lateral direita, clique em {% octicon "pencil" aria-label="The pencil icon" %} **Editar discussão fixada**. !["Fixar discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-edit-pinned-discussion.png) -### Pinning a discussion +### Fixar uma discussão -You can pin up to four important discussions above the list of discussions for the repository. +Você pode fixar até quatro discussões importantes acima da lista de discussões para o repositório. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-pin-discussion.png) -1. Optionally, customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. Na barra lateral direita, clique em {% octicon "pin" aria-label="The pin icon" %} **Fixar discussão**. !["Fixar discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-pin-discussion.png) +1. Opcionalmente, personalize a aparência da discussão fixada. ![Opções de personalização para uma discussão fixada](/assets/images/help/discussions/customize-pinned-discussion.png) +1. Clique em **Fixar discussão**. ![Botão "Fixar discussão" nas opções de personalização para discussão fixada](/assets/images/help/discussions/click-pin-discussion-button.png) -### Editing a pinned discussion +### Editar uma discussão fixada -Editing a pinned discussion will not change the discussion's category. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +Editar uma discussão fixada não irá alterar a categoria da discussão. Para obter mais informações, consulte "[Gerenciar categorias para discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)". {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) -1. Customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. Na barra lateral direita, clique em {% octicon "pencil" aria-label="The pencil icon" %} **Editar discussão fixada**. !["Fixar discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. Personalize a aparência da discussão fixada. ![Opções de personalização para uma discussão fixada](/assets/images/help/discussions/customize-pinned-discussion.png) +1. Clique em **Fixar discussão**. ![Botão "Fixar discussão" nas opções de personalização para discussão fixada](/assets/images/help/discussions/click-pin-discussion-button.png) -### Unpinning a discussion +### Desafixar uma discussão {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion**. !["Unpin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-unpin-discussion.png) -1. Read the warning, then click **Unpin discussion**. !["Unpin discussion" button beneath warning in modal](/assets/images/help/discussions/click-unpin-discussion-button.png) +1. Na barra lateral direita, clique em {% octicon "pin" aria-label="The pin icon" %} **Desafixar discussão**. !["Desafixar discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-unpin-discussion.png) +1. Leia o aviso e clique em **desafixar discussão**. ![Botão "Desafixar discussão" abaixo do aviso em modal](/assets/images/help/discussions/click-unpin-discussion-button.png) -### Transferring a discussion +### Transferir uma discussão -To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion. +Para transferir uma discussão, você precisa ter permissão de criar discussões no repositório, em que você deseja transferir a discussão. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "arrow-right" aria-label="The right arrow icon" %} **Transfer discussion**. !["Transfer discussion" in right sidebar for discussion](/assets/images/help/discussions/click-transfer-discussion.png) -1. Select the **Choose a repository** drop-down, and click the repository you want to transfer the discussion to. !["Choose a repository" drop-down, "Find a repository" search field, and repository in list](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) -1. Click **Transfer discussion**. !["Transfer discussion" button](/assets/images/help/discussions/click-transfer-discussion-button.png) +1. Na barra lateral direita, clique em {% octicon "arrow-right" aria-label="The right arrow icon" %} **Transferir discussão**. !["Transferir discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-transfer-discussion.png) +1. Selecione a lista suspensa **Escolher um repositório** e clique no repositório para o qual deseja transferir a discussão. ![Menu suspenso "Selecionar um repositório" Campo de pesquisar "Encontrar um repositório" e repositório na lista](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) +1. Clique em **Transferir discussão**. ![Botão "Transferir discussão"](/assets/images/help/discussions/click-transfer-discussion-button.png) -### Deleting a discussion +### Excluir uma discussão {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**. !["Delete discussion" in right sidebar for discussion](/assets/images/help/discussions/click-delete-discussion.png) -1. Read the warning, then click **Delete this discussion**. !["Delete this discussion" button beneath warning in modal](/assets/images/help/discussions/click-delete-this-discussion-button.png) +1. Na barra lateral direita, clique em {% octicon "trash" aria-label="The trash arrow icon" %} **Excluir discussão**. !["Excluir discussão" na barra lateral direita para discussão](/assets/images/help/discussions/click-delete-discussion.png) +1. Leia o aviso e clique **Excluir esta discussão**. ![Botão "Excluir esta discussão" abaixo do aviso em modal](/assets/images/help/discussions/click-delete-this-discussion-button.png) -### Converting issues based on labels +### Converter problemas com base em etiquetas -You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure. +Você pode converter todos as etiquetas com a mesma etiqueta para discussões em massa. Os problemas futuros com essa etiqueta também serão automaticamente convertidos em discussão e categoria que você configurar. {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} {% data reusables.project-management.labels %} -1. Next to the label you want to convert to issues, click **Convert issues**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. Ao lado da etiqueta que você deseja converter em problemas, clique em **Converter problemas**. +1. Selecione o menu suspenso **Escolher uma categoria** e clique em uma categoria para a sua discussão. +1. Clique em **Eu entendo. Converta esse problema em uma discussão**. diff --git a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/moderating-discussions.md b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/moderating-discussions.md index 2c91d32d89f6..64a3641496e1 100644 --- a/translations/pt-BR/content/discussions/managing-discussions-for-your-community/moderating-discussions.md +++ b/translations/pt-BR/content/discussions/managing-discussions-for-your-community/moderating-discussions.md @@ -1,39 +1,39 @@ --- -title: Moderating discussions -intro: 'You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, and converting issues to discussions. and editing or deleting comments, discussions, and categories that don''t align with your community''s code of conduct to discussions.' -permissions: People with triage access to a repository can moderate discussions in the repository. +title: Moderar discussões +intro: 'Você pode promover uma colaboração saudável marcando comentários como respostas, bloqueando ou desbloqueando discussões, e convertendo problemas em discussões. e editando ou excluindo comentários, discussões e categorias que não estão alinhadas com o código de conduta da sua comunidade referente às discussões.' +permissions: Pessoas com acesso de triagem a um repositório podem moderar as discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About moderating discussions +### Sobre a moderação de discussões -{% data reusables.discussions.about-discussions %} If you have triage permissions for a repository, you can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. +{% data reusables.discussions.about-discussions %} Se você tiver permissões de triagem para um repositório, você poderá ajudar a moderar as discussões de um projeto marcando comentários como respostas, bloqueando discussões que não são mais úteis ou que prejudicam a comunidade e convertendo os problemas em discussões quando uma ideia ainda está nos primeiros estágios de desenvolvimento. -### Marking a comment as an answer +### Marcar um comentário como uma resposta {% data reusables.discussions.marking-a-comment-as-an-answer %} -### Locking discussions +### Bloquear discussões -It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct or {% data variables.product.prodname_dotcom %}'s [Community Guidelines](/github/site-policy/github-community-guidelines). You can also lock a conversation to prevent comments on a discussion you want to use as an announcement to the community. When you lock a conversation, people with write access to the repository will still be able to comment on the discussion. +É apropriado bloquear uma conversa quando toda a conversa não é construtiva ou quando viola o código de conduta da sua comunidade ou as [Diretrizes da Comunidade](/github/site-policy/github-community-guidelines) de {% data variables.product.prodname_dotcom %}. Você também pode bloquear uma conversa para evitar comentários em uma discussão que você deseja usar como um anúncio para a comunidade. Ao bloquear uma conversa, as pessoas com acesso de gravação ao repositório ainda poderão comentar na discussão. {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the list of discussions, click the discussion you want to lock. ![Lock discussion](/assets/images/help/discussions/unanswered-discussion.png) -1. In the right margin of a discussion, click **Lock conversation**. -1. Read the information about locking conversations and click **Lock conversation on this discussion**. -1. When you're ready to unlock the conversation, click **Unlock conversation**, then click **Unlock conversation on this discussion**. +1. Na lista de discussões, clique na discussão que você deseja bloquear. ![Bloquear discussão](/assets/images/help/discussions/unanswered-discussion.png) +1. Na margem direita de uma discussão, clique em **Bloquear conversa**. +1. Leia as informações sobre bloqueio de conversas e clique em **Bloquear conversa nesta discussão**. +1. Quando estiver pronto para desbloquear a conversa, clique em **Desbloquear conversa** e, em seguida, clique em **desbloquear conversa nesta discussão**. -### Converting an issue to a discussion +### Converter um problema em uma discussão -When you convert an issue to a discussion, the discussion is automatically created using the content from the issue. People with write access to a repository can bulk convert issues based on labels. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +Ao converter um problema em uma discussão, a discussão será criada automaticamente usando o conteúdo do problema. As pessoas com acesso de gravação a um repositório podem fazer a conversão de problemas em massa com base em etquetas. Para obter mais informações, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)". {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} -1. In the list of issues, click the issue you'd like to convert. -1. In the right margin of an issue, click **Convert to discussion**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. Na lista de problemas, clique no problema que deseja converter. +1. Na margem direita de um problema, clique em **Converter em discussão**. +1. Selecione o menu suspenso **Escolher uma categoria** e clique em uma categoria para a sua discussão. +1. Clique em **Eu entendo. Converta esse problema em uma discussão**. diff --git a/translations/pt-BR/content/discussions/quickstart.md b/translations/pt-BR/content/discussions/quickstart.md index c4c65670c72e..bf873d796fa4 100644 --- a/translations/pt-BR/content/discussions/quickstart.md +++ b/translations/pt-BR/content/discussions/quickstart.md @@ -1,6 +1,6 @@ --- -title: Quickstart for GitHub Discussions -intro: 'Enable {% data variables.product.prodname_discussions %} on an existing repository and start conversations with your community.' +title: Início Rápido para Discussões do GitHub +intro: 'Habilite {% data variables.product.prodname_discussions %} em um repositório existente e inicie conversas com sua comunidade.' allowTitleToDifferFromFilename: true versions: free-pro-team: '*' @@ -10,49 +10,49 @@ versions: ### Introdução -{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Discussions are for conversations that need to be transparent and accessible but do not need to be tracked on a project board and are not related to code, unlike issues. Discussions enable fluid, open conversation in a public forum. +{% data variables.product.prodname_discussions %} é um fórum de comunicação colaborativo para a comunidade sobre um projeto de código aberto. As discussões são para conversas que precisam ser transparentes e acessíveis, mas não precisam ser rastreadas em um quadro de projeto e não estão relacionadas ao código, ao contrário dos problemas. As discussões permitem uma conversa fluida e aberta em um fórum público. -Discussions give a space for more collaborative conversations by connecting and giving a more centralized area to connect and find information. +As discussões dão um espaço para conversas mais colaborativas, conectando-se e dando uma área mais centralizada para se conectar e encontrar informações. -### Enabling {% data variables.product.prodname_discussions %} on your repository +### Habilitar {% data variables.product.prodname_discussions %} no seu repositório -Repository owners and people with write access can enable {% data variables.product.prodname_discussions %} for a community on their public repositories. +Os proprietários de repositórios e pessoas com acesso de gravação podem habilitar {% data variables.product.prodname_discussions %} para uma comunidade nos seus repositórios públicos. -When you first enable a {% data variables.product.prodname_discussions %}, you will be invited to configure a welcome post. +Ao habilitar primeiro um {% data variables.product.prodname_discussions %}, você será convidado a configurar uma mensagem de boas-vindas. {% data reusables.repositories.navigate-to-repo %} -1. No nome do seu repositório, clique em {% octicon "gear" aria-label="The gear icon" %} **Configurações**. ![Public settings button](/assets/images/help/discussions/public-repo-settings.png) -1. Under "Features", click **Set up discussions**. ![Set up a discussion button under "Features" for enabling or disabling discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png) -1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community. +1. No nome do seu repositório, clique em {% octicon "gear" aria-label="The gear icon" %} **Configurações**. ![Botão de configurações públicas](/assets/images/help/discussions/public-repo-settings.png) +1. Em "Recursos", clique em **Configurar discussões**. ![Configure um botão de discussão em "Recursos" para habilitar ou desabilitar discussões para um repositório](/assets/images/help/discussions/setup-discussions-button.png) +1. Em "Iniciar uma nova discussão", edite o modelo para que fique alinhado aos recursos e tom que você deseja definir para sua comunidade. 1. Click **Start discussion**. !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png) -### Welcoming contributions to your discussions +### Dar as boas-vindas às contribuições para as suas discussões -You can welcome your community and introduce a new way to communicate in a repository by creating a welcome post and pin the post to your {% data variables.product.prodname_discussions %} page. Pinning and locking discussions helps people know that a post is meant as an announcement. You can use announcements as a way to link people to more resources and offer guidance for opening discussions in your community. For more information about pinning a discussion, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +Você pode dar as boas-vindas à sua comunidade e apresentar uma nova forma de comunicar-se em um repositório, criando um posts de boas-vindas e colocando o post na sua página de {% data variables.product.prodname_discussions %}. Fixar e bloquear discussões ajuda as pessoas a saber que uma publicação é feita como um anúncio. Você pode usar os anúncios como uma forma de vincular pessoas a mais recursos e oferecer orientação para abrir discussões na sua comunidade. Para obter mais informações sobre como fixar uma discussão, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)". -### Setting up community guidelines for contributors +### Configurar diretrizes da comunidade para colaboradores -You can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. You can also update the repository's README to communicate expectations on when collaborators should open an issue or discussion. +Você pode definir diretrizes de contribuição para incentivar os colaboradores a terem conversas significativas e úteis que sejam relevantes para o repositório. Você também pode atualizar o LEIAME do repositório para comunicar as expectativas quando os colaboradores devem abrir um problema ou discussão. -For more information about providing guidelines for your project, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" and "[Setting up your project for healthy contributions](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)." +Para obter mais informações sobre como fornecer diretrizes para o seu projeto, consulte "[Adicionar um código de conduta ao seu projeto](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" e "[Configurar seu projeto para contribuições saudáveis](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)". -### Creating a new discussion +### Criar uma nova discussão -Anyone with access to a repository can create a discussion. +Qualquer pessoa com acesso a um repositório pode criar uma discussão. {% data reusables.discussions.starting-a-discussion %} -### Organizing discussions into relevant categories +### Organizar discussões em categorias relevantes -Repository owners and people with write access can create new categories to keep discussions organized. Collaborators participating and creating new discussions can group discussions into the most relevant existing categories. Discussions can also be recategorized after they are created. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" +Os proprietários dos repositórios e pessoas com acesso de gravação podem criar novas categorias para manter as discussões organizadas. Os colaboradores que participam e criam novas discussões podem agrupar discussões nas categorias existentes mais relevantes. As discussões também podem ser recategorizadas depois que forem criadas. Para obter mais informações, consulte "[Gerenciar categorias para discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" -### Promoting healthy conversations +### Promover conversas saudáveis -People with write permissions for a repository can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +As pessoas com permissões de gravação em um repositório podem ajudar a supervisionar conversas importantes fixando discussões, excluindo discussões que não são mais úteis ou que são prejudiciais para a comunidade e transferindo discussões para repositórios mais relevantes pertencentes à organização. Para obter mais informações, consulte "[Gerenciar discussões no seu repositório](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)". -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +Pessoas com permissões de triagem para um repositório podem ajudar a moderar as discussões de um projeto marcando comentários como respostas, bloqueando discussões que já não são úteis ou prejudicam a comunidade e convertendo os problemas em discussões quando uma ideia ainda está nos primeiros estágios de desenvolvimento. Para obter mais informações, consulte "[Moderação de discussões](/discussions/managing-discussions-for-your-community/moderating-discussions)". ### Próximas etapas -Once there is a clear path to scope work out and move an idea from concept to reality, you can create an issue and start tracking your progress. For more information on creating an issue from a discussion, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +Uma vez traçado um caminho claro para o definir o escopo do trabalho, deve-se concretizar a ideia. você pode criar um problema e começar a acompanhar seu progresso. Para obter mais informações sobre a criação de um problema a partir de uma discussão, consulte "[Moderar discussões](/discussions/managing-discussions-for-your-community/moderating-discussions)". diff --git a/translations/pt-BR/content/education/guides.md b/translations/pt-BR/content/education/guides.md index 4038560b11d0..abf2f33035e8 100644 --- a/translations/pt-BR/content/education/guides.md +++ b/translations/pt-BR/content/education/guides.md @@ -1,44 +1,44 @@ --- -title: Guides for GitHub Education -intro: 'These guides for {% data variables.product.prodname_education %} help you teach and learn both {% data variables.product.product_name %} and software development.' +title: Guias para GitHub Education +intro: 'Estes guias para {% data variables.product.prodname_education %} ajudam você a ensinar e aprender {% data variables.product.product_name %} e desenvolvimento de software.' allowTitleToDifferFromFilename: true versions: free-pro-team: '*' --- -### Get started with {% data variables.product.product_name %} +### Primeiros passos com {% data variables.product.product_name %} -Teachers, students, and researchers can use tools from {% data variables.product.product_name %} to enrich a software development curriculum and develop real-world collaboration skills. +Professores, estudantes e pesquisadores podem usar ferramentas de {% data variables.product.product_name %} para enriquecer um currículo de desenvolvimento de software e desenvolver habilidades de colaboração concretas. -- [Sign up for a new {% data variables.product.prodname_dotcom %} account](/github/getting-started-with-github/signing-up-for-a-new-github-account) -- [Git and {% data variables.product.prodname_dotcom %} quickstart ](/github/getting-started-with-github/quickstart) -- [Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount) -- [Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack) +- [Cadastre-se para uma nova conta de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/signing-up-for-a-new-github-account) +- [Git e início rápido de {% data variables.product.prodname_dotcom %} ](/github/getting-started-with-github/quickstart) +- [Solicitar um desconto de educador ou pesquisador](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount) +- [Aplicar ao pacote de desenvolvedor de aluno](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack) -### Run a software development course with {% data variables.product.company_short %} +### Execute um curso de desenvolvimento software com {% data variables.product.company_short %} -Administer a classroom, assign and review work from your students, and teach the new generation of software developers with {% data variables.product.prodname_classroom %}. +Administrar uma sala de aula, atribuir e revisar o trabalho de seus alunos e ensinar a nova geração de desenvolvedores de software com {% data variables.product.prodname_classroom %}. -- [Basics of setting up {% data variables.product.prodname_classroom %} ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom) -- [Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms) -- [Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment) -- [Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment) -- [Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository) -- [Leave feedback with pull requests](/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests) -- [Use autograding](/education/manage-coursework-with-github-classroom/use-autograding) +- [Fundamentos da configuração de {% data variables.product.prodname_classroom %} ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom) +- [Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms) +- [Criar um trabalho individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment) +- [Criar uma atribuição em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment) +- [Criar uma atividade a partir de um repositório de modelo](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository) +- [Deixar feedback com pull requests](/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests) +- [Usar avaliação automática](/education/manage-coursework-with-github-classroom/use-autograding) -### Learn to develop software +### Aprenda a desenvolver software -Incorporate {% data variables.product.prodname_dotcom %} into your education, and use the same tools as the professionals. +Incorpore {% data variables.product.prodname_dotcom %} na sua educação e use as mesmas ferramentas dos profissionais. -- [Git and {% data variables.product.prodname_dotcom %} learning resources](/github/getting-started-with-github/git-and-github-learning-resources) -- [Use {% data variables.product.prodname_dotcom %} for your schoolwork](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork) -- [Try {% data variables.product.prodname_desktop %}](/desktop) -- [Try {% data variables.product.prodname_cli %}](/github/getting-started-with-github/github-cli) +- [Git e recursos de aprendizagem de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/git-and-github-learning-resources) +- [Use {% data variables.product.prodname_dotcom %} para o seu trabalho na escola](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork) +- [Experimente {% data variables.product.prodname_desktop %}](/desktop) +- [Experimente {% data variables.product.prodname_cli %}](/github/getting-started-with-github/github-cli) -### Contribute to the community +### Contribua para a comunidade -Participate in the community, get training from {% data variables.product.company_short %}, and learn or teach new skills. +Participe da comunidade, receba treinamento de {% data variables.product.company_short %}, e aprenda ou ensine novas habilidades. - [{% data variables.product.prodname_education_community %}](https://education.github.community) - [Sobre Especialistas de campus](/education/teach-and-learn-with-github-education/about-campus-experts) diff --git a/translations/pt-BR/content/education/index.md b/translations/pt-BR/content/education/index.md index c3827df2883b..15ace3db12ce 100644 --- a/translations/pt-BR/content/education/index.md +++ b/translations/pt-BR/content/education/index.md @@ -1,7 +1,7 @@ --- -title: GitHub Education Documentation -shortTitle: Education -intro: "{% data variables.product.prodname_education %} helps you teach or learn software development with the tools and support of {% data variables.product.company_short %}'s platform and community." +title: Documentação do GitHub Education +shortTitle: Educação +intro: "{% data variables.product.prodname_education %} ajuda você a ensinar ou aprender desenvolvimento de software com as ferramentas e suporte da plataforma e comunidade de {% data variables.product.company_short %}." introLinks: quickstart: /education/quickstart featuredLinks: @@ -20,20 +20,20 @@ featuredLinks: - /github/getting-started-with-github/github-cli - /education/manage-coursework-with-github-classroom/teach-with-github-classroom changelog: - - + - title: 'Try something new at Local Hack Day: Learn' date: '2020-10-15' href: https://github.blog/2020-10-15-try-something-new-at-local-hack-day-learn/ - - - title: 'Remote Education: Creating community through shared experiences' + - + title: 'Educação remota: criar comunidade por meio de experiências compartilhadas' date: '2020-09-24' href: https://github.blog/2020-09-24-remote-education-creating-community-through-shared-experiences/ - - - title: 'Remote Education: A series of best practices for online campus communities' + - + title: 'Educação remota: Uma série de práticas recomendadas para comunidades do campus on-line' date: '2020-09-10' href: https://github.blog/2020-09-10-remote-education-a-series-of-best-practices-for-online-campus-communities/ - - - title: Welcome to the inaugural class of MLH Fellows + - + title: Bem-vindo à classe inaugural de MLH Fellows date: '2020-06-24' href: https://github.blog/2020-06-24-welcome-to-the-inaugural-class-of-mlh-fellows/ layout: product-landing diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md index 07d4723dfce1..de0ab7f5d43c 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md @@ -1,31 +1,31 @@ --- -title: About using MakeCode Arcade with GitHub Classroom -shortTitle: About using MakeCode Arcade -intro: You can configure MakeCode Arcade as the online IDE for assignments in {% data variables.product.prodname_classroom %}. +title: Sobre o uso de MakeCode Arcade com GitHub Classroom +shortTitle: Sobre o uso do Arcade MakeCode +intro: Você pode configurar o MakeCode Arcade como o IDE online para atribuições em {% data variables.product.prodname_classroom %}. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-makecode --- -### About MakeCode Arcade +### Sobre o MakeCode Arcade -MakeCode Arcade is an online integrated development environment (IDE) for developing retro arcade games using drag-and-drop block programming and JavaScript. Students can write, edit, run, test, and debug code in a browser with MakeCode Arcade. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +O MakeCode Arcade é um ambiente de desenvolvimento integrado on-line (IDE) para o desenvolvimento de jogos retrô arcade que usa a programação de blocos de arrastar e soltar e JavaScript. Os alunos podem escrever, editar, executar, testar e depurar códigos em um navegador com o MakeCode Arcade. Para obter mais informações sobre IDEs on-line e {% data variables.product.prodname_classroom %}, consulte "[Integrar {% data variables.product.prodname_classroom %} com um IDE on-line](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit MakeCode Arcade, the student must sign into MakeCode Arcade with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on MakeCode Arcade. +A primeira vez que o aluno clica no botão para acessar o MakeCode Arcade, o aluno deve entrar no MakeCode Arcade com as credenciais de {% data variables.product.product_name %}. Após efetuar o login, o aluno terá acesso a um ambiente de desenvolvimento que contém o código do repositório de tarefas, totalmente configurado no MakeCode Arcade. -For more information about working on MakeCode Arcade, see the [MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour) and [documentation](https://arcade.makecode.com/docs) on the MakeCode Arcade website. +Para obter mais informações sobre o trabalho no MakeCode Arcade, consulte a [Tour no MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour) e [documentação](https://arcade.makecode.com/docs) no site do MakeCode Arcade. -MakeCode Arcade does not support multiplayer-editing for group assignments. Instead, students can collaborate with Git and {% data variables.product.product_name %} features like branches and pull requests. +O MakeCode Arcade não é compatível com a edição de multijogador para atividades em grupo. Em vez disso, os alunos podem colaborar com os recursos do Git e de {% data variables.product.product_name %} como branches e pull requests. -### About submission of assignments with MakeCode Arcade +### Sobre o envio das atividades com o MakeCode Arcade -By default, MakeCode Arcade is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with MakeCode Arcade, students should push changes to {% data variables.product.product_location %} using the {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} button at the bottom of the screen. +Por padrão, o MakeCode Arcade está configurado para realizar push no repositório de atividade em {% data variables.product.product_location %}. Após fazer progresso em uma atividade com MakeCode Arcade, os alunos devem fazer push das alterações para {% data variables.product.product_location %} usando o botão {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} na parte inferior da tela. -![MakeCode Arcade version control functionality](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) +![Funcionalidade de controle de versão MakeCode Arcade](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) ### Leia mais -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[Sobre LEIAMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md index b439d2342f97..2a9fef23f6c7 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md @@ -1,33 +1,33 @@ --- -title: About using Repl.it with GitHub Classroom -shortTitle: About using Repl.it -intro: You can configure Repl.it as the online integrated development environment (IDE) for assignments in {% data variables.product.prodname_classroom %}. +title: Sobre o uso do Repl.it com GitHub Classroom +shortTitle: Sobre o uso do Repl.it +intro: Você pode configurar o Repl.it como o ambiente de desenvolvimento integrado on-line (IDE) para tarefas em {% data variables.product.prodname_classroom %}. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-replit --- -### About Repl.it +### Sobre o Repl.it -Repl.it is an online integrated development environment (IDE) that supports multiple programming languages. Students can write, edit, run, test, and debug code in a browser with Repl.it. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +Repl.it é um ambiente de desenvolvimento integrado on-line (IDE) compatível com múltiplas linguagens de programação. Os alunos podem escrever, editar, executar, testar e depurar código em um navegador com o Repl.it. Para obter mais informações sobre IDEs on-line e {% data variables.product.prodname_classroom %}, consulte "[Integrar {% data variables.product.prodname_classroom %} com um IDE on-line](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit Repl.it, the student must sign into Repl.it with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on Repl.it. +A primeira vez que o aluno clica no botão para acessar o Repl.it, o aluno deverá efetuar o login em Repl.it com as credenciais de {% data variables.product.product_name %}. Após efetuar o login, o aluno terá acesso a um ambiente de desenvolvimento que contém o código do repositório de atividades, totalmente configurado no Repl.it. -For more information about working on Repl.it, see the [Repl.it Quickstart Guide](https://docs.repl.it/misc/quick-start#the-repl-environment). +Para obter mais informações sobre como trabalhar no Repl.it, consulte o [Guia de início rápido do Repl.it](https://docs.repl.it/misc/quick-start#the-repl-environment). -For group assignments, students can use Repl.it Multiplayer to work collaboratively. For more information, see the [Repl.it Multiplayer](https://repl.it/site/multiplayer) website. +Em atividades em grupo, os alunos podem usar o Repl.it Multiplayer para trabalhar de forma colaborativa. Para obter mais informações, consulte o site [Repl.it Multiplayer](https://repl.it/site/multiplayer). -### About submission of assignments with Repl.it +### Sobre o envio de atividades com Repl.it -By default, Repl.it is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with Repl.it, students should push changes to {% data variables.product.product_location %} using the version control functionality in the left sidebar. +Por padrão, o Repl-it está configurado para realizar push no repositório de atividade em {% data variables.product.product_location %}. Após fazer progresso em uma atividade com Repl.it, os alunos devem realizar mudanças de push em {% data variables.product.product_location %} usando a funcionalidade de controle de versão na barra lateral esquerda. -![Repl.it version control functionality](/assets/images/help/classroom/ide-replit-version-control-button.png) +![Funcionalidade de controle de versão do Repl.it](/assets/images/help/classroom/ide-replit-version-control-button.png) -For more information about using Git on Repl.it, see the [Repl.it + Git Tutorial](https://repl.it/talk/learn/Replit-Git-Tutorial/23331) on the Repl.it website. +Para obter mais informações sobre o uso do Git no Repl.it, consulte o [Tutorial do Repl.it + Git](https://repl.it/talk/learn/Replit-Git-Tutorial/23331) no site do Repl.it. ### Leia mais -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[Sobre LEIAMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md index 73507c7ec01d..e055802e86cd 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md @@ -1,33 +1,33 @@ --- -title: Basics of setting up GitHub Classroom +title: Fundamentos das configurações do GitHub Classroom shortTitle: 'Noções básicas do {% data variables.product.prodname_classroom %}' -intro: Learn how to set up your classroom, manage assignments, and configure time-saving automation. +intro: Aprenda a configurar sua sala de aula, gerenciar atividades e a configurar automação que economiza tempo. versions: free-pro-team: '*' --- -### Videos about {% data variables.product.prodname_classroom %} +### Vídeos sobre {% data variables.product.prodname_classroom %} -You can watch a series of short video tutorials about the configuration and use of {% data variables.product.prodname_classroom %}. To watch all videos as part of a continuous playlist, see the [{% data variables.product.prodname_classroom %} Getting Started Guide](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u) on YouTube. +Você pode assistir a uma série de tutoriais de vídeos curtos sobre a configuração e o uso de {% data variables.product.prodname_classroom %}. Para assistir a todos os vídeos como parte de uma lista de reprodução contínua, consulte o [{% data variables.product.prodname_classroom %} Guia de Introdução](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u) no YouTube. -For more information about terminology for {% data variables.product.prodname_classroom %}, see "[Glossary](/education/manage-coursework-with-github-classroom/glossary)". +Para obter mais informações sobre a terminologia para {% data variables.product.prodname_classroom %}, consulte "[Glossário](/education/manage-coursework-with-github-classroom/glossary)". -1. Getting started {% octicon "link-external" aria-label="The external link icon" %} -2. Adding your student roster {% octicon "link-external" aria-label="The external link icon" %} -3. Creating assignments - - Creating an assignment using a {% data variables.product.prodname_dotcom %} repository {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Microsoft MakeCode as your online IDE {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Repl.it as your online IDE {% octicon "link-external" aria-label="The external link icon" %} -4. How students complete assignments {% octicon "link-external" aria-label="The external link icon" %} -5. How teachers review assignments {% octicon "link-external" aria-label="The external link icon" %} -6. Creating group assignments {% octicon "link-external" aria-label="The external link icon" %} -7. Next steps to get started {% octicon "link-external" aria-label="The external link icon" %} -8. {% data variables.product.prodname_dotcom %} Teacher Toolbox {% octicon "link-external" aria-label="The external link icon" %} +1. Introdução {% octicon "link-external" aria-label="The external link icon" %} +2. Adicionar a sua lista de alunos {% octicon "link-external" aria-label="The external link icon" %} +3. Criar atividades + - criar uma atividade usando um repositório de {% data variables.product.prodname_dotcom %} {% octicon "link-external" aria-label="The external link icon" %} + - Criar uma atividade usando Microsoft MakeCode como seu IDE on-line {% octicon "link-external" aria-label="The external link icon" %} + - Criar uma atividade usando Repl.it como seu IDE on-line {% octicon "link-external" aria-label="The external link icon" %} +4. Como os alunos concluem as atividades {% octicon "link-external" aria-label="The external link icon" %} +5. Como os professores revisam as atividades {% octicon "link-external" aria-label="The external link icon" %} +6. Criar atividades em grupo {% octicon "link-external" aria-label="The external link icon" %} +7. Próximos passos para começar {% octicon "link-external" aria-label="The external link icon" %} +8. {% data variables.product.prodname_dotcom %} Ferramentas do professor {% octicon "link-external" aria-label="The external link icon" %} ### Próximas etapas -For more information about teaching with {% data variables.product.prodname_classroom %}, see "[Teach with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)." +Para obter mais informações sobre aulas com {% data variables.product.prodname_classroom %}, consulte "[Ensinar com {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)." ### Leia mais -- "[Teach and learn with {% data variables.product.prodname_education %}](/education/teach-and-learn-with-github-education)" +- "[Ensine e aprenda com {% data variables.product.prodname_education %}](/education/teach-and-learn-with-github-education)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md index b9efc84cc3a2..0d9d18eb0f03 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md @@ -1,50 +1,50 @@ --- -title: Configure default settings for assignment repositories -shortTitle: Configure defaults for assignment repositories -intro: You can use the Probot Settings app to configure the default settings for repositories that {% data variables.product.prodname_classroom %} creates for an assignment. -permissions: Organization owners can configure default settings for assignment repositories by installing a {% data variables.product.prodname_github_app %} for the organization. +title: Configurar as configurações-padrão para repositórios de atribuição +shortTitle: Configurar padrões para repositórios de atribuição +intro: Você pode usar o aplicativo de Configurações do Probot para definir as configurações-padrão para repositórios que {% data variables.product.prodname_classroom %} cria para uma atribuição. +permissions: Os proprietários da organização podem definir as configurações-padrão para repositórios de atribuições instalando um {% data variables.product.prodname_github_app %} para a organização. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/probot-settings --- -### About configuration of defaults for assignment repositories +### Sobre a configuração de padrões para repositórios de atribuições -{% data variables.product.prodname_classroom %} creates a repository that belongs for each student or team that accepts an assignment. The repository belongs to the organization that you use for {% data variables.product.prodname_classroom %}. Assignment repositories can be empty, or you can use a template repository. For more information, see "[Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)." +{% data variables.product.prodname_classroom %} cria um repositório que pertence a cada aluno ou equipe que aceita uma atribuição. O repositório pertence à organização que você utiliza para {% data variables.product.prodname_classroom %}. Repositórios de atribuições podem estar vazios ou você pode usar um repositório-modelo. Para obter mais informações, consulte "[Criar uma atribuição a partir de um repositório modelo](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)". {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} -With the Probot Settings app, you can create a file named _.github/settings.yml_ in a repository that contains a list of settings for the repository, and then install a {% data variables.product.prodname_github_app %} for your organization that automatically applies the settings to the repository. +Com o aplicativo de configurações do Probot, você pode criar um arquivo denominado _.github/settings.yml_ em um repositório que contém uma lista de configurações para o repositório e, em seguida, instalar um {% data variables.product.prodname_github_app %} para a sua organização que aplica automaticamente as configurações do repositório. -You can include _.github/settings.yml_ in a template repository that you use for an assignment in {% data variables.product.prodname_classroom %}. When an individual or team accepts the assignment, {% data variables.product.prodname_classroom %} creates the assignment repository, and the Settings app automatically applies the settings from _.github/settings.yml_. +Você pode incluir _.github/settings.yml_ em um repositório de modelo que você usa para uma atribuição em {% data variables.product.prodname_classroom %}. Quando um indivíduo ou equipe aceita a atribuição, {% data variables.product.prodname_classroom %} cria o repositório de atribuições, e o aplicativo de configurações aplica automaticamente as configurações do _.github/settings.yml_. -Probot is a a project, framework, and collection of free apps to automate {% data variables.product.product_name %}. A Probot app can listen to repository events, like the creation of new commits, comments, and issues, and automatically respond to the event. +O Probot é um projeto, estrutura e coleção de aplicativos grátis para automatizar o {% data variables.product.product_name %}. Um aplicativo Probot pode ouvir eventos do repositório, como a criação de novos commits, comentários e problemas, e automaticamente responder ao evento. -For more information, see the [Probot website](https://probot.github.io) and the [Settings app website](https://probot.github.io/apps/settings/). For more information about {% data variables.product.prodname_github_apps %}, see "[About apps](/developers/apps/about-apps)." +Para obter mais informações, consulte o site do Probot [](https://probot.github.io) e o [site de aplicativos configurações](https://probot.github.io/apps/settings/). Para obter mais informações sobre {% data variables.product.prodname_github_apps %}, consulte "[Sobre aplicativos](/developers/apps/about-apps)". -### Adding the Settings app to your organization +### Adicionar o aplicativo de configurações à sua organização -After you install the Probot Settings app for your organization, the app will apply the settings that you define in _.github/settings.yml_ for any repository in your organization, including new assignment repositories that {% data variables.product.prodname_classroom %} creates. +Após instalar o aplicativo de configurações do Probot para sua organização, o aplicativo irá aplicar as configurações que você definir em _.github/settings.yml_ para qualquer repositório na sua organização, incluindo novos repositórios de atribuições que {% data variables.product.prodname_classroom %} cria. -1. Navigate to the [Settings app page](https://github.com/apps/settings). -1. Click **Install**, then click the organization that you use for {% data variables.product.prodname_classroom %}. Provide the app full access to all repositories owned by the organization. ![Installing the Probot Settings app](/assets/images/help/classroom/probot-settings.gif) +1. Navegue até a [página do aplicativo de configurações](https://github.com/apps/settings). +1. Clique em **Instalar** e, em seguida, clique na organização que você usa para {% data variables.product.prodname_classroom %}. Forneça acesso total ao aplicativo para todos os repositórios pertencentes à organização. ![Instalar o aplicativo de configurações Probot](/assets/images/help/classroom/probot-settings.gif) -### Configuring default settings for an assignment repository +### Definir as configurações-padrão para um repositório de atribuição -1. Create a template repository that contains a _.github/settings.yml_ file. For a complete list of settings, see the [README](https://github.com/probot/settings#github-settings) for the `probot/settings` repository. For more information about using a template repository for starter code in {% data variables.product.prodname_classroom %}, see "[Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)." +1. Crie um repositório de modelo que contenha um arquivo _.github/settings.yml_. Para obter uma lista completa de configurações, consulte o [LEIAME](https://github.com/probot/settings#github-settings) para o repositório `probot/settings`. Para obter mais informações sobre o uso de um repositório de modelo para o código inicial em {% data variables.product.prodname_classroom %}, consulte "[Criar uma atribuição a partir de um repositório de modelo](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)". {% warning %} - **Warning:** Do not define `collaborators` in the _.github/settings.yml_ file for your template repository. {% data variables.product.prodname_classroom %} automatically grants teachers and teaching assistants access to assignment repositories. + **Aviso:** Não defina os `colaboradores` no arquivo _.github/settings.yml_ para o repositório de modelo. {% data variables.product.prodname_classroom %} concede automaticamente a professores e assistentes de professores acesso aos repositórios de atribuições. {% endwarning %} -1. Create an assignment using the template repository containing _.github/settings.yml_ as the starter code. {% data reusables.classroom.for-more-information-about-assignment-creation %} +1. Crie uma atribuição usando o repositório de modelo que contém _.github/settings.yml_ como código inicial. {% data reusables.classroom.for-more-information-about-assignment-creation %} -The Probot Settings app for your organization will now apply the settings you define in _.github/settings.yml_ within the template repository to every assignment repository that {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} creates for a student or team. +Agora, o aplicativo de configurações do Probot para sua organização aplicará as configurações que você definir em _.github/settings.yml_ dentro do repositório de modelo para cada repositório de atividade que {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} criar para um aluno ou equipe. ### Leia mais -- [Probot apps](https://probot.github.io/apps/) -- [Probot documentation](https://probot.github.io/docs/) +- [Aplicativos do Probot](https://probot.github.io/apps/) +- [Documentação do Probot](https://probot.github.io/docs/) diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md index 0c728ce14c59..52562fdb5130 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Connect a learning management system to GitHub Classroom -intro: You can configure an LTI-compliant learning management system (LMS) to connect to {% data variables.product.prodname_classroom %} so that you can import a roster for your classroom. +title: Conecte o sistema de gerenciamento de aprendizagem ao GitHub Classroom +intro: Você pode configurar um sistema de gerenciamento de aprendizado compatível com LTI (LMS) para conectar a {% data variables.product.prodname_classroom %} a fim de importar uma lista de participantes para sua sala de aula. versions: free-pro-team: '*' redirect_from: @@ -12,127 +12,163 @@ redirect_from: - /education/manage-coursework-with-github-classroom/setup-moodle --- -### About configuration of your LMS +### Sobre a configuração do seu LMS -You can connect a learning management system (LMS) to {% data variables.product.prodname_classroom %}, and {% data variables.product.prodname_classroom %} can import a roster of student identifiers from the LMS. To connect your LMS to {% data variables.product.prodname_classroom %}, you must enter configuration credentials for {% data variables.product.prodname_classroom %} in your LMS. +Você pode conectar um sistema de gerenciamento de aprendizagem (LMS) a {% data variables.product.prodname_classroom %}, e {% data variables.product.prodname_classroom %} pode importar uma lista de identificadores de aluno do LMS. Para conectar seu LMS a {% data variables.product.prodname_classroom %}, você deve inserir as credenciais de configuração para {% data variables.product.prodname_classroom %} no seu LMS. ### Pré-requisitos -To configure an LMS to connect to {% data variables.product.prodname_classroom %}, you must first create a classroom. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-classroom)." +Para configurar um LMS para conectar-se a {% data variables.product.prodname_classroom %}, primeiro você deve criar uma sala de aula. Para obter mais informações, consulte "[Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-classroom)". -### Supported LMSes +### LMSes compatíveis -{% data variables.product.prodname_classroom %} supports import of roster data from LMSes that implement Learning Tools Interoperability (LTI) standards. +{% data variables.product.prodname_classroom %} é compatível com a importação de dados da lista de LMSes que implementam os padrões de interoperabilidade de ferramentas de aprendizagem (LTI). -- LTI version 1.0 and/or 1.1 -- LTI Names and Roles Provisioning 1.X +- LTI versão 1.0 e/ou 1.1 +- Nomes de LTI e provisionamento de funções 1.X -Using LTI helps keep your information safe and secure. LTI is an industry-standard protocol and GitHub Classroom's use of LTI is certified by the Instructional Management System (IMS) Global Learning Consortium. For more information, see [Learning Tools Interoperability](https://www.imsglobal.org/activity/learning-tools-interoperability) and [About IMS Global Learning Consortium](http://www.imsglobal.org/aboutims.html) on the IMS Global Learning Consortium website. +Usar o LTI ajuda a manter suas informações protegidas e seguras. O LTI é um protocolo padrão do setor e o uso do LTI pelo GitHub Classroom é certificado pelo Sistema de Gerenciamento de Instruções (IMS) Global de Aprendizagem. Para obter mais informações, consulte [Ferramentas de Aprendizagem Interoperabilidade](https://www.imsglobal.org/activity/learning-tools-interoperability) e +Sobre o Consórcio de Aprendizagem Global do IMS.

    -{% data variables.product.company_short %} has tested import of roster data from the following LMSes into {% data variables.product.prodname_classroom %}. +{% data variables.product.company_short %} testou a importação dos dados da lista dos LMSes a seguir em {% data variables.product.prodname_classroom %}. - Canvas - Google Classroom - Moodle - Sakai -Currently, {% data variables.product.prodname_classroom %} doesn't support import of roster data from Blackboard or Brightspace +Atualmente, {% data variables.product.prodname_classroom %} não é compatível com a importação de dados da lista de participantes do Blackboard ou do Brightspace -### Generating configuration credentials for your classroom + + +### Gerar credenciais de configuração para sua sala de aula {% data reusables.classroom.sign-into-github-classroom %} + + + {% data reusables.classroom.click-classroom-in-list %} + + + {% data reusables.classroom.click-students %} -1. If your classroom already has a roster, you can either update the roster or delete the roster and create a new roster. - - For more information about deleting and creating a roster, see "[Deleting a roster for a classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#deleting-a-roster-for-a-classroom)" and "[Creating a roster for your classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)." - - For more information about updating a roster, see "[Adding students to the roster for your classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#adding-students-to-the-roster-for-your-classroom)." -1. In the list of LMSes, click your LMS. If your LMS is not supported, click **Other LMS**. ![List of LMSes](/assets/images/help/classroom/classroom-settings-click-lms.png) -1. Read about connecting your LMS, then click **Connect to _LMS_**. -1. Copy the "Consumer Key", "Shared Secret", and "Launch URL" for the connection to the classroom. ![Copy credentials](/assets/images/help/classroom/classroom-copy-credentials.png) -### Configuring a generic LMS +1. Se sua sala de aula já tiver uma lista, você poderá atualizar a lista ou excluir a lista e criar uma nova lista. + - Para mais informações sobre a exclusão e criação de uma lista, consulte "[Excluir uma lista para uma sala de aula](/education/manage-coursework-with-github-classroom/manage-classrooms#deleting-a-roster-for-a-classroom)" e "[Criar uma lista de participantes para sua sala de aula](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)". + - Para obter mais informações sobre como atualizar uma lista, consulte "[Adicionar alunos à lista para sua sala de aula](/education/manage-coursework-with-github-classroom/manage-classrooms#adding-students-to-the-roster-for-your-classroom)". +1. Na lista de LMSes, clique no seu LMS. Se o seu LMS não for compatível, clique em **Outro LMS**. ![Lista de LMSes](/assets/images/help/classroom/classroom-settings-click-lms.png) + +1. Leia sobre como conectar seu LMS e, em seguida, clique em **Conectar-se ao _LMS_**. + +1. Copie a "Chave do Consumidor", "Segredo Compartilhado" e "Iniciar URL" para a conexão com a sala de aula. ![Copie credenciais](/assets/images/help/classroom/classroom-copy-credentials.png) -You must configure the privacy settings for your LMS to allow external tools to receive roster information. -1. Navigate to your LMS. -1. Configure an external tool. -1. Provide the configuration credentials you generated in {% data variables.product.prodname_classroom %}. - - Consumer key + +### Configurar um LMS genérico + +Você deve configurar as configurações de privacidade para o seu LMS para permitir que as ferramentas externas recebam informações da lista. + +1. Acesse seu LMS. +1. Configure uma ferramenta externa. +1. Forneça as credenciais de configuração geradas em {% data variables.product.prodname_classroom %}. + - Chave do consumidor - Segredo partilhado - - Launch URL (sometimes called "tool URL" or similar) + - Abra a URL (às vezes denominada de "URL da ferramenta" ou similar) + + -### Configuring Canvas +### Configurar o Canvas -You can configure {% data variables.product.prodname_classroom %} as an external app for Canvas to import roster data into your classroom. For more information about Canvas, see the [Canvas website](https://www.instructure.com/canvas/). +Você pode configurar {% data variables.product.prodname_classroom %} como um aplicativo externo para Canvas para importar dados da lista para sua sala de aula. Para obter mais informações sobre o Canvas, consulte o [site do Canvas](https://www.instructure.com/canvas/). -1. Sign into [Canvas](https://www.instructure.com/canvas/#login). -1. Select the Canvas course to integrate with {% data variables.product.prodname_classroom %}. +1. Efetue o login no [Canvas](https://www.instructure.com/canvas/#login). +1. Selecione o curso do Canvas a ser integrado com {% data variables.product.prodname_classroom %}. 1. Na barra lateral esquerda, clique em **Configurações**. -1. Click the **Apps** tab. -1. Click **View app configurations**. +1. Clique na aba **Aplicativos**. +1. Clique **Visualizar configurações de aplicativos**. 1. Click **+App**. -1. Select the **Configuration Type** drop-down menu, and click **By URL**. -1. Paste the configuration credentials from {% data variables.product.prodname_classroom %}. For more information, see "[Generating configuration credentials for your classroom](#generating-configuration-credentials-for-your-classroom)." +1. Selecione o menu suspenso **Tipo de Configuração** e clique em **Por URL**. +1. Cole as credenciais de configuração de {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Gerar credenciais de configuração para sua sala de aula](#generating-configuration-credentials-for-your-classroom)". + + + | Campo na configuração do aplicativo Canvas | Valor ou configuração | + |:----------------------------------------------------------------------------------------------- |:------------------------------------------------------------------------ | + | **Chave de cliente** | Chave do cliente de {% data variables.product.prodname_classroom %} + | **Segredo compartilhado** | Segredo compartilhado de {% data variables.product.prodname_classroom %} + | **Permitir que esta ferramenta acesse os Nomes de IMS e Serviço de Provisionamento de Funções** | Habilitado | + | **URL de configuração** | Acesse a URL a partir de {% data variables.product.prodname_classroom %} + + + {% note %} + + **Observação**: Se você vir ver uma caixa de seleção no Canvas rotulada como "Permitir que esta ferramenta acesse os Nomes do IMS e o Serviço de Provisionamento de Funções", o administrador do Canvas deverá entrar em contato com o suporte do Canvas para habilitar a configuração do serviço de associação para sua conta do Canvas. Sem habilitar este recurso, você não conseguirá sincronizar a lista do Canvas. Para obter mais informações, consulte [Como posso entrar em contato com o suporte Canvas?](https://community.canvaslms.com/t5/Canvas-Basics-Guide/How-do-I-contact-Canvas-Support/ta-p/389767) no site do Canvas. + + {% endnote %} - | Field in Canvas app configuration | Value or setting | - |:------------------------------------------------------------------------- |:------------------------------------------------------------------ | - | **Consumer Key** | Consumer key from {% data variables.product.prodname_classroom %} - | **Shared Secret** | Shared secret from {% data variables.product.prodname_classroom %} - | **Allow this tool to access the IMS Names and Role Provisioning Service** | Enabled | - | **Configuration URL** | Launch URL from {% data variables.product.prodname_classroom %} +1. Clique em **Enviar**. - {% note %} +1. Na barra lateral esquerda, clique em **Página inicial**. +1. Para solicitar que o Canvas envie um e-mail de confirmação, na barra lateral esquerda, clique em **GitHub Classroom**. Siga as instruções no e-mail para terminar de vincular {% data variables.product.prodname_classroom %}. - **Note**: If you don't see a checkbox in Canvas labeled "Allow this tool to access the IMS Names and Role Provisioning Service", then your Canvas administrator must contact Canvas support to enable membership service configuration for your Canvas account. Without enabling this feature, you won't be able to sync the roster from Canvas. For more information, see [How do I contact Canvas Support?](https://community.canvaslms.com/t5/Canvas-Basics-Guide/How-do-I-contact-Canvas-Support/ta-p/389767) on the Canvas website. - {% endnote %} -1. Clique em **Enviar**. -1. In the left sidebar, click **Home**. -1. To prompt Canvas to send a confirmation email, in the left sidebar, click **GitHub Classroom**. Follow the instructions in the email to finish linking {% data variables.product.prodname_classroom %}. - -### Configuring Moodle - -You can configure {% data variables.product.prodname_classroom %} as an activity for Moodle to import roster data into your classroom. For more information about Moodle, see the [Moodle website](https://moodle.org). - -You must be using Moodle version 3.0 or greater. - -1. Sign into [Moodle](https://moodle.org/login/index.php). -1. Select the Moodle course to integrate with {% data variables.product.prodname_classroom %}. -1. Click **Turn editing on**. -1. Wherever you'd like {% data variables.product.prodname_classroom %} to be available in Moodle, click **Add an activity or resource**. -1. Choose **External tool** and click **Add**. -1. In the "Activity name" field, type "GitHub Classroom". -1. In the **Preconfigured tool** field, to the right of the drop-down menu, click **+**. -1. Under "External tool configuration", paste the configuration credentials from {% data variables.product.prodname_classroom %}. For more information, see "[Generating configuration credentials for your classroom](#generating-configuration-credentials-for-your-classroom)." - - | Field in Moodle app configuration | Value or setting | - |:--------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | **Tool name** | {% data variables.product.prodname_classroom %} - _YOUR CLASSROOM NAME_

    **Note**: You can use any name, but we suggest this value for clarity. | - | **Tool URL** | Launch URL from {% data variables.product.prodname_classroom %} - | **LTI version** | LTI 1.0/1.1 | - | **Default launch container** | New window | - | **Consumer key** | Consumer key from {% data variables.product.prodname_classroom %} - | **Segredo partilhado** | Shared secret from {% data variables.product.prodname_classroom %} - -1. Scroll to and click **Services**. -1. To the right of "IMS LTI Names and Role Provisioning", select the drop-down menu and click **Use this service to retrieve members' information as per privacy settings**. -1. Scroll to and click **Privacy**. -1. To the right of **Share launcher's name with tool** and **Share launcher's email with tool**, select the drop-down menus to click **Always**. +### Configurar Moodle + +Você pode configurar {% data variables.product.prodname_classroom %} como uma atividade do Moodle para importar dados da lista para sua sala de aula. Para obter mais informações sobre o Moodle, consulte o [site do Moodle](https://moodle.org). + +Você deve usar a versão 3.0 ou superior do Moodle. + +1. Efetue o login no [Moodle](https://moodle.org/login/index.php). +1. Selecione o curso do Moodle a ser integrado com {% data variables.product.prodname_classroom %}. +1. Clique em **Ativar a edição**. +1. Sempre que você queira que {% data variables.product.prodname_classroom %} esteja disponível no Moodle, clique em **Adicionar uma atividade ou recurso**. +1. Escolha a **Ferramenta externa** e clique em **Adicionar**. +1. No campo "Nome da atividade" digite "Sala de aula do GitHub". +1. No campo **ferramenta pré-configurada**, à direita do menu suspenso, clique em **+**. +1. Em "Configuração da ferramenta externa", cole as credenciais de configuração de {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Gerar credenciais de configuração para sua sala de aula](#generating-configuration-credentials-for-your-classroom)". + + + | Campo na configuração do aplicativo Moodle | Valor ou configuração | + |:------------------------------------------ |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | **Nome da ferramenta** | {% data variables.product.prodname_classroom %} - _YOUR CLASSROOM NAME_

    **Observação**: Você pode usar qualquer nome, mas sugerimos esse valor para maior clareza. | + | **URL da Ferramenta** | Acesse a URL a partir de {% data variables.product.prodname_classroom %} + | **Versão do LTI** | LTI 1.0/1.1 | + | **Contêiner de inicialização padrão** | Nova janela | + | **Chave do consumidor** | Chave do cliente de {% data variables.product.prodname_classroom %} + | **Segredo partilhado** | Segredo compartilhado de {% data variables.product.prodname_classroom %} + + +1. Role para baixo e clique em **Serviços**. + +1. À direita do "Provisionamento de nomes e função de IMS LTI", selecione o menu suspenso e clique em **Usar este serviço para recuperar informações dos integrantes como configurações de privacidade**. +1. Role para baixo e clique em **Privacidade**. +1. À direita de **Compartilhar o nome do lançador com a ferramenta** e **Compartilhar o e-mail do lançador com a ferramenta**, selecione os menus suspensos para clicar em **Sempre**. 1. Na parte inferior da página, clique em **Save changes** (Salvar alterações). -1. In the **Preconfigure tool** menu, click **GitHub Classroom - _YOUR CLASSROOM NAME_**. -1. Under "Common module settings", to the right of "Availability", select the drop-down menu and click **Hide from students**. -1. At the bottom of the page, click **Save and return to course**. -1. Navigate to anywhere you chose to display {% data variables.product.prodname_classroom %}, and click the {% data variables.product.prodname_classroom %} activity. +1. No menu **Pré-configurar a ferramenta**, clique em **GitHub Classroom - _OUR CLASSROOM NAME_**. +1. Em "Configurações comuns do módulo" à direita de "Disponibilidade", selecione o menu suspenso e clique em **Ocultar dos alunos**. +1. Na parte inferior da página, clique em **Salvar e retornar ao curso.**. +1. Acesse qualquer lugar que você escolheu para exibir {% data variables.product.prodname_classroom %}, e clique na atividade de {% data variables.product.prodname_classroom %}. + + + +### Importar uma lista do seu LMS -### Importing a roster from your LMS +Para obter mais informações sobre a importação da lista de participantes do seu LMS para {% data variables.product.prodname_classroom %}, consulte "[Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)". -For more information about importing the roster from your LMS into {% data variables.product.prodname_classroom %}, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)." -### Disconnecting your LMS + +### Desconectar seu LMS {% data reusables.classroom.sign-into-github-classroom %} + + + {% data reusables.classroom.click-classroom-in-list %} + + + {% data reusables.classroom.click-settings %} -1. Under "Connect to a learning management system (LMS)", click **Connection Settings**. !["Connection settings" link in classroom settings](/assets/images/help/classroom/classroom-settings-click-connection-settings.png) -1. Under "Delete Connection to your learning management system", click **Disconnect from your learning management system**. !["Disconnect from your learning management system" button in connection settings for classroom](/assets/images/help/classroom/classroom-settings-click-disconnect-from-your-lms-button.png) + +1. Em "Conectar a um sistema de gerenciamento de aprendizagem (LMS)", clique em **Configurações de conexão**. ![Link "Configurações de conexão" nas configurações da sala de aula](/assets/images/help/classroom/classroom-settings-click-connection-settings.png) + +1. Em "Excluir conexão com o sistema de gerenciamento de aprendizagem", clique em **Desconectar do seu sistema de gerenciamento de aprendizagem**. ![Botão "Desconectar do seu sistema de gerenciamento de aprendizagem" nas configurações de conexão da sala de aula](/assets/images/help/classroom/classroom-settings-click-disconnect-from-your-lms-button.png) diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md index cfc3f7929122..72761cba750a 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md @@ -1,118 +1,118 @@ --- -title: Create a group assignment -intro: 'You can create a collaborative assignment for teams of students who participate in your course.' +title: Criar uma atribuição em grupo +intro: 'Você pode criar uma atribuição colaborativa para equipes de alunos que participam do seu curso.' versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/create-group-assignments --- -### About group assignments +### Sobre atribuições em grupo -{% data reusables.classroom.assignments-group-definition %} Students can work together on a group assignment in a shared repository, like a team of professional developers. +{% data reusables.classroom.assignments-group-definition %} Os alunos podem trabalhar juntos em uma tarefa em grupo em um repositório compartilhado, como uma equipe de desenvolvedores profissionais. -When a student accepts a group assignment, the student can create a new team or join an existing team. {% data variables.product.prodname_classroom %} saves the teams for an assignment as a set. You can name the set of teams for a specific assignment when you create the assignment, and you can reuse that set of teams for a later assignment. +Quando um aluno aceita uma atividade em grupo, o aluno poderá criar uma nova equipe ou juntar-se a uma equipe existente. {% data variables.product.prodname_classroom %} salva as equipes para uma atividade como um conjunto. Você pode nomear o conjunto de equipes para uma atividade específica ao criar a tarefa e você pode reutilizar esse conjunto de equipes para uma atividade futura. {% data reusables.classroom.classroom-creates-group-repositories %} {% data reusables.classroom.about-assignments %} -You can decide how many teams one assignment can have, and how many members each team can have. Each team that a student creates for an assignment is a team within your organization on {% data variables.product.product_name %}. The visibility of the team is secret. Teams that you create on {% data variables.product.product_name %} will not appear in {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Sobre equipes](/github/setting-up-and-managing-organizations-and-teams/about-teams)". +Você pode decidir quantas equipes uma atividade pode ter e quantos integrantes cada equipe pode ter. Cada equipe que um estudante cria para uma atividade é uma equipe dentro da sua organização em {% data variables.product.product_name %}. A visibilidade da equipe é secreta. Equipes criadas em {% data variables.product.product_name %} não aparecerão em {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Sobre equipes](/github/setting-up-and-managing-organizations-and-teams/about-teams)". -For a video demonstration of the creation of a group assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." +Para uma demonstração de vídeo da criação de uma atividade de grupo, consulte "[Fundamentos de configuração de {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)". ### Pré-requisitos {% data reusables.classroom.assignments-classroom-prerequisite %} -### Creating an assignment +### Criar uma atividade {% data reusables.classroom.assignments-guide-create-the-assignment %} -### Setting up the basics for an assignment +### Configurar os fundamentos para uma atividade -Name your assignment, decide whether to assign a deadline, define teams, and choose the visibility of assignment repositories. +Nomeie sua atividade, decida se deseja atribuir um prazo, defina equipes e escolha a visibilidade dos repositórios de atividades. -- [Naming an assignment](#naming-an-assignment) -- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) -- [Choosing an assignment type](#choosing-an-assignment-type) -- [Defining teams for an assignment](#defining-teams-for-an-assignment) -- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) +- [Nomear uma atividade](#naming-an-assignment) +- [Atribuir um prazo para uma atividade](#assigning-a-deadline-for-an-assignment) +- [Escolher um tipo de atividade](#choosing-an-assignment-type) +- [Definir equipes para uma atividade](#defining-teams-for-an-assignment) +- [Escolher uma visibilidade para repositórios de atividades](#choosing-a-visibility-for-assignment-repositories) -#### Naming an assignment +#### Nomear uma atividade -For a group assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the name of the team. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the team's name on {% data variables.product.product_name %} is "student-team", the name of the assignment repository for members of the team will be `assignment-1-student-team`. +Para uma atividade em grupo, {% data variables.product.prodname_classroom %} nomeia repositórios pelo prefixo do repositório e pelo nome da equipe. Por padrão, o prefixo do repositório é o título da atividade. Por exemplo, se você nomear uma atividade "atividade-1" e o nome da equipe em {% data variables.product.product_name %} for "aluno-equipe", o nome do repositório de atividade para os integrantes da equipe será a `atividade-1-aluno-equipe`. {% data reusables.classroom.assignments-type-a-title %} -#### Assigning a deadline for an assignment +#### Atribuir um prazo para uma atividade {% data reusables.classroom.assignments-guide-assign-a-deadline %} -#### Choosing an assignment type +#### Escolher um tipo de atividade -Under "Individual or group assignment", select the drop-down menu, then click **Group assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a individual assignment, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)." +Em "Atividade individual ou em grupo", selecione o menu suspenso e, em seguida, clique em **Atividade em grupo**. Você não pode alterar o tipo de atividade depois de criá-la. Se você preferir criar uma atividade individual, consulte "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)". -#### Defining teams for an assignment +#### Definir equipes para uma atividade -If you've already created a group assignment for the classroom, you can reuse a set of teams for the new assignment. To create a new set with the teams that your students create for the assignment, type the name for the set. Optionally, type the maximum number of team members and total teams. +Se você já criou uma atividade em grupo para a sala de aula, você pode reutilizar um conjunto de equipes para a nova atividade. Para criar um novo conjunto com as equipes que seus alunos criam para a atividade, digite o nome do conjunto. Opcionalmente, digite o número máximo de integrantes e equipes totais. {% tip %} **Dicas**: -- We recommend including details about the set of teams in the name for the set. For example, if you want to use the set of teams for one assignment, name the set after the assignment. If you want to reuse the set throughout a semester or course, name the set after the semester or course. +- Recomendamos incluir detalhes sobre o conjunto de equipes no nome para o conjunto. Por exemplo, se você desejar usar o conjunto de equipes para uma atividade, nomeie o conjunto após a atividade. Se você desejar reutilizar o conjunto ao longo de um semestre ou curso, nomeie o conjunto após o semestre ou curso. -- If you'd like to assign students to a specific team, give your students a name for the team and provide a list of members. +- Se desejar atribuir aos alunos uma equipe específica, dê a seus alunos um nome para a equipe e forneça uma lista de integrantes. {% endtip %} -![Parameters for the teams participating in a group assignment](/assets/images/help/classroom/assignments-define-teams.png) +![Parâmetros para as equipes que participam de uma atividade em grupo](/assets/images/help/classroom/assignments-define-teams.png) -#### Choosing a visibility for assignment repositories +#### Escolher uma visibilidade para repositórios de atividades {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -### Adding starter code and configuring a development environment +### Adicionar código inicial e configurar um ambiente de desenvolvimento {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [Choosing a template repository](#choosing-a-template-repository) -- [Choosing an online integrated development environment (IDE)](#choosing-an-online-integrated-development-environment-ide) +- [Escolher um repositório de modelo](#choosing-a-template-repository) +- [Escolher um ambiente de desenvolvimento integrado on-line (IDE)](#choosing-an-online-integrated-development-environment-ide) -#### Choosing a template repository +#### Escolher um repositório de modelo -By default, a new assignment will create an empty repository for each team that a student creates. {% data reusables.classroom.you-can-choose-a-template-repository %} For more information about template repositories, see "[Creating a template repository](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)." +Por padrão, uma nova atividade criará um repositório vazio para cada equipe criada por um aluno. {% data reusables.classroom.you-can-choose-a-template-repository %} Para obter mais informações sobre repositórios de modelos, consulte "[Criar um repositório de modelo](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)". {% data reusables.classroom.assignments-guide-choose-template-repository %} -#### Choosing an online integrated development environment (IDE) +#### Escolher um ambiente de desenvolvimento integrado on-line (IDE) -{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." +{% data reusables.classroom.about-online-ides %} Para obter mais informações, consulte "[Integrar {% data variables.product.prodname_classroom %} com um IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." {% data reusables.classroom.assignments-guide-choose-an-online-ide %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -### Providing feedback +### Fornecer feedback -Optionally, you can automatically grade assignments and create a space for discussing each submission with the team. +Opcionalmente, você pode classificar automaticamente as atividades e criar um espaço para discutir cada envio com a equipe. -- [Testing assignments automatically](#testing-assignments-automatically) -- [Preventing changes to important files](#preventing-changes-to-important-files) -- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) +- [Testar recomendações automaticamente](#testing-assignments-automatically) +- [Evitar alterações em arquivos importantes](#preventing-changes-to-important-files) +- [Criar um pull request para feedback](#creating-a-pull-request-for-feedback) -#### Testing assignments automatically +#### Testar recomendações automaticamente {% data reusables.classroom.assignments-guide-using-autograding %} -#### Preventing changes to important files +#### Evitar alterações em arquivos importantes {% data reusables.classroom.assignments-guide-prevent-changes %} -#### Creating a pull request for feedback +#### Criar um pull request para feedback {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -120,26 +120,26 @@ Optionally, you can automatically grade assignments and create a space for discu {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -### Inviting students to an assignment +### Convidar alunos para uma atividade {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -You can see the teams that are working on or have submitted an assignment in the **Teams** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %} +Você pode ver as equipes que estão trabalhando ou que enviaram uma atividade na aba **Equipes** para a atividade. {% data reusables.classroom.assignments-to-prevent-submission %}
    - Group assignment + Atividade em grupo
    ### Próximas etapas -- After you create the assignment and your students form teams, team members can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and the team can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Creating, cloning, and archiving repositories](/github/creating-cloning-and-archiving-repositories)," "[Using Git](/github/using-git)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)," and the free course on [managing merge conflicts](https://lab.github.com/githubtraining/managing-merge-conflicts) from {% data variables.product.prodname_learning %}. +- Após criar a atividade e seus alunos formarem equipes, os integrantes da equipe poderão começar a trabalhar nas atividades usando os recursos do Git e do {% data variables.product.product_name %}. Os alunos podem clonar o repositório, realizar commits de push, gerenciar branches, criar e revisar pull requests, resolver conflitos de merge e discutir alterações com problemas. Tanto você como a equipe podem revisar o histórico de commit do repositório. Para obter mais informações, consulte "[Primeiros passos com com {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github), "[Criar, clonar e arquivar repositórios](/github/creating-cloning-and-archiving-repositories)," "[Usar Git](/github/using-git), e "[Colaborar com problemas e pull requests](/github/collaborating-with-issues-and-pull-requests), e o curso livre sobre [gestão de conflitos de merge](https://lab.github.com/githubtraining/managing-merge-conflicts) de {% data variables.product.prodname_learning %}. -- When a team finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand how the team collaborated. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." +- Quando uma equipe termina uma atividade, você poderá revisar os arquivos no repositório, ou você poderá revisar o histórico e as visualizações do repositório para entender melhor como a equipe colaborou. Para obter mais informações, consulte "[Visualizar dados do repositório com gráficos](/github/visualizing-repository-data-with-graphs)". -- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." +- Você pode fornecer comentários para uma atividade, comentando em commits individuais ou em linhas em um pull request. Para obter mais informações, consulte "[Comentando em um pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" e "[Abrir um problema a partir do código](/github/managing-your-work-on-github/opening-an-issue-from-code)". Para obter mais informações sobre a criação de respostas salvas para fornecer feedback sobre erros comuns, consulte "[Sobre respostas salvas](/github/writing-on-github/about-saved-replies)". ### Leia mais -- "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" -- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" -- [Using Existing Teams in Group Assignments?](https://education.github.community/t/using-existing-teams-in-group-assignments/6999) in the {% data variables.product.prodname_education %} Community +- "[Use {% data variables.product.prodname_dotcom %} na sua sala de aula e pesquise](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" +- "[Conecte um sistema de gerenciamento de aprendizagem para {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" +- [Usar Equipes Existentes atividades em grupo?](https://education.github.community/t/using-existing-teams-in-group-assignments/6999) na comunidade de {% data variables.product.prodname_education %} diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md index fe5659bca573..27aa2b130689 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md @@ -1,19 +1,19 @@ --- -title: Create an assignment from a template repository -intro: You can create an assignment from a template repository to provide starter code, documentation, and other resources to your students. +title: Criar uma atividade a partir de um repositório de modelo +intro: Você pode criar uma atividade a partir de um repositório de modelo para fornecer código inicial, documentação e outros recursos aos seus alunos. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/using-template-repos-for-assignments --- -You can use a template repository on {% data variables.product.product_name %} as starter code for an assignment on {% data variables.product.prodname_classroom %}. Your template repository can contain boilerplate code, documentation, and other resources for your students. Para obter mais informações, consulte "[Criar um repositório de modelos](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)". +Você pode utilizar um repositório de modelo em {% data variables.product.product_name %} como código inicial para uma atividade em {% data variables.product.prodname_classroom %}. Seu repositório modelo pode conter código-padrão, documentação e outros recursos para seus alunos. Para obter mais informações, consulte "[Criar um repositório de modelos](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)". -To use the template repository for your assignment, the template repository must be owned by your organization, or the visibility of the template repository must be public. +Para usar o repositório de modelo para a sua atribuição, o repositório de modelo deve pertencer à sua organização, ou a visibilidade do repositório de modelos deverá ser pública. -{% data reusables.classroom.you-may-want-to-predefine-repository-settings %} For more information, see "[Configure default settings for assignment repositories](/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories)." +{% data reusables.classroom.you-may-want-to-predefine-repository-settings %} Para obter mais informações, consulte "[Definir as configurações-padrão para repositórios de atividades](/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories)". ### Leia mais -- "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" -- "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)" +- "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" +- "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md index c24274ef5c3a..efe820827254 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md @@ -1,6 +1,6 @@ --- -title: Create an individual assignment -intro: You can create an assignment for students in your course to complete individually. +title: Criar um trabalho individual +intro: Você pode criar uma atividade para os alunos do seu curso para ser concluída individualmente. versions: free-pro-team: '*' redirect_from: @@ -8,7 +8,7 @@ redirect_from: - /education/manage-coursework-with-github-classroom/create-an-individual-assignment --- -### About individual assignments +### Sobre atividades individuais {% data reusables.classroom.assignments-individual-definition %} @@ -16,83 +16,83 @@ redirect_from: {% data reusables.classroom.about-assignments %} -For a video demonstration of the creation of an individual assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." +Para uma demonstração vídeo da criação de uma atividade individual, consulte "[Fundamentos da configuração de {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)". ### Pré-requisitos {% data reusables.classroom.assignments-classroom-prerequisite %} -### Creating an assignment +### Criar uma atividade {% data reusables.classroom.assignments-guide-create-the-assignment %} -### Setting up the basics for an assignment +### Configurar os fundamentos para uma atividade -Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories. +Nomeie sua atividade, decida se deseja atribuir um prazo e escolha a visibilidade dos repositórios de atividades. -- [Naming an assignment](#naming-an-assignment) -- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) -- [Choosing an assignment type](#choosing-an-assignment-type) -- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) +- [Nomear uma atividade](#naming-an-assignment) +- [Atribuir um prazo para uma atividade](#assigning-a-deadline-for-an-assignment) +- [Escolher um tipo de atividade](#choosing-an-assignment-type) +- [Escolher uma visibilidade para repositórios de atividades](#choosing-a-visibility-for-assignment-repositories) -#### Naming an assignment +#### Nomear uma atividade -For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be `assignment-1-octocat`. +Para uma atividade individual, {% data variables.product.prodname_classroom %} nomeia os repositórios pelo prefixo do repositório e pelo nome de usuário de {% data variables.product.product_name %} do aluno. Por padrão, o prefixo do repositório é o título da atividade. Por exemplo, se você nomear uma atividade como "assignment-1" e o nome de usuário do aluno em {% data variables.product.product_name %} for @octocat, o nome do repositório de atividade para @octocat será `assignment-1-octocat`. {% data reusables.classroom.assignments-type-a-title %} -#### Assigning a deadline for an assignment +#### Atribuir um prazo para uma atividade {% data reusables.classroom.assignments-guide-assign-a-deadline %} -#### Choosing an assignment type +#### Escolher um tipo de atividade -Under "Individual or group assignment", select the drop-down menu, and click **Individual assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +Em "Tarefa individual ou de grupo", selecione o menu suspenso e clique em **Tarefa individual**. Você não pode alterar o tipo de atividade depois de criá-la. Se você preferir criar uma atividade em grupo, consulte "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". -#### Choosing a visibility for assignment repositories +#### Escolher uma visibilidade para repositórios de atividades {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -### Adding starter code and configuring a development environment +### Adicionar código inicial e configurar um ambiente de desenvolvimento {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [Choosing a template repository](#choosing-a-template-repository) -- [Choosing an online integrated development environment (IDE)](#choosing-an-online-integrated-development-environment-ide) +- [Escolher um repositório de modelo](#choosing-a-template-repository) +- [Escolher um ambiente de desenvolvimento integrado on-line (IDE)](#choosing-an-online-integrated-development-environment-ide) -#### Choosing a template repository +#### Escolher um repositório de modelo -By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %} For more information about template repositories, see "[Creating a template repository](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)." +Por padrão, uma nova atividade criará um repositório vazio para cada aluno na lista da sala de aula. {% data reusables.classroom.you-can-choose-a-template-repository %} Para obter mais informações sobre repositórios de modelos, consulte "[Criar um repositório de modelo](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)". {% data reusables.classroom.assignments-guide-choose-template-repository %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -#### Choosing an online integrated development environment (IDE) +#### Escolher um ambiente de desenvolvimento integrado on-line (IDE) -{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." +{% data reusables.classroom.about-online-ides %} Para obter mais informações, consulte "[Integrar {% data variables.product.prodname_classroom %} com um IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." {% data reusables.classroom.assignments-guide-choose-an-online-ide %} -### Providing feedback for an assignment +### Fornecer feedback para uma atividade -Optionally, you can automatically grade assignments and create a space for discussing each submission with the student. +Opcionalmente, você pode classificar automaticamente as atividades e criar um espaço para discutir cada envio com o aluno. -- [Testing assignments automatically](#testing-assignments-automatically) -- [Preventing changes to important files](#preventing-changes-to-important-files) -- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) +- [Testar recomendações automaticamente](#testing-assignments-automatically) +- [Evitar alterações em arquivos importantes](#preventing-changes-to-important-files) +- [Criar um pull request para feedback](#creating-a-pull-request-for-feedback) -#### Testing assignments automatically +#### Testar recomendações automaticamente {% data reusables.classroom.assignments-guide-using-autograding %} -#### Preventing changes to important files +#### Evitar alterações em arquivos importantes {% data reusables.classroom.assignments-guide-prevent-changes %} -#### Creating a pull request for feedback +#### Criar um pull request para feedback {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -100,25 +100,25 @@ Optionally, you can automatically grade assignments and create a space for discu {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -### Inviting students to an assignment +### Convidar alunos para uma atividade {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -You can see whether a student has joined the classroom and accepted or submitted an assignment in the **All students** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %} +Você pode ver se um aluno juntou-se à sala de aula e aceitou ou enviou uma atividade na aba **Todos os alunos** da atividade. {% data reusables.classroom.assignments-to-prevent-submission %}
    - Individual assignment + Atividade individual
    ### Próximas etapas -- Once you create the assignment, students can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Creating, cloning, and archiving repositories](/github/creating-cloning-and-archiving-repositories)," "[Using Git](/github/using-git)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)." +- Depois de criar a atividade, os alunos poderão começar a trabalhar na atividade usando os recursos do Git e do {% data variables.product.product_name %}. Os alunos podem clonar o repositório, realizar commits de push, gerenciar branches, criar e revisar pull requests, resolver conflitos de merge e discutir alterações com problemas. Você e o aluno podem revisar o histórico do commit do repositório. Para obter mais informações, consulte "[Primeiros passos com {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Criar, clonar e arquivar repositórios](/github/creating-cloning-and-archiving-repositories)", "[Usar o Git](/github/using-git)" e "[Colaborar com problemas e pull requests](/github/collaborating-with-issues-and-pull-requests)". -- When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." +- Quando um aluno concluir uma atividade, você poderá revisar os arquivos no repositório ou você poderá revisar o histórico e as visualizações do repositório para entender melhor o trabalho do aluno. Para obter mais informações, consulte "[Visualizar dados do repositório com gráficos](/github/visualizing-repository-data-with-graphs)". -- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." +- Você pode fornecer comentários para uma atividade, comentando em commits individuais ou em linhas em um pull request. Para obter mais informações, consulte "[Comentando em um pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" e "[Abrir um problema a partir do código](/github/managing-your-work-on-github/opening-an-issue-from-code)". Para obter mais informações sobre a criação de respostas salvas para fornecer feedback sobre erros comuns, consulte "[Sobre respostas salvas](/github/writing-on-github/about-saved-replies)". ### Leia mais -- "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" -- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" +- "[Use {% data variables.product.prodname_dotcom %} na sua sala de aula e pesquise](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" +- "[Conecte um sistema de gerenciamento de aprendizagem para {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md index f0b63a9f9882..f59e245cc197 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md @@ -1,7 +1,7 @@ --- -title: Get started with GitHub Classroom +title: Primeiros passos com o GitHub Classroom shortTitle: Começar -intro: Learn how to configure and use {% data variables.product.prodname_classroom %} to administer your course. +intro: Aprenda a configurar e usar {% data variables.product.prodname_classroom %} para administrar seu curso. mapTopic: true versions: free-pro-team: '*' diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/glossary.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/glossary.md index c78d452507fe..c037e1d57bac 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/glossary.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/glossary.md @@ -1,49 +1,49 @@ --- title: Glossário -intro: You can review explanations of terminology for {% data variables.product.prodname_classroom %}. +intro: Você pode revisar as explicações de terminologia para {% data variables.product.prodname_classroom %}. versions: free-pro-team: '*' --- ### atividade -An assignment is coursework in {% data variables.product.prodname_classroom %}. A teacher can assign an assignment to an individual student or a group of students. Teachers can import starter code for the assignment, assign students, and create a deadline for each assignment. For more information, see the definitions for "[individual assignment](#individual-assignment)" and "[group assignment](#group-assignment)." +Uma atividade é um curso em {% data variables.product.prodname_classroom %}. Um professor pode atribuir uma atividade a um aluno ou a um grupo de alunos. Os professores podem importar o código inicial para a atividade, atribuir alunos e criar um prazo para cada atividade. Para obter mais informações, consulte as definições para "[atividade individual](#individual-assignment)" e "[atividade em grupo](#group-assignment)". --- -### classroom +### sala de aula -A classroom is the basic unit of {% data variables.product.prodname_classroom %}. Teachers can use a classroom to organize and manage students, teaching assistants, and assignments for a single course. A classroom belongs to an organization on {% data variables.product.prodname_dotcom_the_website %}. To administer a classroom, you must be an organization owner for the organization on {% data variables.product.prodname_dotcom %}. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." +Uma sala de aula é a unidade básica de {% data variables.product.prodname_classroom %}. Os professores podem usar uma sala de aula para organizar e gerenciar alunos, professores e recomendações de curso único. Uma sala de aula pertence a uma organização em {% data variables.product.prodname_dotcom_the_website %}. Para administrar uma sala de aula, você precisa ser o proprietário da organização para a organização em {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms)". --- ### {% data variables.product.prodname_classroom %} -{% data variables.product.prodname_classroom %} is a web application for educators that provides course administration tools integrated with {% data variables.product.prodname_dotcom %}. For more information, see the [{% data variables.product.prodname_classroom %}](https://classroom.github.com/) website. +{% data variables.product.prodname_classroom %} é um aplicativo da web para educadores que fornece ferramentas de administração do curso integradas a {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte o site [{% data variables.product.prodname_classroom %}](https://classroom.github.com/). --- -### group assignment +### atividade em grupo -{% data reusables.classroom.assignments-group-definition %} For more information, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +{% data reusables.classroom.assignments-group-definition %} Para obter mais informações, consulte "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". --- -### identifier +### identificador -An identifier in {% data variables.product.prodname_classroom %} is a unique ID for a student participating in a course. For example, an identifier can be a student name, alphanumeric ID, or email address. +Um identificador em {% data variables.product.prodname_classroom %} é um ID exclusivo para um aluno que participa de um curso. Por exemplo, um identificador pode ser um nome de aluno, um ID alfanumérico ou endereço de e-mail. --- -### individual assignment +### atividade individual -{% data reusables.classroom.assignments-individual-definition %} For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)." +{% data reusables.classroom.assignments-individual-definition %} Para obter mais informações, consulte "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)". --- -### roster +### lista -A roster allows a teacher to manage students and assignment submissions in a classroom on {% data variables.product.prodname_classroom %}. Teachers can create a roster by entering a list of student identifiers, or by connecting {% data variables.product.prodname_classroom %} to a learning management system (LMS). For more information about identifiers, see the definition of "[identifier](#identifier)." For more information about connecting {% data variables.product.prodname_classroom %} to an LMS, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." +Uma lista permite que um professor gerencie os alunos e os envios de atividades em uma sala de aula em {% data variables.product.prodname_classroom %}. Os professores podem criar uma lista de participantes inserindo uma lista de identificadores dos alunos, ou conectando {% data variables.product.prodname_classroom %} a um sistema de gerenciamento de aprendizagem (LMS). Para obter mais informações sobre identificadores, consulte a definição de "[identificador](#identifier)". Para obter mais informações sobre conexão de {% data variables.product.prodname_classroom %} com um LMS, consulte "[Conectar um sistema de gerenciamento de aprendizado a {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)". --- diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/index.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/index.md index 681061bf6155..59e8df2aa159 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/index.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/index.md @@ -1,7 +1,7 @@ --- -title: Manage coursework with GitHub Classroom +title: Gerencie o curso com GitHub Classroom shortTitle: '{% data variables.product.prodname_classroom %}' -intro: With {% data variables.product.prodname_classroom %}, you can use {% data variables.product.product_name %} to administer or participate in a course about software development. +intro: Com {% data variables.product.prodname_classroom %}, você pode usar {% data variables.product.product_name %} para administrar ou participar de um curso sobre desenvolvimento de software. versions: free-pro-team: '*' --- diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md index f4245ea67232..c5cb51c22f9e 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md @@ -1,7 +1,7 @@ --- -title: Integrate GitHub Classroom with an IDE -shortTitle: Integrate with an IDE -intro: You can help your students write, test, and debug code by preconfiguring a development environment for assignment repositories on {% data variables.product.prodname_classroom %}. +title: Integrar GitHub Classroom com um IDE +shortTitle: Integrar com um IDE +intro: Você pode ajudar seus alunos a escrever, testar e depurar código, pré-configurando um ambiente de desenvolvimento para repositórios de atividades em {% data variables.product.prodname_classroom %}. mapTopic: true versions: free-pro-team: '*' diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md index 6b4b6b52713b..64a9156c39cb 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md @@ -1,42 +1,42 @@ --- -title: Integrate GitHub Classroom with an online IDE -shortTitle: Integrate with an online IDE -intro: You can preconfigure a supported online integrated development environment (IDE) for assignments you create in {% data variables.product.prodname_classroom %}. +title: Integrar GitHub Classroom com um IDE on-line +shortTitle: Integrar com um IDE on-line +intro: Você pode pré-configurar um ambiente de desenvolvimento integrado on-line (IDDE) compatível com recomendações que você cria em {% data variables.product.prodname_classroom %}. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/online-ide-integrations --- -### About integration with an online IDE +### Sobre a integração com um IDE on-line {% data reusables.classroom.about-online-ides %} -After a student accepts an assignment with an online IDE, the README file in the student's assignment repository will contain a button to open the assignment in the IDE. The student can begin working immediately, and no additional configuration is necessary. +Depois que um aluno aceitar uma atividade com um IDE on-line, o arquivo LEIAME no repositório de atividades do aluno conterá um botão para abrir a atividade no IDE. O aluno pode começar a trabalhar imediatamente, e nenhuma configuração adicional será necessária. -![Button for online IDE in README.md for assignment repository](/assets/images/help/classroom/assignment-repository-ide-button-in-readme.png) +![Botão para IDE on-line no README.md para repositório de atividade](/assets/images/help/classroom/assignment-repository-ide-button-in-readme.png) -### Supported online IDEs +### IDEs on-line compatíveis -{% data variables.product.prodname_classroom %} supports the following online IDEs. You can learn more about the student experience for each IDE. +{% data variables.product.prodname_classroom %} é compatível com os seguintes IDEs on-line. Você pode aprender mais sobre a experiência do aluno para cada IDE. -| IDE | Mais informações | -|:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Microsoft MakeCode Arcade | "[About using MakeCode Arcade with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom)" | -| Repl.it | "[About using Repl.it with GitHub Classroom](/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom)" | +| IDE | Mais informações | +|:------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Microsoft MakeCode Arcade | "[Sobre o uso do Arcade MakeCode com {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom)" | +| Repl.it | "[Sobre o uso do Repl.it com GitHub Classroom](/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom)" | -### Configuring an online IDE for an assignment +### Configurar um IDE on-line para uma atividade -You can choose the online IDE you'd like to use for an assignment when you create an assignment. To learn how to create a new assignment that uses an online IDE, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +Você poderá escolher o IDE on-line que gostaria de usar para uma atividade ao criar uma atividade. Para aprender a criar uma nova atividade que utiliza um ID on-line, consulte "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" ou "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". -### Authorizing the OAuth app for an online IDE +### Autorizar o aplicativo OAuth para um IDE on-line -The first time you configure an assignment with an online IDE, you must authorize the OAuth app for the online IDE for your organization. +A primeira vez que você configurar uma tarefa com um ID on-line, você deverá autorizar o aplicativo OAuth para o IDE on-line para sua organização. -!["Go grant access" button in popover for authorizing OAuth app for online IDE](/assets/images/help/classroom/assignment-ide-go-grant-access-button.png) +![Botão "Conceder acesso" no popover para autorizar o aplicativo OAuth para IDE on-line](/assets/images/help/classroom/assignment-ide-go-grant-access-button.png) -For all repositories, grant the app **read** access to metadata, administration, and code, and **write** access to administration and code. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps)". +Para todos os repositórios, conceda acesso de **leitura** do aplicativo aos metadados, administração, código e acesso de **gravação** à administração e código. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps)". ### Leia mais -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[Sobre LEIAMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md index bca115034607..c7c47cf63cc0 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Learn with GitHub Classroom -intro: You can participate in coursework in {% data variables.product.prodname_classroom %} and see results from your teacher. +title: Aprenda com GitHub Classroom +intro: Você pode participar do curso em {% data variables.product.prodname_classroom %} e visualizar os resultados do seu professor. mapTopic: true versions: free-pro-team: '*' diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index 59132bd74593..1ab756f606fb 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -1,31 +1,31 @@ --- -title: Leave feedback with pull requests -intro: You can leave feedback for your students in a special pull request within the repository for each assignment. -permissions: People with read permissions to a repository can leave feedback in a pull request for the repository. +title: Deixar feedback com pull requests +intro: É possível deixar feedback para seus alunos em um pull request especial dentro do repositório para cada atividade. +permissions: Pessoas com permissões de leitura em um repositório podem deixar o feedback em um pull request para o repositório. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/leaving-feedback-in-github --- -### About feedback pull requests for assignments +### Sobre solicitações de feedback de pull requests para atividades {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} -When you enable the pull request for feedback for an assignment, {% data variables.product.prodname_classroom %} will create a special pull request titled **Feedback** in the assignment repository for each student or team. The pull request automatically shows every commit that a student pushed to the assignment repository's default branch. +Ao habilitar o pull request para feedback em uma atribuição, {% data variables.product.prodname_classroom %} criará um pull request intitulada **Feedback** no repositório de atividade para cada aluno ou equipe. O pull request mostra automaticamente a cada commit que um aluno fez push para o branch padrão do repositório de atividade. ### Pré-requisitos -To create and access the feedback pull request, you must enable the feedback pull request when you create the assignment. {% data reusables.classroom.for-more-information-about-assignment-creation %} +Para criar e acessar o pull request de feedback, você deve habilitar o pull request de feedback ao criar a atividade. {% data reusables.classroom.for-more-information-about-assignment-creation %} -### Leaving feedback in a pull request for an assignment +### Dar feedback em um pull request para uma atividade {% data reusables.classroom.sign-into-github-classroom %} -1. In the list of classrooms, click the classroom with the assignment you want to review. ![Classroom in list of classrooms for an organization](/assets/images/help/classroom/click-classroom-in-list.png) +1. Na lista de salas de aula, clique na sala de aula com a atividade que você deseja revisar. ![Sala de aula na lista de salas de aula de uma organização](/assets/images/help/classroom/click-classroom-in-list.png) {% data reusables.classroom.click-assignment-in-list %} -1. To the right of the submission, click **Review**. ![Review button for assignment in list of submissions for an assignment](/assets/images/help/classroom/assignments-click-review-button.png) -1. Review the pull request. Para obter mais informações, consulte "[Comentando em uma pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)." +1. À direita do envio, clique em **Revisar**. ![Botão de revisão para a atividade na lista de envios para uma atividade](/assets/images/help/classroom/assignments-click-review-button.png) +1. Revise o pull request. Para obter mais informações, consulte "[Comentando em uma pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)." ### Leia mais -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[Integre {% data variables.product.prodname_classroom %} com um IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/manage-classrooms.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/manage-classrooms.md index 08cd6cc2f26e..505b06b61c24 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/manage-classrooms.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/manage-classrooms.md @@ -1,106 +1,106 @@ --- -title: Manage classrooms -intro: You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}. -permissions: Organization owners can manage a classroom for an organization. +title: Gerenciar salas de aula +intro: Você pode criar e gerenciar uma sala de aula para cada curso que você der usando {% data variables.product.prodname_classroom %}. +permissions: Os proprietários da organização podem gerenciar uma sala de aula para uma organização. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/archive-a-classroom --- -### About classrooms +### Sobre as salas de aula {% data reusables.classroom.about-classrooms %} -![Classroom](/assets/images/help/classroom/classroom-hero.png) +![Sala de aula](/assets/images/help/classroom/classroom-hero.png) -### About management of classrooms +### Sobre o gerenciamento de salas de aula -{% data variables.product.prodname_classroom %} uses organization accounts on {% data variables.product.product_name %} to manage permissions, administration, and security for each classroom that you create. Each organization can have multiple classrooms. +{% data variables.product.prodname_classroom %} usa contas da organização em {% data variables.product.product_name %} para gerenciar permissões, administração e segurança para cada sala de aula que você criar. Cada organização pode ter várias salas de aula. -After you create a classroom, {% data variables.product.prodname_classroom %} will prompt you to invite teaching assistants (TAs) and admins to the classroom. Each classroom can have one or more admins. Admins can be teachers, TAs, or any other course administrator who you'd like to have control over your classrooms on {% data variables.product.prodname_classroom %}. +Depois de criar uma sala de aula, {% data variables.product.prodname_classroom %} solicitará que você convide assistentes de ensino (ETI) e administradores para a sala de aula. Cada sala de aula pode ter um ou mais administradores. Os administradores podem ser professores, TAs ou qualquer outro administrador do curso o qual que você gostaria que tivesse controle das suas salas de aula em {% data variables.product.prodname_classroom %}. -Invite TAs and admins to your classroom by inviting the user accounts on {% data variables.product.product_name %} to your organization as organization owners and sharing the URL for your classrom. Organization owners can administer any classroom for the organization. For more information, see "[Permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)" and "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." +Convide TAs e administradores para a sua sala de aula, convidando as contas de usuário em {% data variables.product.product_name %} para a sua organização como proprietários e compartilhando a URL da sua sala de aula. Os proprietários da organização podem administrar qualquer sala de aula da organização. 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)" e "[Convidar usuários a participar da sua organização](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)". -When you're done using a classroom, you can archive the classroom and refer to the classroom, roster, and assignments later, or you can delete the classroom if you no longer need the classroom. +Ao terminar de usar uma sala de aula, você pode arquivar a sala de aula e consultar a sala de aula, lista, e recomendações posteriormente, ou você pode excluir a sala de aula se não precisar mais dela. -### About classroom rosters +### Sobre as listas de salas de aula -Each classroom has a roster. A roster is a list of identifiers for the students who participate in your course. +Cada sala de aula tem uma lista. Uma lista é uma lista de identificadores para os alunos que participam do seu curso. -When you first share the URL for an assignment with a student, the student must sign into {% data variables.product.product_name %} with a user account to link the user account to an identifier for the classroom. After the student links a user account, you can see the associated user account in the roster. You can also see when the student accepts or submits an assignment. +A primeira vez que você compartilha a URL de uma atividade com um estudante, o aluno precisa efetuar o login em {% data variables.product.product_name %} com uma conta de usuário para vincular a conta do usuário a um identificador da sala de aula. Depois que o aluno vincular uma conta de usuário, você poderá ver a conta de usuário associada na lista. Você também pode ver quando o aluno aceita ou envia uma atividade. -![Classroom roster](/assets/images/help/classroom/roster-hero.png) +![Lista de salas de aula](/assets/images/help/classroom/roster-hero.png) ### Pré-requisitos -You must have an organization account on {% data variables.product.product_name %} to manage classrooms on {% data variables.product.prodname_classroom %}. For more information, see "[Types of {% data variables.product.company_short %} accounts](/github/getting-started-with-github/types-of-github-accounts#organization-accounts)" and "[Creating a new organization from scratch](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)." +Você precisa ter uma conta de organização em {% data variables.product.product_name %} para gerenciar as salas de aula em {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Tipos de contas de {% data variables.product.company_short %}](/github/getting-started-with-github/types-of-github-accounts#organization-accounts)" e "[Criar uma nova organização do zero](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)". -You must authorize the OAuth app for {% data variables.product.prodname_classroom %} for your organization to manage classrooms for your organization account. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps)". +Você deve autorizar o aplicativo OAuth {% data variables.product.prodname_classroom %} para sua organização gerenciar salas de aula para sua conta da organização. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps)". -### Creating a classroom +### Criar uma sala de aula {% data reusables.classroom.sign-into-github-classroom %} -1. Click **New classroom**. !["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png) +1. Clique em **Nova sala de aula**. ![Botão "Nova sala de aula"](/assets/images/help/classroom/click-new-classroom-button.png) {% data reusables.classroom.guide-create-new-classroom %} -After you create a classroom, you can begin creating assignments for students. For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +Depois de criar uma sala de aula, você pode começar a criar atividades para os alunos. Para obter mais informações, consulte "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" ou "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". -### Creating a roster for your classroom +### Criando uma lista para sua sala de aula -You can create a roster of the students who participate in your course. +Você pode criar uma lista de alunos que participam do seu curso. -If your course already has a roster, you can update the students on the roster or delete the roster. For more information, see "[Adding a student to the roster for your classroom](#adding-students-to-the-roster-for-your-classroom)" or "[Deleting a roster for a classroom](#deleting-a-roster-for-a-classroom)." +Se o seu curso já tem uma lista, você pode atualizar os alunos na lista ou excluir a lista. Para mais informações consulte "[Adicionar um aluno à lista de participantes para sua sala de aula](#adding-students-to-the-roster-for-your-classroom)" ou "[Excluir uma lista para uma sala de aula](#deleting-a-roster-for-a-classroom)." {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. To connect {% data variables.product.prodname_classroom %} to your LMS and import a roster, click {% octicon "mortar-board" aria-label="The mortar board icon" %} **Import from a learning management system** and follow the instructions. For more information, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." !["Import from a learning management system" button](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png) -1. To create a roster manually, type your student identifiers. Optionally, click **Upload a CSV or text file** to upload a file containing the identifiers. ![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png) -1. Click **Create roster**. !["Create roster" button](/assets/images/help/classroom/click-create-roster-button.png) +1. Para conectar {% data variables.product.prodname_classroom %} ao seu LMS e importar uma lista, clique em {% octicon "mortar-board" aria-label="The mortar board icon" %} **Importar de um sistema de gerenciamento de aprendizagem** e siga as instruções. Para obter mais informações, consulte "[Conectar um sistema de gerenciamento de aprendizagem a {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)". ![Botão "Importar de um sistema de gerenciamento de aprendizagem"](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png) +1. Para criar uma lista manualmente, digite os identificadores do aluno. Opcionalmente, clique em **Enviar um arquivo CSV ou de texto** para fazer upload de um arquivo que contém os identificadores. ![Campo de texto para digitar identificadores de aluno e botão "Fazer upload de um arquivo CSV ou texto"](/assets/images/help/classroom/type-or-upload-student-identifiers.png) +1. Clique **Criar lista**. ![Botão "Criar lista"](/assets/images/help/classroom/click-create-roster-button.png) -### Adding students to the roster for your classroom +### Adicionar alunos à lista de participantes para sua sala de aula -Your classroom must have an existing roster to add students to the roster. For more information about creating a roster, see "[Creating a roster for your classrom](#creating-a-roster-for-your-classroom)." +A sua sala de aula precisa ter uma lista existente para adicionar alunos à lista. Para obter mais informações sobre como criar uma lista, consulte "[Criar uma lista de participantes para sua sala de aula](#creating-a-roster-for-your-classroom)." {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. To the right of "Classroom roster", click **Update students**. !["Update students" button to the right of "Classroom roster" heading above list of students](/assets/images/help/classroom/click-update-students-button.png) -1. Follow the instructions to add students to the roster. - - To import students from an LMS, click **Sync from a learning management system**. For more information about importing a roster from an LMS, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." - - To manually add students, under "Manually add students", click **Upload a CSV or text file** or type the identifiers for the students, then click **Add roster entries**. ![Modal for choosing method of adding students to classroom](/assets/images/help/classroom/classroom-add-students-to-your-roster.png) +1. À direita do "Lista de sala de aula", clique em **Atualizar alunos**. ![Botão "Atualizar os alunos" à direita de "lista de salas de aula" destacando-se acima da lista de alunos](/assets/images/help/classroom/click-update-students-button.png) +1. Siga as instruções para adicionar alunos à lista. + - Para importar os alunos de um LMS, clique em **Sincronizar a partir de um sistema de gerenciamento de aprendizagem**. Para obter mais informações sobre a importação de uma lista de participantes de um LMS, consulte "[Conectar um sistema de gerenciamento de aprendizagem a {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)". + - Para adicionar alunos manualmente, em "Adicionar alunos manualmente", clique em **Enviar um arquivo CSV ou de texto** ou digite os identificadores para os alunos e, em seguida, clique em **Adicionar entradas da lista**. ![Modal para escolher o método de adicionar os alunos à sala de aula](/assets/images/help/classroom/classroom-add-students-to-your-roster.png) -### Renaming a classroom +### Renomear uma sala de aula {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} -1. Under "Classroom name", type a new name for the classroom. ![Text field under "Classroom name" for typing classroom name](/assets/images/help/classroom/settings-type-classroom-name.png) -1. Click **Rename classroom**. !["Rename classroom" button](/assets/images/help/classroom/settings-click-rename-classroom-button.png) +1. Em "Nome da sala de aula", digite um novo nome para a sala de aula. ![Campo de texto em "Nome da sala de aula" para digitar o nome da sala de aula](/assets/images/help/classroom/settings-type-classroom-name.png) +1. Clique em **Renomear sala de aula**. ![Botão "Renomear sala de aula"](/assets/images/help/classroom/settings-click-rename-classroom-button.png) -### Archiving or unarchiving a classroom +### Arquivar ou desarquivar uma sala de aula -You can archive a classroom that you no longer use on {% data variables.product.prodname_classroom %}. When you archive a classroom, you can't create new assignments or edit existing assignments for the classroom. Students can't accept invitations to assignments in archived classrooms. +Você pode arquivar uma sala de aula que você não usa mais em {% data variables.product.prodname_classroom %}. Ao arquivar uma sala de aula, não é possível criar novas atividades ou editar as atividades existentes para a sala de aula. Os alunos não podem aceitar convites para atividades em salas de aula arquivadas. {% data reusables.classroom.sign-into-github-classroom %} -1. To the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, then click **Archive**. ![Drop-down menu from horizontal kebab icon and "Archive" menu item](/assets/images/help/classroom/use-drop-down-then-click-archive.png) -1. To unarchive a classroom, to the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, then click **Unarchive**. ![Drop-down menu from horizontal kebab icon and "Unarchive" menu item](/assets/images/help/classroom/use-drop-down-then-click-unarchive.png) +1. À direita do nome da sala de aula, selecione o menu suspenso {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e, em seguida, clique em **Arquivar**. ![Menu suspenso do ícone do kebab horizontal e item do menu "Arquivo"](/assets/images/help/classroom/use-drop-down-then-click-archive.png) +1. Para desarquivar uma sala de aula, à direita do nome de uma sala de aula, selecione o menu suspenso {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e, em seguida, clique em **Desarquivar**. ![Menu suspenso do ícone do kebab horizontal e item do menu "Desarquivar"](/assets/images/help/classroom/use-drop-down-then-click-unarchive.png) -### Deleting a roster for a classroom +### Excluir uma lista de participantes para uma sala de aula {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. Under "Delete this roster", click **Delete roster**. !["Delete roster" button under "Delete this roster" in "Students" tab for a classroom](/assets/images/help/classroom/students-click-delete-roster-button.png) -1. Read the warnings, then click **Delete roster**. !["Delete roster" button under "Delete this roster" in "Students" tab for a classroom](/assets/images/help/classroom/students-click-delete-roster-button-in-modal.png) +1. Em "Excluir esta lista", clique em **Excluir lista**. ![Botão "Excluir lista" em "Excluir esta lista" na aba "Alunos" para uma sala de aula](/assets/images/help/classroom/students-click-delete-roster-button.png) +1. Leia os avisos e, em seguida, clique em **Excluir lista**. ![Botão "Excluir lista" em "Excluir esta lista" na aba "Alunos" para uma sala de aula](/assets/images/help/classroom/students-click-delete-roster-button-in-modal.png) -### Deleting a classroom +### Excluir uma sala de aula {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} -1. To the right of "Delete this classroom", click **Delete classroom**. !["Delete repository" button](/assets/images/help/classroom/click-delete-classroom-button.png) +1. À direita de "Excluir essa sala de aula", clique em **Excluir sala de aula**. ![Botão "Excluir repositório"](/assets/images/help/classroom/click-delete-classroom-button.png) 1. **Leia os avisos**. -1. To verify that you're deleting the correct classroom, type the name of the classroom you want to delete. ![Modal for deleting a classrom with warnings and text field for classroom name](/assets/images/help/classroom/delete-classroom-modal-with-warning.png) -1. Click **Delete classroom**. !["Delete classroom" button](/assets/images/help/classroom/delete-classroom-click-delete-classroom-button.png) +1. Para verificar se você está excluindo a sala de aula correta, digite o nome da sala de aula que você deseja excluir. ![Modal para excluir uma sala de aula com avisos e campo de texto para nome da sala de aula](/assets/images/help/classroom/delete-classroom-modal-with-warning.png) +1. Clique em **Excluir sala de aula**. ![Botão "Excluir sala de aula"](/assets/images/help/classroom/delete-classroom-click-delete-classroom-button.png) diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md index 57e3f1e82414..dda616f2d667 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md @@ -1,21 +1,21 @@ --- -title: Run student code in an online IDE -intro: You can run the code from a student assignment within the online integrated development environment (IDE) that you configured for the assignment. +title: Execute o código do aluno em um IDE on-line +intro: Você pode executar o código da atividade de um aluno dentro do ambiente de desenvolvimento integrado on-line (IDE) que você configurou para a atividade. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/running-student-code --- -### About student code and online IDEs +### Sobre o código do estudante e os IDEs on-line -If you configure an online integrated development environment (IDE) for an assignment, you can run the code within the online IDE. You don't need to clone the assignment repository to your computer. +Se você configurar um ambiente de desenvolvimento integrado on-line (IDE) para uma atividade, você poderá executar o código dentro do IDE on-line. Você não precisa clonar o repositório da atividade no seu computador. -For more information about online IDEs, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +Para obter mais informações sobre IDEs on-line, consulte "[Integrar {% data variables.product.prodname_classroom %} a um IDE on-line](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)". -### Running student code in the online IDE +### Executar o código do aluno no IDE on-line {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-assignment-in-list %} -1. To the right of the submission, click **View IDE**. !["View IDE" button for submission using an online IDE](/assets/images/help/classroom/assignments-click-view-ide.png) +1. À direita do envio, clique em **Visualizar IDE**. ![Botão "Visualizar IDE" para envio usando um IDE on-line](/assets/images/help/classroom/assignments-click-view-ide.png) diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md index 6e051e9d2d82..7b7bd5e6b95e 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Teach with GitHub Classroom -intro: Learn how to set up your classroom and assignments. +title: Ensine com GitHub Classroom +intro: Aprenda a configurar sua sala de aula e suas atividades. mapTopic: true versions: free-pro-team: '*' diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/use-autograding.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/use-autograding.md index 7522b2b2025d..d7ef9b7bc283 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/use-autograding.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/use-autograding.md @@ -1,6 +1,6 @@ --- -title: Use autograding -intro: You can automatically provide feedback on code submissions from your students by configuring tests to run in the assignment repository. +title: Usar avaliação automática +intro: É possível fornecer feedback automaticamente sobre envios de código de seus alunos configurando testes para serem executados no repositório de atividade. miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' @@ -9,75 +9,75 @@ redirect_from: - /education/manage-coursework-with-github-classroom/reviewing-auto-graded-work-teachers --- -### About autograding +### Sobre a avaliação automática {% data reusables.classroom.about-autograding %} -After a student accepts an assignment, on every push to the assignment repository, {% data variables.product.prodname_actions %} runs the commands for your autograding test in a Linux environment containing the student's newest code. {% data variables.product.prodname_classroom %} creates the necessary workflows for {% data variables.product.prodname_actions %}. You don't need experience with {% data variables.product.prodname_actions %} to use autograding. +Depois que um aluno aceita uma atividade, em cada push para o repositório de atividades, {% data variables.product.prodname_actions %} executa os comandos do seu teste de avaliação automática em um ambiente Linux que contém o código mais novo do aluno. {% data variables.product.prodname_classroom %} cria os fluxos de trabalho necessários para {% data variables.product.prodname_actions %}. Você não precisa ter experiência com {% data variables.product.prodname_actions %} para usar a avaliação automática. -You can use a testing framework, run a custom command, write input/output tests, or combine different testing methods. The Linux environment for autograding contains many popular software tools. For more information, see the details for the latest version of Ubuntu in "[Specifications for {% data variables.product.company_short %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners#supported-software)." +Pode usar uma estrutura de teste, executar um comando personalizado, escrever testes de entrada/saída ou combinar diferentes métodos de teste. O ambiente Linux para avaliação automática contém muitas ferramentas de software populares. Para obter mais informações, consulte as informações sobre a versão mais recente do Ubuntu em "[Especificações para executores hospedados em {% data variables.product.company_short %}](/actions/reference/specifications-for-github-hosted-runners#supported-software)". -You can see an overview of which students are passing autograding tests by navigating to the assignment in {% data variables.product.prodname_classroom %}. A green checkmark means that all tests are passing for the student, and a red X means that some or all tests are failing for the student. If you award points for one or more tests, then a bubble shows the score for the tests out of the maximum possible score for the assignment. +Você pode ter uma visão geral dos alunos que estão passando testes de avaliação automática acessando a atividade em {% data variables.product.prodname_classroom %}. Uma marca de verificação verde significa que todos os testes estão passando para o aluno, e um X vermelho significa que alguns ou todos os testes estão falhando para o aluno. Se você ganhou pontos para um ou mais testes, uma bolha irá mostrar a pontuação para os testes da pontuação máxima possível para a atividade. -![Overview for an assignment with autograding results](/assets/images/help/classroom/autograding-hero.png) +![Visão geral de uma atividade com resultados de avaliação automática](/assets/images/help/classroom/autograding-hero.png) -### Grading methods +### Métodos de avaliação -There are two grading methods: input/output tests and run command tests. +Há dois métodos de avaliação: testes de entrada/saída e testes de comando de execução. -#### Input/output test +#### Teste de entrada/saída -An input/output test optionally runs a setup command, then provides standard input to a test command. {% data variables.product.prodname_classroom %} evaluates the test command's output against an expected result. +Um teste de entrada/saída opcionalmente executa um comando de configuração e, em seguida, fornece a entrada padrão para um comando de teste. {% data variables.product.prodname_classroom %} avalia a saída do comando de teste para um resultado esperado. -| Configuração | Descrição | -|:------------------- |:------------------------------------------------------------------------------------------------------------------------------ | -| **Test name** | The name of the test, to identify the test in logs | -| **Setup command** | _Optional_. A command to run before tests, such as compilation or installation | -| **Run command** | The command to run the test and generate standard output for evaluation | -| **Inputs** | Standard input for run command | -| **Expected output** | The output that you want to see as standard output from the run command | -| **Comparison** | The type of comparison between the run command's output and the expected output

    • **Included**: Passes when the expected output appears
      anywhere in the standard output from the run command
    • **Exact**: Passes when the expected output is completely identical
      to the standard output from the run command
    • **Regex**: Passes if the regular expression in expected
      output matches against the standard output from the run command
    | -| **Timeout** | In minutes, how long a test should run before resulting in failure | -| **Points** | _Optional_. The number of points the test is worth toward a total score | +| Configuração | Descrição | +|:--------------------------- |:--------------------------------------------------------------------------------------------------------------------------- | +| **Nome de teste** | O nome do teste, para identificar o teste em registros | +| **Comando de configuração** | _Opcional_. Um comando a ser executado antes dos testes, como compilação ou instalação | +| **Executar comando** | O comando para executar o teste e gerar saída padrão para avaliação | +| **Entradas** | Entrada padrão para o executar o comando | +| **Saída esperada** | A saída que você quer ver como saída padrão do comando de execução | +| **Comparação** | O tipo de comparação entre a saída do comando de execução e a saída esperada

    • **Incluído**: Passa quando a saída esperada aparece
      em qualquer lugar na saída padrão do comando de execução
    • **Exato**: Passa quando a saída esperada é completamente idêntica
      à saída padrão do comando de execução
    • **Regex**: Passa se a expressão regular na saída esperada
      corresponde à saída padrão do comando de execução
    | +| **Tempo esgotado** | Quanto tempo um teste deve ser executado em minutos antes de resultar em falha | +| **Pontos** | _Opcional_. O número de pontos que o teste vale para uma pontuação total | -#### Run command test +#### Executar teste de comando -A run command test runs a setup command, then runs a test command. {% data variables.product.prodname_classroom %} checks the exit status of the test command. An exit code of `0` results in success, and any other exit code results in failure. +Um comando de execução executa um comando de configuração e, em seguida, executa um comando de teste. {% data variables.product.prodname_classroom %} verifica o status de saída do comando de teste. Um código de saída de `0` resulta em sucesso e qualquer outro código de saída resulta em falha. -{% data variables.product.prodname_classroom %} provides presets for language-specific run command tests for a variety of programming languages. For example, the **Run node** test prefills the setup command with `npm install` and the test command with `npm test`. +{% data variables.product.prodname_classroom %} fornece predefinições para testes de comando de execução específicos da linguagem para uma variedade de linguagens de programação. Por exemplo, o teste **Executar nó** preenche previamente o comando de configuração com `instalação de npm` e o comando de teste com `teste de npm`. -| Configuração | Descrição | -|:----------------- |:------------------------------------------------------------------------------ | -| **Test name** | The name of the test, to identify the test in logs | -| **Setup command** | _Optional_. A command to run before tests, such as compilation or installation | -| **Run command** | The command to run the test and generate an exit code for evaluation | -| **Timeout** | In minutes, how long a test should run before resulting in failure | -| **Points** | _Optional_. The number of points the test is worth toward a total score | +| Configuração | Descrição | +|:--------------------------- |:-------------------------------------------------------------------------------------- | +| **Nome de teste** | O nome do teste, para identificar o teste em registros | +| **Comando de configuração** | _Opcional_. Um comando a ser executado antes dos testes, como compilação ou instalação | +| **Executar comando** | O comando para executar o teste e gerar um código de saída para avaliação | +| **Tempo esgotado** | Quanto tempo um teste deve ser executado em minutos antes de resultar em falha | +| **Pontos** | _Opcional_. O número de pontos que o teste vale para uma pontuação total | -### Configuring autograding tests for an assignment +### Configurar testes de avaliação automática para uma atribuição -You can add autograding tests during the creation of a new assignment. {% data reusables.classroom.for-more-information-about-assignment-creation %} +Você pode adicionar testes de avaliação automática durante a criação de uma nova atividade. {% data reusables.classroom.for-more-information-about-assignment-creation %} -You can add, edit, or delete autograding tests for an existing assignment. If you change the autograding tests for an existing assignment, existing assignment repositories will not be affected. A student or team must accept the assignment and create a new assignment repository to use the new tests. +Você pode adicionar, editar ou excluir testes de avaliação automática para uma atividade existente. Se você alterar os testes de avaliação automática para uma atribuição existente, os repositórios de atividade existentes não serão afetados. Um aluno ou equipe deve aceitar a atividade e criar um novo repositório de atividade para usar os novos testes. {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.assignments-click-pencil %} -1. In the left sidebar, click **Grading and feedback**. !["Grading and feedback" to the left of assignment's basics](/assets/images/help/classroom/assignments-click-grading-and-feedback.png) -1. Add, edit, or delete an autograding test. - - To add a test, under "Add autograding tests", select the **Add test** drop-down menu, then click the grading method you want to use. ![Using the "Add test" drop-down menu to click a grading method](/assets/images/help/classroom/autograding-click-grading-method.png) Configure the test, then click **Save test case**. !["Save test case" button for an autograding test](/assets/images/help/classroom/assignments-click-save-test-case-button.png) - - To edit a test, to the right of the test name, click {% octicon "pencil" aria-label="The pencil icon" %}. ![Pencil icon for editing an autograding test](/assets/images/help/classroom/autograding-click-pencil.png) Configure the test, then click **Save test case**. !["Save test case" button for an autograding test](/assets/images/help/classroom/assignments-click-save-test-case-button.png) - - To delete a test, to the right of the test name, click {% octicon "trash" aria-label="The trash icon" %}. ![Trash icon for deleting an autograding test](/assets/images/help/classroom/autograding-click-trash.png) -1. At the bottom of the page, click **Update assignment**. !["Update assignment" button at the bottom of the page](/assets/images/help/classroom/assignments-click-update-assignment.png) +1. Na barra lateral esquerda, clique em **Avaliações e feedback**. !["Avaliações e feedback" à esquerda dos fundamentos da aitivdade](/assets/images/help/classroom/assignments-click-grading-and-feedback.png) +1. Adicionar, editar ou excluir um teste de avaliação automática. + - Para adicionar um teste, em "Adicionar testes de avaliação automática", selecione o menu suspenso **Adicionar teste** e, em seguida, clique no método de avaliação que você deseja usar. ![Using the "Add test" drop-down menu to click a grading method](/assets/images/help/classroom/autograding-click-grading-method.png) Configure o teste e, em seguida, clique em **Salvar caso de teste**. ![Botão "Salvar caso de teste" para um teste de avaliação automática](/assets/images/help/classroom/assignments-click-save-test-case-button.png) + - Para editar um teste, à direita do nome do teste, clique em {% octicon "pencil" aria-label="The pencil icon" %}. ![Pencil icon for editing an autograding test](/assets/images/help/classroom/autograding-click-pencil.png) Configure o teste e, em seguida, clique em **Salvar caso de teste**. ![Botão "Salvar caso de teste" para um teste de avaliação automática](/assets/images/help/classroom/assignments-click-save-test-case-button.png) + - Para excluir um teste, à direita do nome do teste, clique em {% octicon "trash" aria-label="The trash icon" %}. ![Ícone da lixeira para excluir um teste de avaliação automática](/assets/images/help/classroom/autograding-click-trash.png) +1. Na parte inferior da página, clique em **Atualizar atividade**. ![Botão "Atualizar a atividade" na parte inferior da página](/assets/images/help/classroom/assignments-click-update-assignment.png) -### Viewing logs from autograding tests +### Visualizar registros dos testes da avaliação automática {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-assignment-in-list %} -1. To the right of a submission, click **View test**. !["View test" button for an assignment submission](/assets/images/help/classroom/assignments-click-view-test.png) -1. Review the test output. For more information, see "[Using workflow run logs](/actions/managing-workflow-runs/using-workflow-run-logs)." +1. À direita de um envio, clique em **Visualizar teste**. ![Botão "Visualizar teste" para envio de uma atividade](/assets/images/help/classroom/assignments-click-view-test.png) +1. Revise a saída de teste. Para obter mais informações, consulte "[Usar registros de execução do fluxo de trabalho](/actions/managing-workflow-runs/using-workflow-run-logs)". ### Leia mais -- [{% data variables.product.prodname_actions %} documentation](/actions) +- [Documentação de {% data variables.product.prodname_actions %}](/actions) diff --git a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/view-autograding-results.md b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/view-autograding-results.md index a1e904e7b9d0..3df0431958d4 100644 --- a/translations/pt-BR/content/education/manage-coursework-with-github-classroom/view-autograding-results.md +++ b/translations/pt-BR/content/education/manage-coursework-with-github-classroom/view-autograding-results.md @@ -1,29 +1,29 @@ --- -title: View autograding results -intro: You can see results from autograding within the repository for your assignment. +title: Visualizar resultados da avaliação automática +intro: Você pode ver os resultados da avaliação automática dentro do repositório para sua atividade. versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/reviewing-auto-graded-work-students --- -### About autograding +### Sobre a avaliação automática -Your teacher can configure tests that automatically check your work when you push to an assignment repository on {% data variables.product.product_location %}. +Seu professor pode configurar testes que verificam automaticamente seu trabalho quando você faz push para um repositório de atividades em {% data variables.product.product_location %}. -If you're a student and your instructor has configured autograding for your assignment in {% data variables.product.prodname_classroom %}, you'll find autograding test results throughout your assignment repository. If all tests succeed for a commit, you'll see a green checkmark. If any tests fail for a commit, you'll see a red X. You can see detailed logs by clicking the green checkmark or red X. +Se você é um aluno e seu instrutor configurou a avaliação automática para sua atribuição em {% data variables.product.prodname_classroom %}, você encontrará os resultados dos testes de avaliação automática no repositório da atividade. Se todos os testes tiverem êxito para um commit, você verá um sinal verde. Se qualquer teste falhar em um commit, você verá um X vermelho. Você pode ver os registros detalhados clicando na marca verde ou X vermelho. -### Viewing autograding results for an assignment repository +### Visualizar resultados de avaliação automática para um repositório de atividade -{% data variables.product.prodname_classroom %} uses {% data variables.product.prodname_actions %} to run autograding tests. For more information about viewing the logs for an autograding test, see "[Using workflow run logs](/actions/managing-workflow-runs/using-workflow-run-logs#viewing-logs-to-diagnose-failures)." +{% data variables.product.prodname_classroom %} usa {% data variables.product.prodname_actions %} para executar testes de avaliação automática. Para obter mais informações sobre a visualização dos registros para um teste de avaliação automática, consulte "[Usar registros de execução de fluxo de trabalho](/actions/managing-workflow-runs/using-workflow-run-logs#viewing-logs-to-diagnose-failures)". -The **Actions** tab shows the full history of test runs. +A aba **Ações** mostra o histórico completo de execuções de teste. -!["Actions" tab with "All workflows" selected](/assets/images/help/classroom/autograding-actions-tab.png) +![Aba "Ações" com "Todos os fluxos de trabalho" selecionados](/assets/images/help/classroom/autograding-actions-tab.png) -You can click a specific test run to review log output, like compilation errors and test failures. +Você pode clicar em uma execução de teste específico para revisar o resultado do registro, como erros de compilação e falhas de teste. -![The "{% data variables.product.prodname_classroom %} Autograding Workflow" test results logs in {% data variables.product.prodname_actions %} ](/assets/images/help/classroom/autograding-actions-logs.png) +![O "{% data variables.product.prodname_classroom %} Fluxo de trabalho da avaliação automática" registros de resultados de teste em {% data variables.product.prodname_actions %} ](/assets/images/help/classroom/autograding-actions-logs.png) ### Leia mais diff --git a/translations/pt-BR/content/education/quickstart.md b/translations/pt-BR/content/education/quickstart.md index 251697708362..0fc75a19982d 100644 --- a/translations/pt-BR/content/education/quickstart.md +++ b/translations/pt-BR/content/education/quickstart.md @@ -1,6 +1,6 @@ --- -title: Quickstart for GitHub Educators -intro: In about 15 minutes, teachers can get started with discounts, training, and tools for {% data variables.product.company_short %}, then create a classroom for the students in a software development course using {% data variables.product.prodname_classroom %}. +title: Início rápido para educadores do GitHub +intro: Em cerca de 15 minutos, os professores podem começar com descontos, treinamentos e ferramentas para {% data variables.product.company_short %} e, em seguida, criar uma sala de aula para os alunos em um curso de desenvolvimento de software usando {% data variables.product.prodname_classroom %}. allowTitleToDifferFromFilename: true versions: free-pro-team: '*' @@ -8,39 +8,39 @@ versions: ### Introdução -Educators who teach a course on software development can use discounts, partnerships, training, and tools from {% data variables.product.prodname_education %} to effectively teach relevant skills to students. +Os educadores que ministram um curso sobre desenvolvimento de software podem usar descontos, parcerias, treinamento e ferramentas a partir de {% data variables.product.prodname_education %} para ensinar efetivamente as habilidades relevantes aos alunos. -In this guide, you'll get started with {% data variables.product.product_name %}, sign up for accounts and discounted services through {% data variables.product.prodname_education %}, and create a space for your course and assignment on {% data variables.product.prodname_classroom %}. +Neste guia, você começará com {% data variables.product.product_name %}, inscreva-se em contas e serviços com descontos por meio de {% data variables.product.prodname_education %} e crie um espaço para o seu curso e atividade em {% data variables.product.prodname_classroom %}. {% tip %} -**Tip**: If you're a student and you'd like to take advantage of an academic discount, see "[Applying for a student developer pack](/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack)." +**Dica**: Se você é um aluno e gostaria de aproveitar um desconto acadêmico, consulte "[Solicitar um pacote de desenvolvedores para estudantes](/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack)". {% endtip %} -### Creating accounts on {% data variables.product.product_name %} +### Criar contas em {% data variables.product.product_name %} -First, you'll need to create a free user account on {% data variables.product.product_name %}. +Primeiro, você precisará criar uma conta de usuário grátis em {% data variables.product.product_name %}. {% data reusables.accounts.create-account %} -1. Follow the prompts to create your free user account. +1. Siga as instruções para criar sua conta de usuário grátis. -After you create your user account, create a free organization account. You'll use this organization account to create and manage classrooms {% data variables.product.prodname_classroom %}. +Depois de criar a sua conta de usuário, crie uma conta grátis de organização. Você usará esta conta da organização para criar e gerenciar salas de aula de {% data variables.product.prodname_classroom %}. {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. Follow the prompts to create a free organization. +4. Siga as instruções para criar uma organização grátis. -For more information, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." +Para obter mais informações, consulte "[Tipos de contas de {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github/types-of-github-accounts)". -### Applying for an educator discount +### Solicitar um desconto de educador -Next, you'll sign up for discounts on services from {% data variables.product.company_short %}. {% data reusables.education.educator-requirements %} +Em seguida, você irá inscrever-se para receber descontos em serviços a partir de {% data variables.product.company_short %}. {% data reusables.education.educator-requirements %} {% tip %} -**Tip** In addition to individual discounts, {% data variables.product.company_short %} offers partnerships with educational institutions through the {% data variables.product.prodname_campus_program %}. For more information, see the [{% data variables.product.prodname_campus_program %}](https://education.github.com/schools) website. +**Dica** Além de descontos individuais, {% data variables.product.company_short %} oferece parcerias com instituições de ensino por meio de {% data variables.product.prodname_campus_program %}. Para obter mais informações, consulte o site [{% data variables.product.prodname_campus_program %}](https://education.github.com/schools). {% endtip %} @@ -52,36 +52,36 @@ Next, you'll sign up for discounts on services from {% data variables.product.co {% data reusables.education.plan-to-use-github %} {% data reusables.education.submit-application %} -### Set up {% data variables.product.prodname_classroom %} +### Configurar {% data variables.product.prodname_classroom %} -With your user account and organization account, you're ready to get started with {% data variables.product.prodname_classroom %}. {% data variables.product.prodname_classroom %} is free to use. You can track and manage assignments, grade work automatically, and provide feedback to your students. +Com sua conta de usuário e conta de organização, você está pronto para dar os primeiros passos com {% data variables.product.prodname_classroom %}. {% data variables.product.prodname_classroom %} é grátis para usar. Você pode acompanhar e gerenciar as recomendações, avaliar o trabalho automaticamente e dar feedback aos seus alunos. {% data reusables.classroom.sign-into-github-classroom %} -1. To authorize {% data variables.product.prodname_classroom %} to access your user account on {% data variables.product.prodname_dotcom %}, review the information, then click **Authorize {% data variables.product.prodname_classroom %}**. !["Authorize {% data variables.product.prodname_classroom %}" button for user account](/assets/images/help/classroom/setup-click-authorize-github-classroom.png) -1. Review the information. To authorize {% data variables.product.prodname_classroom %} to access your organization account on {% data variables.product.prodname_dotcom %}, click **Grant**. !["Grant" button for organization](/assets/images/help/classroom/setup-click-grant.png) +1. Para autorizar {% data variables.product.prodname_classroom %} para acessar a sua conta de usuário em {% data variables.product.prodname_dotcom %}, revise as informações e, em seguida, clique em **Autorizar {% data variables.product.prodname_classroom %}**. ![Botão "Autorizar {% data variables.product.prodname_classroom %}" para a conta do usuário](/assets/images/help/classroom/setup-click-authorize-github-classroom.png) +1. Revise as informações. Para autorizar {% data variables.product.prodname_classroom %} a acessar sua conta de organização em {% data variables.product.prodname_dotcom %}, clique em **Conceder**. ![Botão "Conceder" para organização](/assets/images/help/classroom/setup-click-grant.png) {% tip %} - **Tip**: If you see a **Request** button instead of a **Grant** button, you are a member of the organization, not an owner. An owner must approve your request for {% data variables.product.prodname_classroom %}. You must be an organization owner to create and manage classrooms and assignments in {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps#oauth-apps-and-organizations)". + **Dica**: Se você vir um botão **Solicitar** em vez de um botão de **Conceder**, significa que você é integrante da organização, não um dono. Um proprietário deve aprovar sua solicitação para {% data variables.product.prodname_classroom %}. Você precisa ser o proprietário da organização para criar e gerenciar as salas de aula e as atividades em {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Autorizar aplicativos OAuth](/github/authenticating-to-github/authorizing-oauth-apps#oauth-apps-and-organizations)". {% endtip %} -1. Click **Authorize github**. ![Click "Authorize" button for organization](/assets/images/help/classroom/setup-click-authorize-github.png) +1. Clique em **Autorizar github**. ![Clique no botão "Autorizar" para a organização](/assets/images/help/classroom/setup-click-authorize-github.png) -### Create your classroom +### Crie a sua sala de aula {% data reusables.classroom.about-classrooms %} {% data reusables.classroom.sign-into-github-classroom %} -1. Click **Create your first classroom** or **New classroom**. +1. Clique em **Criar sua primeira sala de aula** ou **Nova sala de aula**. {% data reusables.classroom.guide-create-new-classroom %} ### Próximas etapas -You've created a classroom, and you're ready to enrich your course with {% data variables.product.product_name %} and {% data variables.product.prodname_classroom %}! 🎉 +Você criou uma sala de aula e está pronto para enriquecer seu curso com {% data variables.product.product_name %} e {% data variables.product.prodname_classroom %}! 🎉 -- Watch some videos about {% data variables.product.prodname_classroom %}. For more information, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." -- Manage your classrooms and classroom admins, and create a roster of students for your classroom. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." -- Create an assignment for individual students or teams. {% data reusables.classroom.for-more-information-about-assignment-creation %} -- Write and implement automated tests to provide immediate feedback to students directly in assignment repositories. For more information, see "[Use autograding](/education/manage-coursework-with-github-classroom/use-autograding)." -- Participate in {% data variables.product.prodname_education_community_with_url %}. +- Assista a alguns vídeos sobre {% data variables.product.prodname_classroom %}. Para obter mais informações, consulte "[Fundamentos da configuração de {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)". +- Gerencie suas salas de aula e administradores da sala de aula e crie uma lista de estudantes para sua sala de aula. Para obter mais informações, consulte "[Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms)". +- Crie uma atividade para alunos individualmente ou para equipes. {% data reusables.classroom.for-more-information-about-assignment-creation %} +- Escreva e implemente testes automatizados para dar feedback imediato aos alunos diretamente nos repositórios de atividade. Para obter mais informações, consulte "[Usar avaliação automática](/education/manage-coursework-with-github-classroom/use-autograding). +- Participar de {% data variables.product.prodname_education_community_with_url %}. diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md index f18ee1feda48..70a39a70a08a 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md @@ -12,9 +12,9 @@ Usar o {% data variables.product.prodname_dotcom %} nos projetos da sua escola {% data reusables.education.about-github-education-link %} -Cada pessoa com uma conta do {% data variables.product.prodname_dotcom %} pode colaborar em repositórios públicos e privados ilimitados com o {% data variables.product.prodname_free_user %}. Como estudante, você também pode solicitar o {% data variables.product.prodname_student_pack %}, que oferece acesso grátis às ferramentas e aos serviços usados por desenvolvedores profissionais. For more information, see "[Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" and [{% data variables.product.prodname_education %}](https://education.github.com/pack). +Cada pessoa com uma conta do {% data variables.product.prodname_dotcom %} pode colaborar em repositórios públicos e privados ilimitados com o {% data variables.product.prodname_free_user %}. Como estudante, você também pode solicitar o {% data variables.product.prodname_student_pack %}, que oferece acesso grátis às ferramentas e aos serviços usados por desenvolvedores profissionais. Para obter mais informações, consulte "[Aplicar um pacote de desenvolvedor para estudante](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" e [{% data variables.product.prodname_education %}](https://education.github.com/pack). -Se você for integrante de um clube de robótica FIRST, seu mentor poderá solicitar um desconto para educador para que sua equipe possa colaborar usando o {% data variables.product.prodname_team %}, que permite repositórios privados e de usuários ilimitados, gratuitamente. For more information, see "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)." +Se você for integrante de um clube de robótica FIRST, seu mentor poderá solicitar um desconto para educador para que sua equipe possa colaborar usando o {% data variables.product.prodname_team %}, que permite repositórios privados e de usuários ilimitados, gratuitamente. Para obter mais informações, consulte "[Aplicar um desconto para educador ou pesquisador](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)". ### Leia mais diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education.md index f7a264408f33..076aebffc7c0 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/about-github-education.md @@ -16,8 +16,8 @@ Se a sua escola concorda em atender a determinados requisitos, sua escola secund Para obter mais informações, consulte a página [oficial do {% data variables.product.prodname_education %}](https://education.github.com/partners/schools). -Teachers can manage a course on software development with {% data variables.product.prodname_education %}. {% data variables.product.prodname_classroom %} allows you to distribute code, provide feedback, and manage coursework using {% data variables.product.product_name %}. For more information, see "[Manage coursework with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom)." +Os professores podem gerenciar um curso sobre desenvolvimento de software com {% data variables.product.prodname_education %}. {% data variables.product.prodname_classroom %} permite distribuir código, fornecer feedback e gerenciar trabalhos do curso usando {% data variables.product.product_name %}. Para obter mais informações, consulte "[Gerenciar cursos com {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom)". Para saber mais sobre programas de treinamento para líderes estudantis e professores, consulte "[especialistas de campus do {% data variables.product.prodname_dotcom %}](https://education.github.com/students/experts)" e "[consultores de campus](https://education.github.com/teachers/advisors)". -Se você for estudante ou professor acadêmico e sua escola não faz parceria com o {% data variables.product.prodname_dotcom %} como uma escola do {% data variables.product.prodname_education %}, ainda assim é possível solicitar descontos individualmente para usar o {% data variables.product.prodname_dotcom %}. For more information, see "[Use {% data variables.product.prodname_dotcom %} for your schoolwork](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork)" or "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research/)." +Se você for estudante ou professor acadêmico e sua escola não faz parceria com o {% data variables.product.prodname_dotcom %} como uma escola do {% data variables.product.prodname_education %}, ainda assim é possível solicitar descontos individualmente para usar o {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Usar o {% data variables.product.prodname_dotcom %} para fazer o trabalho de escola](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork)" ou "[Usar o {% data variables.product.prodname_dotcom %} em sala de aula e em pesquisas](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research/)". diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index e6ec95023436..e34d653bdbcd 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -1,5 +1,5 @@ --- -title: Apply for a student developer pack +title: Aplicar ao pacote de desenvolvedor de aluno intro: 'Como um estudante, você pode se candidatar ao {% data variables.product.prodname_student_pack %}, que inclui ofertas e benefícios dos parceiros {% data variables.product.prodname_dotcom %}.' redirect_from: - /github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack @@ -18,7 +18,7 @@ Para se qualificar para o {% data variables.product.prodname_student_pack %}, vo - Ter uma conta de usuário do [{% data variables.product.prodname_dotcom %}](/articles/signing-up-for-a-new-github-account) - Ter pelo menos 13 anos -Os documentos que comprovam seu status atual de estudante incluem uma foto de sua identificação escolar, horário de aulas, certificado e carta de confirmação de matrícula ou inscrição. +Documentos que provam o seu estado atual do aluno incluem uma foto do seu ID da escola com a data atual de matrícula. cronograma de aula, histórico escolar e carta de verificação de afiliação ou inscrição. Durante o período como estudante, pode ser que você seja solicitado a verificar periodicamente seu status acadêmico atual. diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md index f4affa6009bd..5080d96d0aa3 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md @@ -1,5 +1,5 @@ --- -title: Apply for an educator or researcher discount +title: Solicitar um desconto de educador ou pesquisador intro: 'Sendo um educador ou pesquisador, você pode se candidatar para receber o {% data variables.product.prodname_team %} gratuitamente para a conta da sua organização.' redirect_from: - /github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount @@ -18,7 +18,7 @@ versions: {% data reusables.education.educator-requirements %} -For more information about user accounts on {% data variables.product.product_name %}, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/github/getting-started-with-github/signing-up-for-a-new-github-account)." +Para obter mais informações sobre contas de usuário em {% data variables.product.product_name %}, consulte "[Cadastrar-se para uma nova conta de {% data variables.product.prodname_dotcom %} ](/github/getting-started-with-github/signing-up-for-a-new-github-account)". ### Candidatar-se a um desconto de educador ou pesquisador diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/index.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/index.md index b4486fff9af9..df6b639d98a2 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/index.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/index.md @@ -1,7 +1,7 @@ --- -title: Explore the benefits of teaching and learning with GitHub Education -shortTitle: Teach and learn -intro: Learn how {% data variables.product.prodname_education %} can benefit your classroom, schoolwork, or research and how to apply for free access to various developer tools from {% data variables.product.company_short %}'s partners. +title: Explore os benefícios de ensinar e aprender com o GitHub Education +shortTitle: Ensine e aprenda +intro: Aprenda como {% data variables.product.prodname_education %} pode beneficiar sua sala de aula, trabalho escolar ou pesquisa e como inscrever-se para ter acesso gratuito a várias ferramentas de desenvolvedor dos parceiros de {% data variables.product.company_short %}. redirect_from: - /education/teach-and-learn-with-github-education - /github/teaching-and-learning-with-github-education diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md index 61c4dd444679..2053cd0b7312 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md @@ -1,5 +1,5 @@ --- -title: Use GitHub at your educational institution +title: Use o GitHub na sua instituição educacional intro: 'Maximize os benefícios de usar o {% data variables.product.prodname_dotcom %} na sua instituição para alunos, instrutores e equipe de TI com o {% data variables.product.prodname_education %} e nossos diversos programas de treinamento para alunos e instrutores.' mapTopic: true redirect_from: diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md index ce60906c64d0..96efde4c44ba 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md @@ -1,5 +1,5 @@ --- -title: Use GitHub for your schoolwork +title: Use o GitHub para tarefas de aprendizagem intro: 'Como aluno, use o {% data variables.product.prodname_dotcom %} para colaborar nos projetos da sua escola e ganhar experiência no mundo real.' mapTopic: true redirect_from: diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md index 7b41342ce22e..5b123f567f59 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md @@ -1,5 +1,5 @@ --- -title: Use GitHub in your classroom and research +title: Use o GitHub em aula e pesquisas intro: 'Como educador ou pesquisador, use o {% data variables.product.prodname_dotcom %} para colaborar no seu trabalho em sala de aula, em um grupo de pesquisa ou de alunos, e muito mais.' mapTopic: true redirect_from: diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md index f900972e328f..f64af23c3b9b 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md @@ -56,7 +56,7 @@ Para obter mais informações, consulte: ### Status de aluno não qualificado Você não estará qualificado para um {% data variables.product.prodname_student_pack %} se: -- You're enrolled in an informal learning program that is not part of the [{% data variables.product.prodname_dotcom %} Campus Program](https://education.github.com/schools) and not enrolled in a degree or diploma granting course of study. +- Você está matriculado em um programa de aprendizado informal que não faz parte do [programa de campus do {% data variables.product.prodname_dotcom %}](https://education.github.com/schools) e não está matriculado em um curso superior ou técnico. - Tiver menos de 13 anos. Seu instrutor ainda poderá se candidatar a um desconto {% data variables.product.prodname_education %} para uso em sala de aula. Se você for aluno de uma escola de programação ou de um bootcamp, só estará qualificado para um {% data variables.product.prodname_student_pack %} se a sua instituição de ensino participar do [programa de campus do {% data variables.product.prodname_dotcom %}](https://education.github.com/schools). @@ -64,4 +64,4 @@ Seu instrutor ainda poderá se candidatar a um desconto {% data variables.produc ### Leia mais - "[Candidatar-se a um pacote de desenvolvedor para estudante](/articles/applying-for-a-student-developer-pack)" -- "[Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" +- "[Solicite um pacote de desenvolvedor para estudante](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" diff --git a/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md b/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md index 0cfefb8db80d..9589635ae786 100644 --- a/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md +++ b/translations/pt-BR/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md @@ -42,4 +42,4 @@ Educadores e pesquisadores não estão qualificados para as ofertas de parceiros ### Leia mais -- "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)" +- "[Solicite desconto para educador ou pesquisador](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)" diff --git a/translations/pt-BR/content/github/administering-a-repository/about-dependabot-version-updates.md b/translations/pt-BR/content/github/administering-a-repository/about-dependabot-version-updates.md index d6b53afb5909..50ca42cd02b2 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-dependabot-version-updates.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-dependabot-version-updates.md @@ -36,7 +36,7 @@ Se tiver habilitado atualizações de segurança, às vezes você verá atualiza {% note %} -{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. See the details in the table below. +{% data reusables.dependabot.private-dependencies-note %} Adicionalmente, {% data variables.product.prodname_dependabot %} não é compatível com dependências privadas {% data variables.product.prodname_dotcom %} para todos os gerenciadores de pacote. Veja os detalhes na tabela abaixo. {% endnote %} 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 0abc9e967ce6..9f441bd405a4 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 @@ -11,12 +11,16 @@ versions: github-ae: '*' --- +### Sobre branches protegidos + {% data reusables.pull_requests.about-protected-branches %} Você pode optar por aplicar restrições sobre como um pull request é mesclado no seu repositório. Os proprietários de repositório e as pessoas com permissões de administrador para um repositório podem impor determinados fluxos de trabalho ou requisitos, antes que um colaborador possa fazer merge em seu repositório criando regras de branch protegido. {% data reusables.repositories.branch-rules-example %} Para obter mais informações, consulte "[Configurar branches protegidos](/articles/configuring-protected-branches/)." +{% data reusables.pull_requests.you-can-auto-merge %} + ### Priorização de regras de branches protegidos Se um repositório tiver várias regras de branch protegido que afetem os mesmos branches, as regras que incluírem um nome de branch específico terão a prioridade mais alta. Se houver mais de uma regra de branch protegido que faça referência ao mesmo nome de branch específico, a regra de branch criada primeiro terá a prioridade mais alta. diff --git a/translations/pt-BR/content/github/administering-a-repository/about-secret-scanning.md b/translations/pt-BR/content/github/administering-a-repository/about-secret-scanning.md index d6bae2a97e79..4bd9474d0add 100644 --- a/translations/pt-BR/content/github/administering-a-repository/about-secret-scanning.md +++ b/translations/pt-BR/content/github/administering-a-repository/about-secret-scanning.md @@ -80,7 +80,7 @@ Quando o {% data variables.product.prodname_secret_scanning %} detecta um segred Os administradores do repositório e proprietários da organização podem conceder acesso a alertas de {% data variables.product.prodname_secret_scanning %} aos usuários e à equipe. Para obter mais informações, consulte "[Gerenciar configurações de segurança e análise do repositório](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository#granting-access-to-security-alerts)". -To monitor results from {% data variables.product.prodname_secret_scanning %} across your private repositories or your organization, you can use the {% data variables.product.prodname_secret_scanning %} API. For more information about API endpoints, see "[{% data variables.product.prodname_secret_scanning_caps %}](/rest/reference/secret-scanning)." +Para monitorar os resultados de {% data variables.product.prodname_secret_scanning %} nos seus repositórios privados ou na sua organização, você pode usar a API de {% data variables.product.prodname_secret_scanning %}. Para obter mais informações sobre pontos de extremidade da API, consulte "[{% data variables.product.prodname_secret_scanning_caps %}](/rest/reference/secret-scanning)". O {% data variables.product.product_name %} atualmente verifica repositórios públicos para encontrar segredos emitidos pelos seguintes provedores de serviços. 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 17e647855b6f..19d82cab31df 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 @@ -308,7 +308,7 @@ updates: {% note %} -**Note**: {% data variables.product.prodname_dependabot %} can only run version updates on manifest or lock files if it can access all of the dependencies in the file, even if you add inaccessible dependencies to the `ignore` option of your configuration file. For more information, 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#allowing-dependabot-to-access-private-repositories)" and "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors#dependabot-cant-resolve-your-dependency-files)." +**Observação**: {% data variables.product.prodname_dependabot %} só pode executar atualizações de versão no manifesto ou em arquivos de bloqueio se puder acessar todas as dependências do arquivo, ainda que você adicione dependências inacessíveis à opção `ignorar` do seu arquivo de configuração. Para obter mais informações, consulte "[Gerenciar 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#allowing-dependabot-to-access-private-repositories)" e "[Solução de problemas de erros de {% data variables.product.prodname_dependabot %} ](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors#dependabot-cant-resolve-your-dependency-files)". {% endnote %} diff --git a/translations/pt-BR/content/github/administering-a-repository/configuring-pull-request-merges.md b/translations/pt-BR/content/github/administering-a-repository/configuring-pull-request-merges.md index d3287081913f..d62939a29755 100644 --- a/translations/pt-BR/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/pt-BR/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: Configurar merges de pull request -intro: 'Você pode configurar merges de pull request no {% data variables.product.product_location %} de modo a corresponder o fluxo de trabalho e as preferências para gerenciar o histórico do Git habilitando, desabilitando ou aplicando commits de merge padrão, commits combinados por squash ou commits com rebase em todas as pull requests no repositório.' +intro: 'Você pode configurar os merges de pull request em {% data variables.product.product_location %} para corresponder ao seu fluxo de trabalho e preferências para gerenciar o histórico do Git.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 e6b7dac2dd74..bc4c761ba47d 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 @@ -11,7 +11,7 @@ versions: 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. -{% if currentVersion != "github-ae@latest" %}You can upload an image to a private repository, but your image can only be shared from a public repository.{% endif %} +{% if currentVersion != "github-ae@latest" %}Você pode fazer o upload de uma imagem para um repositório privado, mas sua imagem só pode ser compartilhada a partir de um repositório público.{% endif %} {% tip %} Dica: a imagem deve ser um arquivo PNG, JPG ou GIF com menos de 1 MB. Para renderização de melhor qualidade, é recomendável manter a imagem em 640 x 320 pixels. diff --git a/translations/pt-BR/content/github/administering-a-repository/deleting-a-repository.md b/translations/pt-BR/content/github/administering-a-repository/deleting-a-repository.md index 867982525d4b..fc8eb2c4f9fe 100644 --- a/translations/pt-BR/content/github/administering-a-repository/deleting-a-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/deleting-a-repository.md @@ -13,14 +13,14 @@ versions: Os {% data reusables.organizations.owners-and-admins-can %} excluem um repositório da organização. Se a opção **Allow members to delete or transfer repositories for this organization** (Permitir que os integrantes excluam ou transfiram repositórios desta organização) tiver sido desabilitada, somente proprietários da organização poderão excluir repositórios da organização. {% data reusables.organizations.new-repo-permissions-more-info %} -{% if currentVersion != "github-ae@latest" %}Deleting a public repository will not delete any forks of the repository.{% endif %} +{% if currentVersion != "github-ae@latest" %}Excluir um repositório público não excluirá nenhuma bifurcação do repositório.{% endif %} {% warning %} **Avisos**: -- Deleting a repository will **permanently** delete release attachments and team permissions. Esta ação **não pode** ser desfeita. -- Deleting a private {% if currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" %}or internal {% endif %}repository will delete all forks of the repository. +- Excluir um repositório irá excluir **permanentemente** anexos da versão e permissões da equipe. Esta ação **não pode** ser desfeita. +- Excluir um repositório privado {% if currentVersion ver_gt "enterprise-server@2. 9" or currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" %}ou interno {% endif %}irá excluir todas as bifurcações do repositório. {% endwarning %} 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 9c1c4fd9354b..1cc195e7e6fb 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)". -{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. For more information, see "[About Dependabot version updates](/github/administering-a-repository/about-dependabot-version-updates#supported-repositories-and-ecosystems)." +{% data reusables.dependabot.private-dependencies-note %} Adicionalmente, {% data variables.product.prodname_dependabot %} não é compatível com dependências privadas {% data variables.product.prodname_dotcom %} para todos os gerenciadores de pacote. Para obter mais informações, consulte "[Sobre atualizações da versão do Dependabot](/github/administering-a-repository/about-dependabot-version-updates#supported-repositories-and-ecosystems)". ### Habilitar {% data variables.product.prodname_dependabot_version_updates %} diff --git a/translations/pt-BR/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md b/translations/pt-BR/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md index c0dbdb12e5a4..7b263d869a8e 100644 --- a/translations/pt-BR/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md +++ b/translations/pt-BR/content/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository.md @@ -1,20 +1,20 @@ --- -title: Enabling or disabling GitHub Discussions for a repository -intro: 'You can use discussions in a repository as a place for your community to have conversations, ask questions, and post answers without scoping work in an issue.' +title: Habilitar ou desabilitar discussões no GitHub para um repositório +intro: 'Você pode usar discussões em um repositório como um lugar para sua comunidade ter conversas, fazer perguntas e postar respostas sem definir o escopo de trabalho em um problema.' product: '{% data reusables.gated-features.discussions %}' -permissions: People with admin permissions to a repository can enable discussions for the repository. +permissions: As pessoas com permissões de administrador em um repositório podem habilitar discussões no repositório. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Enabling or disabling discussions for your repository +### Habilitar ou desabilitar discussões para o seu repositório {% data reusables.discussions.enabling-or-disabling-github-discussions-for-your-repository %} -1. To disable discussions, under "Features", unselect **Discussions**. +1. Para desabilitar as discussões, em "Recursos", desmarque **Discussões**. ### Leia mais -- "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" -- "[Managing discussions for your community](/discussions/managing-discussions-for-your-community)" +- "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" +- "[Gerenciar discussões para a sua comunidade](/discussions/managing-discussions-for-your-community)" 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 efc34afdffca..5e42bcfd200c 100644 --- a/translations/pt-BR/content/github/administering-a-repository/index.md +++ b/translations/pt-BR/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/pt-BR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/pt-BR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..7aa3dbe16b56 --- /dev/null +++ b/translations/pt-BR/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Gerenciando merge automático para pull requests no seu repositório +intro: "Você pode permitir ou impedir um merge automático de pull requests em seu repositório." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: Pessoas com permissões de mantenedor podem gerenciar merge automático para pull requests em um repositório. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +Se você permitir um merge automático para pull requests no seu repositório, as pessoas podem configurar os pull requests individuais no repositório para fazer merge automaticamente quando todos os requisitos de merge forem atendidos. Para obter mais informações, consulte "[Fazer merge automático de um pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)". + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Em "Botão de merge", selecione ou desmarque a opção **Permitir merge automático**. ![Caixa de seleção para permitir ou impedir merge automático](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file 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 0ef1cf5cdaf9..02118acafafd 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 @@ -20,7 +20,7 @@ versions: ### Sobre o gerenciamento da versão {% if currentVersion == "free-pro-team@latest" %} -You can also publish an action from a specific release in {% data variables.product.prodname_marketplace %}. Para obter mais informações, consulte "Publicar uma ação no {% data variables.product.prodname_marketplace %}" +Você também pode publicar uma ação a partir 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 %}" {% endif %} Você pode escolher se diff --git a/translations/pt-BR/content/github/administering-a-repository/managing-repository-settings.md b/translations/pt-BR/content/github/administering-a-repository/managing-repository-settings.md index 1436489ba44a..5a388f9ea086 100644 --- a/translations/pt-BR/content/github/administering-a-repository/managing-repository-settings.md +++ b/translations/pt-BR/content/github/administering-a-repository/managing-repository-settings.md @@ -1,6 +1,6 @@ --- title: Gerenciar configurações do repositório -intro: 'Repository administrators and organization owners can change settings for a repository, like the name, ownership, and visibility, or delete the repository.' +intro: 'Os administradores de repositório e proprietários da organização podem alterar as configurações de um repositório como nome, propriedade e visibilidade ou excluir o repositório.' mapTopic: true redirect_from: - /articles/managing-repository-settings 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 cb5875858825..4346db4ef80d 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 @@ -20,12 +20,12 @@ Recomendamos revisar as seguintes advertências antes de alterar a visibilidade #### Tornar um repositório privado {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -* O {% data variables.product.product_name %} destacará bifurcações públicas do repositório público e as colocará em uma nova rede. Public forks are not made private.{% endif %} -* 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. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}The visibility of any forks will also change to private.{% elsif currentVersion == "github-ae@latest" %}If the internal repository has any forks, the visibility of the forks is already private.{% 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)"{% 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 %}{% endif %} -* Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -* O {% data variables.product.prodname_dotcom %} não incluirá mais o repositório no {% 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 enterpriseServerVersions contains currentVersion %} -* 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 %} +* O {% data variables.product.product_name %} 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 convertem em privadas.{% endif %} +* Se você alterar a visibilidade de um repositório interno para privado, {% data variables.product.prodname_dotcom %} removerá bifurcações que pertencem a qualquer usuário sem acesso ao repositório privado recente. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}A visibilidade de qualquer bifurcação também será alterada para privada.{% elsif currentVersion == "github-ae@latest" %}Se o repositório interno tiver alguma bifurcação, significa que a visibilidade das bifurcações já é privada.{% endif %} Para obter mais informações, consulte "[O que acontece com as bifurcações quando um repositório é excluído ou a visibilidade é alterada?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility)"{% if currentVersion == "free-pro-team@latest" %} +* Se você estiver usando {% data variables.product.prodname_free_user %} para contas de usuário ou organizações, alguns recursos não estarão disponíveis no repositório depois de alterar a visibilidade para privada. {% data reusables.gated-features.more-info %}{% endif %} +* Qualquer site de {% data variables.product.prodname_pages %} publicado terá a publicação cancelada automaticamente.{% if currentVersion == "free-pro-team@latest" %} Se você adicionou um domínio personalizado ao site de {% data variables.product.prodname_pages %} você deve remover ou atualizar seus registros de DNS antes de tornar o repositório privado para evitar o risco de tomada de um domínio. Para obter mais informações, consulte "[Gerenciar um domínio personalizado para o seu site de {% data variables.product.prodname_pages %}](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} +* {% data variables.product.prodname_dotcom %} will no longer include the repository in the {% data variables.product.prodname_archive %}. Para obter mais informações, consulte "[Sobre sobre arquivamento de conteúdo e dados em {% 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 enterpriseServerVersions contains currentVersion %} +* O 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" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} @@ -37,7 +37,7 @@ Recomendamos revisar as seguintes advertências antes de alterar a visibilidade {% endnote %} -* Any forks of the repository will remain in the repository network, and {% data variables.product.product_name %} maintains the relationship between the root repository and the fork. 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)" +* Todas as bifurcações do repositório permanecerão na rede do repositório e a {% data variables.product.product_name %} manterá a relação entre o repositório raiz e a bifurcação. 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)" {% endif %} @@ -45,8 +45,8 @@ Recomendamos revisar as seguintes advertências antes de alterar a visibilidade #### Tornar um repositório público -* {% data variables.product.product_name %} will detach private forks and turn them into a standalone private repository. 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-private-repository-to-a-public-repository)"{% if currentVersion == "free-pro-team@latest" %} -* 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. 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 %}). 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 %} +* O {% data variables.product.product_name %} 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 a visibilidade?](/articles/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility#changing-a-private-repository-to-a-public-repository)"{% if currentVersion == "free-pro-team@latest" %} +* 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. Você também pode fazer um curso grátis sobre gerenciamento de 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 %} {% endif %} 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 afc9c467e7de..9062f15567f1 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 @@ -19,9 +19,9 @@ Depois de adicionar uma nova chave SSH à sua conta do {% data variables.product {% mac %} -1. Copy the SSH public key to your clipboard. +1. Copie a chave pública SSH para a sua área de transferência. - If your SSH public key file has a different name than the example code, modify the filename to match your current setup. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. + Se o seu arquivo de chave pública SSH tiver um nome diferente do código de exemplo, modifique o nome do arquivo para corresponder à sua configuração atual. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. ```shell $ pbcopy < ~/.ssh/id_ed25519.pub @@ -46,9 +46,9 @@ Depois de adicionar uma nova chave SSH à sua conta do {% data variables.product {% windows %} -1. Copy the SSH public key to your clipboard. +1. Copie a chave pública SSH para a sua área de transferência. - If your SSH public key file has a different name than the example code, modify the filename to match your current setup. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. + Se o seu arquivo de chave pública SSH tiver um nome diferente do código de exemplo, modifique o nome do arquivo para corresponder à sua configuração atual. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. ```shell $ clip < ~/.ssh/id_ed25519.pub @@ -73,9 +73,9 @@ Depois de adicionar uma nova chave SSH à sua conta do {% data variables.product {% linux %} -1. Copy the SSH public key to your clipboard. +1. Copie a chave pública SSH para a sua área de transferência. - If your SSH public key file has a different name than the example code, modify the filename to match your current setup. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. + Se o seu arquivo de chave pública SSH tiver um nome diferente do código de exemplo, modifique o nome do arquivo para corresponder à sua configuração atual. Ao copiar sua chave, não adicione novas linhas nem espaços em branco. ```shell $ sudo apt-get install xclip 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 5bc590f1db2f..80387c3cc456 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 @@ -38,7 +38,7 @@ Os {% data variables.product.prodname_oauth_app %}s podem ter acesso de *leitura Os *escopos* são grupos de permissões nomeados que um {% data variables.product.prodname_oauth_app %} pode solicitar para acessar dados públicos e privados. -Quando quiser usar um {% data variables.product.prodname_oauth_app %} que se integre ao {% data variables.product.product_name %}, esse app permitirá que você saiba qual tipo de acesso aos seus dados será necessário. Se você conceder acesso ao app, este poderá executar ações em seu nome, como ler ou modificar os dados. Por exemplo, se você desejar usar um app que solicite o escopo `user:email`, o app terá acesso somente leitura aos seus endereços de e-mail privados. Para obter mais informações, consulte "[Sobre escopos para {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)". +Quando quiser usar um {% data variables.product.prodname_oauth_app %} que se integre ao {% data variables.product.product_name %}, esse app permitirá que você saiba qual tipo de acesso aos seus dados será necessário. Se você conceder acesso ao app, este poderá executar ações em seu nome, como ler ou modificar os dados. Por exemplo, se você desejar usar um app que solicite o escopo `user:email`, o app terá acesso somente leitura aos seus endereços de e-mail privados. Para obter mais informações, consulte "[Sobre escopos para {% data variables.product.prodname_oauth_app %}s](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)". {% tip %} 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 8c89752239ef..e4fc103944b9 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 @@ -32,7 +32,7 @@ Os aplicativos podem ter acesso de *leitura* ou *gravação* aos seus dados no { Os *escopos* são grupos nomeados de permissões que um aplicativo pode solicitar para acessar dados públicos e não públicos. -Quando você quiser usar um aplicativo de terceiro que se integre ao {% data variables.product.product_name %}, esse aplicativo permitirá que você saiba qual tipo de acesso aos seus dados será necessário. Se você conceder acesso ao aplicativo, este poderá executar ações em seu nome, como ler ou modificar os dados. Por exemplo, se você desejar usar um app que solicite o escopo `user:email`, o app terá acesso somente leitura aos seus endereços de e-mail privados. Para obter mais informações, consulte "[Sobre escopos para {% data variables.product.prodname_oauth_app %}s](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)". +Quando você quiser usar um aplicativo de terceiro que se integre ao {% data variables.product.product_name %}, esse aplicativo permitirá que você saiba qual tipo de acesso aos seus dados será necessário. Se você conceder acesso ao aplicativo, este poderá executar ações em seu nome, como ler ou modificar os dados. Por exemplo, se você desejar usar um app que solicite o escopo `user:email`, o app terá acesso somente leitura aos seus endereços de e-mail privados. Para obter mais informações, consulte "[Sobre escopos para {% data variables.product.prodname_oauth_app %}s](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)". {% tip %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/creating-a-strong-password.md b/translations/pt-BR/content/github/authenticating-to-github/creating-a-strong-password.md index e27c96d6cc45..a015cb83a6b8 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/creating-a-strong-password.md +++ b/translations/pt-BR/content/github/authenticating-to-github/creating-a-strong-password.md @@ -9,7 +9,7 @@ versions: enterprise-server: '*' --- -You must choose or generate a password for your {% data variables.product.product_name %} account that is at least: +Você deve escolher ou gerar uma senha para sua conta de {% data variables.product.product_name %} pelo menos: - Oito caracteres, se incluir um número e uma letra minúscula, ou - 16 caracteres com qualquer combinação de caracteres diff --git a/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index a0bee2047379..4145c6aaf640 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/pt-BR/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -100,7 +100,7 @@ Antes de adicionar uma nova chave SSH ao ssh-agent para gerenciar suas chaves, v {% note %} - **Note:** If you chose not to add a passphrase to your key, you should omit the `UseKeychain` line. + **Observação:** Se você optou por não adicionar uma frase secreta à sua chave, você deve omitir a linha `UseKeychain`. {% endnote %} @@ -110,7 +110,7 @@ Antes de adicionar uma nova chave SSH ao ssh-agent para gerenciar suas chaves, v ``` {% note %} - **Observação:** a opção `-K` está presente na versão padrão da Apple do `ssh-add` e armazena a frase secreta no keychain quando você adiciona uma chave SSH ao ssh-agent. If you chose not to add a passphrase to your key, run the command without the `-K` option. + **Observação:** a opção `-K` está presente na versão padrão da Apple do `ssh-add` e armazena a frase secreta no keychain quando você adiciona uma chave SSH ao ssh-agent. Se você optou por não adicionar uma frase secreta à sua chave, execute o comando sem a opção `-K`. Caso não tenha a versão standard da Apple instalada, você poderá receber uma mensagem de erro. Para obter mais informações sobre como resolver esse erro, consulte "[Erro: ssh-add: opção ilícita -- K](/articles/error-ssh-add-illegal-option-k)". @@ -126,8 +126,8 @@ Antes de adicionar uma nova chave SSH ao ssh-agent para gerenciar suas chaves, v 1. Certifique-se de que o ssh-agent está em execução. Você pode usar as instruções "Lançamento automático do ssh-agent" em "[Trabalhando com palavras-chave SSH](/articles/working-with-ssh-key-passphrases)" ou iniciá-lo manualmente: ```shell - # inicie o ssh-agent em segundo plano - $ eval $(ssh-agent -s) + # start the ssh-agent in the background + $ eval `ssh-agent -s` > Agent pid 59566 ``` 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 a04967ebe8f4..6fb0957ee466 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 @@ -40,7 +40,7 @@ Para substituir todo o texto relacionado no `passwords.txt` sempre que ele for e $ bfg --replace-text passwords.txt ``` -After the sensitive data is removed, you must force push your changes to {% data variables.product.product_name %}. +Depois que os dados confidenciais são removidos, você deve fazer push forçado das suas alterações para {% data variables.product.product_name %}. ```shell $ git push --force 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 ba3e70593d86..1afd31e56c4d 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: 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.' +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 %}.' redirect_from: - /articles/keeping-your-application-access-tokens-safe/ - /articles/keeping-your-ssh-keys-and-application-access-tokens-safe/ @@ -11,32 +11,31 @@ versions: github-ae: '*' --- -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. +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. {% mac %} {% 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. 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) {% 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. + **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. {% endtip %} -4. Open Terminal. +4. Abra o terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@3.0" %}If you're using OpenSSH 6.7 or older: +6. Encontre e anote a impressão digital da chave pública. {% if currentVersion ver_lt "enterprise-server@3.0" %}Se você estiver usando OpenSSH 6.7 ou anterior: ```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) ``` - If you're using OpenSSH 6.8 or newer: + Se estiver usando OpenSSH 6.8 ou posterior: ```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) @@ -47,7 +46,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an > 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. +7. As chaves SSH keys {% data variables.product.product_name %} devem corresponder às chaves no computador. {% endmac %} @@ -55,28 +54,28 @@ 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. Na página das chaves SSH, anote as chaves SSH associadas à sua conta. Aqueles que você não reconhece, ou que estão desatualizados, clique em **Excluir**. Se houver chaves SSH válidas que deseja manter, clique em Approve (Aprovar). + ![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. + **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. {% 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. +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. 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 currentVersion ver_lt "enterprise-server@3.0" %}If you're using OpenSSH 6.7 or older: +6. Encontre e anote a impressão digital da chave pública. {% if currentVersion ver_lt "enterprise-server@3.0" %}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) ``` - If you're using OpenSSH 6.8 or newer: + Se estiver usando OpenSSH 6.8 ou posterior: ```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) @@ -87,7 +86,7 @@ You can delete unauthorized (or possibly compromised) SSH keys to ensure that an > 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. +7. As chaves SSH keys {% data variables.product.product_name %} devem corresponder às chaves no computador. {% endwindows %} @@ -95,42 +94,40 @@ 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. Na página das chaves SSH, anote as chaves SSH associadas à sua conta. Aqueles que você não reconhece, ou que estão desatualizados, clique em **Excluir**. Se houver chaves SSH válidas que deseja manter, clique em Approve (Aprovar). + ![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. + **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. {% endtip %} -4. Open Terminal. +4. Abra o terminal. 5. {% data reusables.command_line.start_ssh_agent %} -6. Find and take a note of your public key fingerprint. {% if currentVersion ver_lt "enterprise-server@3.0" %}If you're using OpenSSH 6.7 or older: +6. Encontre e anote a impressão digital da chave pública. {% if currentVersion ver_lt "enterprise-server@3.0" %}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) ``` - If you're using OpenSSH 6.8 or newer: + Se estiver usando OpenSSH 6.8 ou posterior: ```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 %} +```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. +7. As chaves SSH keys {% data variables.product.product_name %} *devem* corresponder às chaves no computador. {% endlinux %} {% warning %} -**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. +**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. {% endwarning %} diff --git a/translations/pt-BR/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/pt-BR/content/github/authenticating-to-github/testing-your-ssh-connection.md index 3ba0077c486f..2472ac868d5c 100644 --- a/translations/pt-BR/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/pt-BR/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -31,7 +31,7 @@ Quando você testar a conexão, precisará autenticar essa ação usando sua sen > Tem certeza de que deseja continuar com a conexão (sim/não)? ``` -3. Verifique se a impressão digital na mensagem exibida corresponde à das mensagens na etapa 2 e digite `sim`: +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Olá, username! You've successfully authenticated, but GitHub does not > provide shell access. 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 7194c19e9328..137e9ef8b02e 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 @@ -13,7 +13,7 @@ Depois que você cria modelos de problema e pull request no repositório, os con {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -You can create default issue and pull request templates for your organization or user account. 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 problemas padrão e modelos de pull request para a sua organização ou conta de usuário. 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)." {% endif %} 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 000344a0b7b8..6e0beec462d1 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.' +title: About wikis +intro: 'You can host documentation for your repository in a wiki, so that others can use and contribute to your project.' redirect_from: - /articles/about-github-wikis/ - /articles/about-wikis @@ -11,18 +11,18 @@ versions: github-ae: '*' --- -Cada repositório do {% data variables.product.product_name %} é equipado com uma seção para hospedar documentação, chamada de wiki. Você pode usar o wiki do repositório para compartilhar conteúdo longo sobre seu projeto, por exemplo, como usá-lo, como ele foi projetado ou seus princípios básicos. Um arquivo LEIAME informa rapidamente o que seu projeto pode fazer, enquanto você pode usar um wiki para fornecer documentação adicional. Para obter mais informações, consulte "[Sobre LEIAME](/articles/about-readmes)". +Every {% data variables.product.product_name %} repository comes equipped with a section for hosting documentation, called a wiki. You can use your repository's wiki to share long-form content about your project, such as how to use it, how you designed it, or its core principles. A README file quickly tells what your project can do, while you can use a wiki to provide additional documentation. For more information, see "[About READMEs](/articles/about-readmes)." -Com wikis, é possível gravar conteúdo assim como em qualquer outro lugar no {% data variables.product.product_name %}. Para obter mais informações, consulte "[Começando a escrever e formatar no {% data variables.product.prodname_dotcom %}](/articles/getting-started-with-writing-and-formatting-on-github)". Usamos [nossa biblioteca de markup de código aberto](https://github.com/github/markup) para converter diferentes formatos em HTML, de modo que seja possível optar por escrever em markdown ou qualquer outro formato compatível. +With wikis, you can write content just like everywhere else on {% data variables.product.product_name %}. For more information, see "[Getting started with writing and formatting on {% data variables.product.prodname_dotcom %}](/articles/getting-started-with-writing-and-formatting-on-github)." We use [our open-source Markup library](https://github.com/github/markup) to convert different formats into HTML, so you can choose to write in Markdown or any other supported format. -{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}If you create a wiki in a public repository, the wiki is available to {% if enterpriseServerVersions contains currentVersion %}anyone with access to {% data variables.product.product_location %}{% else %}the public{% endif %}. {% endif %}If you create a wiki in an internal or private repository, {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}people{% elsif currentVersion == "github-ae@latest" %}enterprise members{% endif %} with access to the repository can also access the wiki. Para obter mais informações, consulte "[Configurar visibilidade do repositório](/articles/setting-repository-visibility)". +{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}If you create a wiki in a public repository, the wiki is available to {% if enterpriseServerVersions contains currentVersion %}anyone with access to {% data variables.product.product_location %}{% else %}the public{% endif %}. {% endif %}If you create a wiki in an internal or private repository, {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}people{% elsif currentVersion == "github-ae@latest" %}enterprise members{% endif %} with access to the repository can also access the wiki. For more information, see "[Setting repository visibility](/articles/setting-repository-visibility)." -Você pode editar wikis diretamente no {% data variables.product.product_name %} ou editar arquivos wiki localmente. By default, only people with write access to your repository can make changes to wikis, although you can allow everyone on {% data variables.product.product_location %} to contribute to a wiki in {% if currentVersion == "github-ae@latest" %}an internal{% else %}a public{% endif %} repository. Para obter mais informações, consulte "[Alterar permissões de acesso para wikis](/articles/changing-access-permissions-for-wikis)". +You can edit wikis directly on {% data variables.product.product_name %}, or you can edit wiki files locally. By default, only people with write access to your repository can make changes to wikis, although you can allow everyone on {% data variables.product.product_location %} to contribute to a wiki in {% if currentVersion == "github-ae@latest" %}an internal{% else %}a public{% endif %} repository. For more information, see "[Changing access permissions for wikis](/articles/changing-access-permissions-for-wikis)". -### Leia mais +### Further reading -- "[Adicionar ou editar páginas wiki](/articles/adding-or-editing-wiki-pages)" -- "[Criar um footer ou uma barra lateral para seu wiki](/articles/creating-a-footer-or-sidebar-for-your-wiki)" -- "[Editar conteúdo do wiki](/articles/editing-wiki-content)" -- "[Exibir histórico de alterações de um wiki](/articles/viewing-a-wiki-s-history-of-changes)" -- "[Pesquisar wikis](/articles/searching-wikis)" +- "[Adding or editing wiki pages](/articles/adding-or-editing-wiki-pages)" +- "[Creating a footer or sidebar for your wiki](/articles/creating-a-footer-or-sidebar-for-your-wiki)" +- "[Editing wiki content](/articles/editing-wiki-content)" +- "[Viewing a wiki's history of changes](/articles/viewing-a-wiki-s-history-of-changes)" +- "[Searching wikis](/articles/searching-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 70d05686ec07..659ccf64980d 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 @@ -15,7 +15,7 @@ Para direcionar pessoas a recursos de suporte específicos, é possível adicion {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -You can create default support resources for your organization or user account. 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 ou conta de usuário. 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)." {% endif %} 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 1600460033a1..60f912e3bb5c 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 @@ -58,4 +58,4 @@ Caso tenha dúvidas, estes são alguns bons exemplos de diretrizes de contribui ### Leia mais - 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 %}{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -- "[Adding a license to a repository](/articles/adding-a-license-to-a-repository)"{% endif %} +- "[Adicionar uma licença a um repositório](/articles/adding-a-license-to-a-repository)"{% endif %} 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 50bda0bf5de4..e4df9034b362 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 @@ -23,7 +23,7 @@ Você deve ter acesso de gravação em um repositório para criar um branch, abr ### 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. The default branch is also the initial branch that Git checks out locally when someone clones the repository. {% data reusables.branches.default-branch-automatically-base-branch %} +{% 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 %} 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. 2" or currentVersion == "github-ae@latest" %}`principal`{% else %}`master`{% endif %} em qualquer novo repositório. @@ -75,7 +75,7 @@ Quando um branch estiver protegido: - 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 verificação de 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 == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -- If you use {% data variables.product.prodname_dotcom %}'s conflict editor to fix conflicts for a pull request that you created from a protected branch, {% data variables.product.prodname_dotcom %} helps you to create an alternative branch for the pull request, so that your resolution of the conflicts can be merged. 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 %} +- Se você usar o editor de conflitos do {% data variables.product.prodname_dotcom %}para corrigir conflitos para uma solicitação de pull request que você criou a partir de um branch protegido, {% data variables.product.prodname_dotcom %} ajudará você a criar um branch alternativo para a solicitação de pull request, para que a resolução dos 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/automatically-merging-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..8da18bc914e9 --- /dev/null +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: Fazer merge automático de um pull request +intro: 'Você pode aumentar a velocidade de desenvolvimento permitindo o merge automático de um pull request para que o pull request seja mesclado automaticamente quando todos os requisitos de merge forem atendidos.' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### Sobre o merge automático + +Se você habilitar o merge automático para um pull request, este será mesclado automaticamente quando todas as revisões necessárias forem atendidas e as verificações de status forem aprovadas. O merge automático impede que você espere que os sejam atendidos para que você possa passar para outras tarefas. + +Antes de usar o merge automático com um pull request, o merge automático deve ser habilitado para o repositório. Para obter mais informações, consulte "[Gerenciar merge automático para pull requests no seu repositório](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository). + +Você pode fornecer feedback sobre o merge automático [entrando em contato conosco](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback). + +### Habilitar merge automático + +Pessoas com permissões de gravação em um repositório podem habilitar o merge automático em um pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. Na lista "Pull Requests", clique no pull request para o qual você deseja fazer o merge automático. +1. Opcionalmente, para escolher um método de merge, selecione o menu suspenso **Habilitar merge automático** e, em seguida, clique em um método de merge. Para obter mais informações, consulte "[Sobre merges da pull request](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)". ![Menu suspenso "Habilitar merge automático"](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. Clique **Habilitar merge automático**. ![Botão para habilitar merge automático](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. Se você escolheu os métodos de merge ou combinação por squash, digite uma mensagem de commit e a descrição e escolha o endereço de e-mail que você deseja criar o commimt de merge.![Campos para inserir mensagem de commit e descrição e escolher o e-mail do autor do commit](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. Clique em **Confirmar merge automático**. ![Botão para confirmar o merge automático](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### Desabilitar o merge automático + +As pessoas com permissões de gravação em um repositório e autores de pull request podem desabilitar o merge automático em um pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. Na lista "Pull Requests", clique no pull request para o qual você deseja desabilitar o merge automático. +1. Na caixa de merge, clique em **Desabilitar o merge automático**. ![Botão para desabilitar o merge automático](/assets/images/help/pull_requests/disable-auto-merge-button.png) diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md index 238825ad3e6b..5da7d3f78203 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md @@ -3,7 +3,7 @@ title: Criando uma pull request a partir de uma bifurcação intro: É possível criar uma pull request para propor alterações que você fez em uma bifurcação de um repositório upstream. redirect_from: - /articles/creating-a-pull-request-from-a-fork -permissions: Qualquer pessoa com acesso de gravação a um repositório pode criar uma pull request a partir de uma bifurcação pertencente ao usuário. +permissions: Anyone with write access to a repository can create a pull request from a user-owned fork. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md index 67485ea4ceb1..4519e70db3a4 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/creating-and-deleting-branches-within-your-repository.md @@ -24,7 +24,7 @@ versions: {% note %} -**Note:** 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)." +**Observação:** Se o branch que você deseja excluir for o branch padrão do repositório, você deverá escolher um novo branch padrão antes de excluir o branch. For more information, see "[Setting the default branch](/github/administering-a-repository/setting-the-default-branch)." {% endnote %} diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/index.md index c31fdfcdae60..6db5a8797e2c 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 4665ca5c1857..f6ec4ef7e35f 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 @@ -14,6 +14,8 @@ versions: Em uma pull request, você propõe que as alterações feitas em um branch head sejam mescladas em um branch base. {% data reusables.pull_requests.about-protected-branches %} No entanto, pode haver restrições sobre quando você pode fazer merge de um pull request em um branch específico. Por exemplo, você só pode fazer merge de um pull request no branch-padrão se as verificações de status necessárias forem aprovadas. Para obter mais informações, consulte "[Sobre branches protegidos](/github/administering-a-repository/about-protected-branches)". +{% data reusables.pull_requests.you-can-auto-merge %} + Se a pull request apresenta conflitos de merges ou se você deseja testar as alterações antes de fazer merge, é possível [fazer checkout da pull request localmente](/articles/checking-out-pull-requests-locally) e fazer merge usando a linha de comando. Você não pode realizar o merge de um rascunho de um pull request. Para obter mais informações sobre pull requests em rascunho, consulte "[Sobre pull requests](/articles/about-pull-requests#draft-pull-requests)". diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md index 18bdb4369039..ddbc77cdfaf7 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request.md @@ -1,74 +1,74 @@ --- -title: Reviewing dependency changes in a pull request -intro: 'If a pull request contains changes to dependencies, you can view a summary of what has changed and whether there are known vulnerabilities in any of the dependencies.' +title: Revendo alterações de dependência em um pull request +intro: 'Se um pull request tiver alterações nas dependências, você poderá ver um resumo do que alterou e se há vulnerabilidades conhecidas em qualquer uma das dependências.' versions: free-pro-team: '*' --- {% note %} -**Note:** Dependency review is currently in beta and subject to change. +**Observação:** A revisão de dependências está atualmente em fase beta e sujeita a alterações. {% endnote %} -### About dependency review +### Sobre revisão de dependências -If a pull request targets your repository's default branch and contains changes to package manifests or lock files, you can display a dependency review to see what has changed. The dependency review includes details of changes to indirect dependencies in lock files, and it tells you if any of the added or updated dependencies contain known vulnerabilities. +Se um pull request for direcionado ao branch padrão do seu repositório e contiver alterações em manifestos de pacote ou arquivos de bloqueio, você poderá exibir um comentário de dependência para ver o que foi alterado. A revisão de dependências inclui detalhes de alterações nas dependências indiretas nos arquivos de bloqueio, e informa a você se alguma das dependências adicionadas ou atualizadas contém vulnerabilidades conhecidas. -Dependency review is available in: +Revisão de dependência está disponível em: -* All public repositories. -* Private repositories owned by organizations with an {% data variables.product.prodname_advanced_security %} license that have the dependency graph enabled. Para obter mais informações, consulte "[Explorar as dependências de um repositório](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". +* Todos os repositórios públicos. +* Repositórios privados pertencentes a organizações com uma licença de {% data variables.product.prodname_advanced_security %} com o gráfico de dependências habilitado. Para obter mais informações, consulte "[Explorar as dependências de um repositório](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". -Sometimes you might just want to update the version of one dependency in a manifest and generate a pull request. However, if the updated version of this direct dependency also has updated dependencies, your pull request may have more changes than you expected. The dependency review for each manifest and lock file provides an easy way to see what has changed, and whether any of the new dependency versions contain known vulnerabilities. +Às vezes, você pode apenas querer atualizar a versão de uma dependência em um manifesto e gerar um pull request. No entanto, se a versão atualizada desta dependência direta também atualizou as dependências, seu pull request pode ter mais alterações do que o esperado. A revisão de dependência para cada manifesto e arquivo de bloqueio fornece uma maneira fácil de ver o que foi alterado e se alguma das novas versões de dependências contém vulnerabilidades conhecidas. -By checking the dependency reviews in a pull request, and changing any dependencies that are flagged as vulnerable, you can avoid vulnerabilities being added to your project. {% data variables.product.prodname_dependabot_alerts %} will find vulnerabilities that are already in your dependencies, but it's much better to avoid introducing potential problems than to fix them at some later date. 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#dependabot-alerts-for-vulnerable-dependencies)". +Ao verificar as revisões de dependências em um pull request e alterar todas as dependências sinalizadas como vulneráveis, você pode evitar que vulnerabilidades sejam adicionadas ao seu projeto. {% data variables.product.prodname_dependabot_alerts %} encontrará vulnerabilidades que já estão em suas dependências, mas é muito melhor evitar a introdução de possíveis problemas do que corrigi-los posteriormente. 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#dependabot-alerts-for-vulnerable-dependencies)". -Dependency review supports the same languages and package management ecosystems as the dependency graph. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)". +A revisão de dependências é compatível com as mesmas linguagens e os mesmos ecossistemas de gestão de pacotes do gráfico de dependência. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)". -### Reviewing dependencies in a pull request +### Revisar as dependências em um pull request {% data reusables.repositories.sidebar-pr %} {% data reusables.repositories.choose-pr-review %} {% data reusables.repositories.changed-files %} -1. If the pull request contains many files, use the **File filter** drop-down menu to collapse all files that don't record dependencies. This will make it easier to focus your review on the dependency changes. +1. Se o pull request contiver muitos arquivos, use o menu suspenso **Filtro de arquivo** para recolher todos os arquivos que não registram dependências. Isso fará com que seja mais fácil focar a sua revisão nas alterações de dependência. - ![The file filter menu](/assets/images/help/pull_requests/file-filter-menu-json.png) + ![Menu de filtro de arquivos](/assets/images/help/pull_requests/file-filter-menu-json.png) -1. On the right of the header for a manifest or lock file, display the dependency review by clicking the rich diff button. +1. À direita do cabeçalho para um manifesto ou arquivo de bloqueio, mostre a revisão de dependências clicando no botão de diff avançado. - ![The rich diff button](/assets/images/help/pull_requests/dependency-review-rich-diff.png) + ![Botão de diff avançado](/assets/images/help/pull_requests/dependency-review-rich-diff.png) {% note %} - **Note:** The dependency review provides a clearer view of what has changed in large lock files, where the source diff is not rendered by default. + **Observação:** A revisão de dependências fornece uma visão mais clara do que foi alterado em arquivos de bloqueio grandes, em que o diff de origem não é renderizado por padrão. {% endnote %} -1. Check the dependencies listed in the dependency review. +1. Verifique as dependências listadas na revisão sobre dependências. - ![Vulnerability warnings in a dependency review](/assets/images/help/pull_requests/dependency-review-vulnerability.png) + ![Alertas de vulnerabilidade em revisão de dependências](/assets/images/help/pull_requests/dependency-review-vulnerability.png) - Any added or changed dependencies that have vulnerabilities are listed first, ordered by severity and then by dependency name. This means that the highest severity dependencies are always at the top of a dependency review. Other dependencies are listed alphabetically by dependency name. + Quaisquer dependências adicionadas ou alteradas com vulnerabilidades são listadas primeiro, ordenadas por gravidade e, posteriormente, pelo nome da dependência. Isso significa que as dependências de severidade mais elevadas estão sempre na parte superior de uma revisão de dependência. Outras dependências estão listadas em ordem alfabética pelo nome das dependências. - The icon beside each dependency indicates whether the dependency has been added ({% octicon "diff-added" aria-label="Dependency added icon" %}), updated ({% octicon "diff-modified" aria-label="Dependency modified icon" %}), or removed ({% octicon "diff-removed" aria-label="Dependency removed icon" %}) in this pull request. + O ícone ao lado de cada dependência indica se a dependência foi adicionada ({% octicon "diff-added" aria-label="Dependency added icon" %}), atualizada ({% octicon "diff-modified" aria-label="Dependency modified icon" %}) ou removida ({% octicon "diff-removed" aria-label="Dependency removed icon" %}) neste pull request. - Other information includes: + Outras informações incluem: - * The version, or version range, of the new, updated, or deleted dependency. - * For a specific version of a dependency: - * The age of that release of the dependency. - * The number of projects that are dependent on this software. This information is taken from the dependency graph. Checking the number of dependents can help you avoid accidentally adding the wrong dependency. - * The license used by this dependency, if this information is available. This is useful if you want to avoid code with certain licenses being used in your project. + * A versão, ou intervalo de versão, da nova dependência, atualizada ou excluída. + * Para uma versão específica de uma dependência: + * A idade daquela versão da dependência. + * O número de projetos que são dependentes deste software. Essa informação é tirada do gráfico de dependências. Verificar o número de dependentes pode ajudar você a evitar adicionar acidentalmente a dependência incorreta. + * A licença usada por esta dependência, se estas informações estiverem disponíveis. Isso é útil se você desejar evitar o código com certas licenças usadas no seu projeto. - Where a dependency has a known vulnerability, the warning message includes: + Quando uma dependência tem uma vulnerabilidade conhecida, a mensagem de aviso inclui: - * A brief description of the vulnerability. - * A Common Vulnerabilities and Exposures (CVE) or {% data variables.product.prodname_security_advisories %} (GHSA) identification number. You can click this ID to find out more about the vulnerability. - * The severity of the vulnerability. - * The version of the dependency in which the vulnerability was fixed. If you are reviewing a pull request for someone, you might ask the contributor to update the dependency to the patched version, or a later release. + * Uma breve descrição da vulnerabilidade. + * Vvulnerabilidades e Exposições Comuns (CVE) ou um número de identificação de {% data variables.product.prodname_security_advisories %} (GHSA). Você pode clicar nesse ID para saber mais sobre a vulnerabilidade. + * A gravidade da vulnerabilidade. + * A versão da dependência na qual a vulnerabilidade foi corrigida. Se você estiver revisando um pull request para alguém, você pode pedir ao contribuidor para atualizar a dependência para a versão corrigida ou para uma versão posterior. -1. You can return to the original view of the file by clicking the source diff button. +1. Você pode retornar para a visualização original do arquivo clicando no botão de diff de fonte. - ![The source diff button](/assets/images/help/pull_requests/dependency-review-source-diff.png) + ![Botão de diff de fonte](/assets/images/help/pull_requests/dependency-review-source-diff.png) 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 1536c3211a75..877349b5cdcd 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 @@ -30,15 +30,15 @@ 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" %} -### Reviewing dependency changes +### Revisar alterações de dependência -If the pull request contains changes to dependencies you can use the dependency review for a manifest or lock file to see what has changed and check whether the changes introduce security vulnerabilities. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." +Se o pull request contiver alterações em dependências, você poderá usar a revisão de dependências para um manifesto ou arquivo de bloqueio para ver o que mudou e verificar se as alterações introduzem vulnerabilidades de segurança. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." {% data reusables.repositories.changed-files %} -1. On the right of the header for a manifest or lock file, display the dependency review by clicking the rich diff button. +1. À direita do cabeçalho para um manifesto ou arquivo de bloqueio, mostre a revisão de dependências clicando no botão de diff avançado. - ![The rich diff button](/assets/images/help/pull_requests/dependency-review-rich-diff.png) + ![Botão de diff avançado](/assets/images/help/pull_requests/dependency-review-rich-diff.png) {% endif %} ### Marcar um arquivo como visualizado diff --git a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md index cd90849609af..e4976bd6540e 100644 --- a/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md +++ b/translations/pt-BR/content/github/collaborating-with-issues-and-pull-requests/what-happens-to-forks-when-a-repository-is-deleted-or-changes-visibility.md @@ -56,7 +56,7 @@ Se um repositório privado passa a ser público e depois é excluído, as bifurc {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -#### Changing the visibility of an internal repository +#### Alterar a visibilidade de um repositório interno {% note %} @@ -64,11 +64,11 @@ Se um repositório privado passa a ser público e depois é excluído, as bifurc {% endnote %} -If the policy for your enterprise permits forking, any fork of an internal repository will be private. If you change the visibility of an internal repository, any fork owned by an organization or user account will remain private. +Se a política para a sua empresa permitir a bifurcação, qualquer bifurcação de um repositório interno será privado. Se você alterar a visibilidade de um repositório interno, qualquer bifurcação pertencente a uma organização ou conta de usuário continuará sendo privada. -##### Deleting the internal repository +##### Excluir o repositório interno -If you change the visibility of an internal repository and then delete the repository, the forks will continue to exist in a separate network. +Se você alterar a visibilidade de um repositório interno e, em seguida, excluir o repositório, as bifurcações continuarão a existir em uma rede separada. {% endif %} @@ -78,4 +78,4 @@ If you change the visibility of an internal repository and then delete the repos - "[Sobre bifurcações](/articles/about-forks)" - "[Gerenciando a política de bifurcação de seu repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)" - "[Gerenciar 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)" -- "{% if currentVersion == "free-pro-team@latest" %}[Enforcing repository management policies in your enterprise account](/github/setting-up-and-managing-your-enterprise/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-forking-private-or-internal-repositories){% else %}[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-on-forking-private-or-internal-repositories){% endif %}" +- "{% 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/enforcing-repository-management-policies-in-your-enterprise-account#enforcing-a-policy-on-forking-private-or-internal-repositories){% else %}[Aplicar políticas de gerenciamento do repositório na sua empresa](/admin/policies/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-on-forking-private-or-internal-repositories){% endif %}" 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 3a9d7d17170e..fa35031901cf 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 @@ -40,7 +40,7 @@ Para que os proprietários do código recebam solicitações de revisão, o arqu ### Sintaxe de CODEOWNERS -A CODEOWNERS file uses a pattern that follows most of the same rules used in [gitignore](https://git-scm.com/docs/gitignore#_pattern_format) files, with [some exceptions](#syntax-exceptions). O padrão é seguido por um ou mais nomes de usuário ou nomes de equipe do {% data variables.product.prodname_dotcom %} usando o formato padrão `@username` ou `@org/team-name`. Você também pode consultar um usuário por um endereço de e-mail que tenha sido adicionado à respectiva conta do {% data variables.product.product_name %}, por exemplo `user@example.com`. +Um arquivo CODEOWNERS usa um padrão que segue a maioria das mesmas regras usadas nos arquivos [gitignore](https://git-scm.com/docs/gitignore#_pattern_format), com [algumas exceções](#syntax-exceptions). O padrão é seguido por um ou mais nomes de usuário ou nomes de equipe do {% data variables.product.prodname_dotcom %} usando o formato padrão `@username` ou `@org/team-name`. Você também pode consultar um usuário por um endereço de e-mail que tenha sido adicionado à respectiva conta do {% data variables.product.product_name %}, por exemplo `user@example.com`. Se qualquer linha do seu arquivo CODEOWNERS contiver uma sintaxe inválida, o arquivo não será detectado e não será usado para solicitar revisões. #### Exemplo de um arquivo CODEOWNERS @@ -84,11 +84,11 @@ apps/ @octocat # subdirectories. /docs/ @doctocat ``` -#### Syntax exceptions -There are some syntax rules for gitignore files that do not work in CODEOWNERS files: -- Escaping a pattern starting with `#` using `\` so it is treated as a pattern and not a comment -- Using `!` to negate a pattern -- Using `[ ]` to define a character range +#### Exceções de sintaxe +Existem algumas regras de sintaxe para arquivos gitignore que não funcionam em arquivos CODEOWNERS: +- Fugir de um padrão que começa com `#` usando `\` para que seja tratado como um padrão e não como um comentário +- Usar `!` para negar um padrão +- Usar `[ ]` para definir um intervalo de caracteres 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 83db816a2919..a1bb1230702b 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 @@ -13,9 +13,9 @@ versions: ### Sobre READMEs -You can add a README file to a repository to communicate important information about your project. A README, along with a repository license{% if currentVersion == "free-pro-team@latest" %}, contribution guidelines, and a code of conduct{% elsif enterpriseServerVersions contains currentVersion %} and contribution guidelines{% endif %}, communicates expectations for your project and helps you manage contributions. +É possível adicionar um arquivo LEIAME a um repositório para comunicar informações importantes sobre o seu projeto. Um LEIAME, junto com uma licença de repositório{% if currentVersion == "free-pro-team@latest" %}, diretrizes de contribuição, e um código de conduta{% elsif enterpriseServerVersions contains currentVersion %} e diretrizes de contribuição{% endif %}, comunica as expectativas para o seu projeto e ajuda você a gerenciar contribuições. -For more information about providing guidelines for your project, see {% if currentVersion == "free-pro-team@latest" %}"[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" and {% endif %}"[Setting up your project for healthy contributions](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)." +Para obter mais informações sobre como fornecer diretrizes para o seu projeto, consulte {% if currentVersion == "free-pro-team@latest" %}"[Adicionar um código de conduta ao seu projeto](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)e {% endif %}"[Configurar o seu projeto para contribuições saudáveis](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)". Um README, muitas vezes, é o primeiro item que um visitante verá ao visitar seu repositório. Os arquivos README 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 a65e495f1c77..c28b4e307c25 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 @@ -1,6 +1,6 @@ --- title: Sobre repositórios -intro: A repository contains all of your project's files and each file's revision history. You can discuss and manage your project's work within the repository. +intro: Um repositório contém todos os arquivos do seu projeto e o histórico de revisão de cada arquivo. Você pode discutir e gerenciar o trabalho do projeto dentro do repositório. redirect_from: - /articles/about-repositories versions: @@ -22,11 +22,11 @@ Com Cada pessoa e organização podem ter repositórios ilimitados e convidar um número ilimitado de colaboradores para todos os repositórios. {% endif %} -You can use repositories to manage your work and collaborate with others. -- You can use issues to collect user feedback, report software bugs, and organize tasks you'd like to accomplish. For more information, see "[About issues](/github/managing-your-work-on-github/about-issues)." +Você pode usar repositórios para gerenciar seu trabalho e colaborar com outras pessoas. +- Você pode usar problemas para coletar feedback do usuário, relatar erros de software e organizar tarefas que você gostaria de realizar. Para obter mais informações, consulte "[Sobre problemas](/github/managing-your-work-on-github/about-issues)". - {% data reusables.discussions.you-can-use-discussions %} -- You can use pull requests to propose changes to a repository. Para obter mais informações, consulte "[Sobre pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests)". -- You can use project boards to organize and prioritize your issues and pull requests. Para obter mais informações, consulte "[Sobre quadros de projeto](/github/managing-your-work-on-github/about-project-boards)". +- É possível usar pull requests para propor alterações em um repositório. Para obter mais informações, consulte "[Sobre pull requests](/github/collaborating-with-issues-and-pull-requests/about-pull-requests)". +- Você pode usar quadros de projeto para organizar e priorizar seus problemas e pull requests. Para obter mais informações, consulte "[Sobre quadros de projeto](/github/managing-your-work-on-github/about-project-boards)". {% data reusables.repositories.repo-size-limit %} 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 6d96daa92fb0..40c6e4d0b960 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 %} -**Note:** If you publish your source code in a public repository on {% data variables.product.product_name %}, {% if currentVersion == "free-pro-team@latest" %}according to the [Terms of Service](/articles/github-terms-of-service), {% endif %}other users of {% data variables.product.product_location %} have the right to view and fork your repository. If you have already created a repository and no longer want users to have access to the repository, you can make the repository private. When you change the visibility of a repository to private, existing forks or local copies created by other users will still exist. Para obter mais informações, consulte "[Configurar visibilidade do repositório](/github/administering-a-repository/setting-repository-visibility)". +**Observação:** Se você publicar seu código-fonte em um repositório público em {% data variables.product.product_name %}, {% if currentVersion == "free-pro-team@latest" %}de acordo com os [Termos de Serviço](/articles/github-terms-of-service), {% endif %}outros usuários de {% data variables.product.product_location %} terão o direito de visualizar e bifurcar o seu repositório. Se você já criou um repositório e não quer mais que os usuários tenham acesso a ele, você pode torná-lo privado. Ao alterar a visibilidade de um repositório para privado, as bifurcações existentes ou cópias locais criadas por outros usuários continuarão existindo. Para obter mais informações, consulte "[Configurar visibilidade do repositório](/github/administering-a-repository/setting-repository-visibility)". {% endnote %} diff --git a/translations/pt-BR/content/github/customizing-your-github-workflow/about-github-marketplace.md b/translations/pt-BR/content/github/customizing-your-github-workflow/about-github-marketplace.md index 600dd155d7f2..33734a97e7ed 100644 --- a/translations/pt-BR/content/github/customizing-your-github-workflow/about-github-marketplace.md +++ b/translations/pt-BR/content/github/customizing-your-github-workflow/about-github-marketplace.md @@ -7,19 +7,19 @@ versions: free-pro-team: '*' --- -You can discover, browse, and install free and paid tools, including {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, and {% data variables.product.prodname_actions %}, in [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). +Você pode descobrir, navegar e instalar ferramentas gratuitas e pagas, incluindo {% data variables.product.prodname_github_app %}s, {% data variables.product.prodname_oauth_app %}s, e {% data variables.product.prodname_actions %} em [{% data variables.product.prodname_marketplace %}](https://github.com/marketplace). Ao comprar uma ferramenta paga, você pagará pela assinatura da sua ferramenta com as mesmas informações de cobrança usadas para pagar sua assinatura do {% data variables.product.product_name %} e receberá uma fatura na data regular da cobrança. Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)". -You may also have the option to select a free 14-day trial on some tools. É possível fazer o cancelamento a qualquer momento durante a avaliação, e você não será cobrado, mas perderá automaticamente o acesso à ferramenta. A assinatura paga começará a ser contada no fim da versão de avaliação de 14 dias. Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)". +Em algumas ferramentas, você tem a opção de selecionar uma avaliação gratuita de 14 dias. É possível fazer o cancelamento a qualquer momento durante a avaliação, e você não será cobrado, mas perderá automaticamente o acesso à ferramenta. A assinatura paga começará a ser contada no fim da versão de avaliação de 14 dias. Para obter mais informações, consulte "[Sobre a cobrança do {% data variables.product.prodname_marketplace %}](/articles/about-billing-for-github-marketplace)". -### Finding tools on {% data variables.product.prodname_marketplace %} +### Encontrar ferramentas em {% data variables.product.prodname_marketplace %} -You can discover, browse, and install apps and actions created by others on {% data variables.product.prodname_marketplace %}, see "[Searching {% data variables.product.prodname_marketplace %}](/github/searching-for-information-on-github/searching-github-marketplace)." +Você pode descobrir, navegar e instalar aplicativos e ações criados por outros em {% data variables.product.prodname_marketplace %}. Consulte "[Pesquisar {% data variables.product.prodname_marketplace %}](/github/searching-for-information-on-github/searching-github-marketplace)". {% data reusables.actions.actions-not-verified %} -Anyone can list a free {% data variables.product.prodname_github_app %} or {% data variables.product.prodname_oauth_app %} on {% data variables.product.prodname_marketplace %}. Publishers of paid apps are verified by {% data variables.product.company_short %} and listings for these apps are shown with a verified creator badge {% octicon "verified" aria-label="Verified creator badge" %}. You will also see badges for unverified and verified apps. These apps were published using the previous method for verifying individual apps. For more information about the current process, see "[About verified creators](/developers/github-marketplace/about-verified-creators)" and "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)." +Qualquer um pode listar um {% data variables.product.prodname_github_app %} ou {% data variables.product.prodname_oauth_app %} grátis em {% data variables.product.prodname_marketplace %}. Os editores de aplicativos pagos são verificados por {% data variables.product.company_short %} e os anúncios para esses aplicativos são exibidos com um selo criador verificado de {% octicon "verified" aria-label="Verified creator badge" %}. Você também verá selos para aplicativos não verificados e verificados. Esses apps foram publicados usando o método anterior para verificar aplicativos individuais. Para obter mais informações sobre o processo atual, consulte "[Sobre criadores verificados](/developers/github-marketplace/about-verified-creators)" e "[Requisitos para anunciar um aplicativo](/developers/github-marketplace/requirements-for-listing-an-app)". ### Criar e listar uma ferramenta no {% data variables.product.prodname_marketplace %} @@ -30,4 +30,4 @@ Para obter mais informações sobre a criação de sua própria ferramenta para - "[Comprar e instalar apps no {% data variables.product.prodname_marketplace %}](/articles/purchasing-and-installing-apps-in-github-marketplace)" - "[Gerenciar cobrança para aplicativos do {% data variables.product.prodname_marketplace %}](/articles/managing-billing-for-github-marketplace-apps)" - "[Suporte do {% data variables.product.prodname_marketplace %}](/articles/github-marketplace-support)" -- "[Differences between GitHub Apps and OAuth Apps](/developers/apps/differences-between-github-apps-and-oauth-apps)" +- "[Diferenças entre aplicativos aplicativos GitHub e OAuth](/developers/apps/differences-between-github-apps-and-oauth-apps)" 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 a9f780477721..6b15779dcd90 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 @@ -15,7 +15,7 @@ versions: {% data reusables.codespaces.about-configuration %} -Se você não definir uma configuração no repositório, o {% data variables.product.prodname_dotcom %} criará um código com uma imagem-base do Linux. The base Linux image includes tools for Python, Node.js, JavaScript, TypeScript, C++, Java, C#, F#, .NET Core, PHP, PowerShell, Go, Ruby, and Rust. Para obter mais informações sobre a imagem base do Linux, consulte o repositório [`microsoft/vscode-dev-containers`](https://github.com/microsoft/vscode-dev-containers/tree/master/containers/codespaces-linux). +Se você não definir uma configuração no repositório, o {% data variables.product.prodname_dotcom %} criará um código com uma imagem-base do Linux. A imagem de base do Linux inclui ferramentas para Python, Node.js, JavaScript, TypeScript, C++, Java, C#, F#, .NET Core, PHP, PowerShell, Go, Ruby e Rust. Para obter mais informações sobre a imagem base do Linux, consulte o repositório [`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 %} Para obter mais informações, consulte "[Personalizar {% data variables.product.prodname_codespaces %} para a sua conta](/github/developing-online-with-codespaces/personalizing-codespaces-for-your-account)". 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 index bac5176dd99b..396a30c642dd 100644 --- 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 @@ -46,12 +46,12 @@ A conexão ao {% data variables.product.prodname_github_codespaces %} com a pré ### Configurar um codespace para {% data variables.product.prodname_vs %} -A codespace, created with {% data variables.product.prodname_vs %}, can be customized through a new tool called devinit, a command line tool included with {% data variables.product.prodname_vs %}. +Um codespace, criado com {% data variables.product.prodname_vs %}, pode ser personalizado por meio de uma nova ferramenta denominada devinit, uma ferramenta de linha de comando incluída com {% data variables.product.prodname_vs %}. #### devinit -[devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) lets you install additional frameworks and tools into your Windows development codespaces, modify environment variables, and more. +[devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit) permite que você instale estruturas e ferramentas adicionais nos seus codespaces de desenvolvimento do Windows, modificar as variáveis de ambiente e muito mais. -devinit supports a configuration file called [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json). You can add this file to your project if you want to create a customized and repeatable development environment. When you use devinit with a [devcontainer.json](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces#running-devinit-when-creating-a-codespace) file, your codespaces will be automatically configured on creation. +O devinit é compatível com um arquivo de configuração denominado [devinit.json](https://docs.microsoft.com/visualstudio/devinit/devinit-json). Você pode adicionar este arquivo ao seu projeto se você desejar criar um ambiente de desenvolvimento personalizado e reproduzível. Ao usar devinit com um arquivo [devcontainer.json](https://docs.microsoft.com/visualstudio/ide/codespaces/customize-codespaces#running-devinit-when-creating-a-codespace), seus codespaces serão configurados automaticamente na criação. -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 %}. For more information about devinit, see [Getting started with devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit). +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 %}. Para obter mais informações sobre devinit, consulte [Primeiros passos com devinit](https://docs.microsoft.com/visualstudio/devinit/getting-started-with-devinit). 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 0cc5af03bec5..50dcf8d90b57 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 @@ -50,9 +50,9 @@ O padrão {% data variables.product.prodname_codeql_workflow %} usa o evento `pu 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)". -#### Avoiding unnecessary scans of pull requests +#### Evitar varreduras desnecessárias de pull requests -You might want to avoid a code scan being triggered on specific pull requests targeted against the default branch, irrespective of which files have been changed. You can configure this by specifying `on:pull_request:paths-ignore` or `on:pull_request:paths` in the {% data variables.product.prodname_code_scanning %} workflow. For example, if the only changes in a pull request are to files with the file extensions `.md` or `.txt` you can use the following `paths-ignore` array. +Você pode querer evitar que uma varredura de código seja acionada em pull requests específicos para o branch padrão, Independentemente de os arquivos terem sido alterados. Você pode configurar isso, especificando `no:pull_request:paths-ignore` ou `on:pull_request:paths` no fluxo de trabalho de {% data variables.product.prodname_code_scanning %}. Por exemplo, se as únicas alterações em um pull request são para arquivos com extensões de arquivo `.md` ou `.txt`, você poderá usar o seguinte array `paths-ignore`. ``` yaml on: @@ -69,12 +69,12 @@ on: **Observações** -* `on:pull_request:paths-ignore` and `on:pull_request:paths` set conditions that determine whether the actions in the workflow will run on a pull request. They don't determine what files will be analyzed when the actions _are_ run. When a pull request contains any files that are not matched by `on:pull_request:paths-ignore` or `on:pull_request:paths`, the workflow runs the actions and scans all of the files changed in the pull request, including those matched by `on:pull_request:paths-ignore` or `on:pull_request:paths`, unless the files have been excluded. For information on how to exclude files from analysis, see "[Specifying directories to scan](#specifying-directories-to-scan)." -* For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} workflow files, don't use the `paths-ignore` or `paths` keywords with the `on:push` event as this is likely to cause missing analyses. For accurate results, {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} needs to be able to compare new changes with the analysis of the previous commit. +* `on:pull_request:paths-ignore` e `on:pull_request:paths` definem condições que determinam se as ações no fluxo de trabalho serão executadas em um pull request. Eles não determinam quais arquivos serão analisados quando as ações _são_ executadas. Quando uma pull request contém quaisquer arquivos não correspondidos por `on:pull_request:paths-ignore` ou `on:pull_request:paths`, o fluxo de trabalho executa as ações e faz a varredura de todos os arquivos alterados no pull request, incluindo aqueles que correspondidos por `on:pull_request:paths-ignore` ou `on:pull_request:paths`, a menos que os arquivos tenham sido excluídos. Para obter informações sobre como excluir arquivos da análise, consulte "[Especificar diretórios a serem varridos](#specifying-directories-to-scan)". +* For {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} workflow files, don't use the `paths-ignore` or `paths` keywords with the `on:push` event as this is likely to cause missing analyses. Para resultados precisos, {% data variables.product.prodname_codeql %} {% data variables.product.prodname_code_scanning %} precisam conseguir comparar novas alterações com a análise do commit anterior. {% endnote %} -For more information about using `on:pull_request:paths-ignore` and `on:pull_request:paths` to determine when a workflow will run for a pull request, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)." +Para mais informações sobre como usar `on:pull_request:paths-ignore` e `on:pull_request:paths` para determinar quando um fluxo de trabalho será executado para um pull request, consulte "[sintaxe de fluxo de trabalho para {% data variables.product.prodname_actions %}](/actions/reference/workflow-syntax-for-github-actions#onpushpull_requestpaths)". #### Fazer a varredura de forma pré-programada @@ -257,7 +257,7 @@ Se você desejar apenas executar consultas personalizadas, você poderá desabil #### Especificar diretórios para serem varridos -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. You can exclude the files in specific directories from analysis by adding a `paths-ignore` array. +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 análises, adicionando um array de `paths-ignore`. ``` yaml paths: @@ -276,7 +276,7 @@ paths-ignore: {% endnote %} -For compiled languages, 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. 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 o fluxo de trabalho do {% data variables.product.prodname_codeql %} para linguagens compiladas](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-the-codeql-workflow-for-compiled-languages#adding-build-steps-for-a-compiled-language)". +Para linguagens compiladas, se você deseja limitar {% data variables.product.prodname_code_scanning %} a diretórios específicos no seu projeto, você deverá especificar os passos de compilação adequados 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 o fluxo de trabalho do {% data variables.product.prodname_codeql %} para linguagens compiladas](/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. @@ -292,9 +292,9 @@ Você pode rapidamente analisar pequenas partes de um monorepo ao modificar o c ### Acessar repositórios privados -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)". +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)". -For example, the following configuration has Git replace the full URLs to the `ghost/foo`, `ghost/bar`, and `ghost/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. +Por exemplo, a configuração a seguir faz com que o Git substitua todas as URLs para os repositórios de `ghost/foo`, `ghost/bar` e `ghost/baz` em {% data variables.product.prodname_dotcom_the_website %} pelas URLs que incluem o token de acesso pessoal que você armazena na variável de ambiente de `ACCESS_TOKEN`. {% raw %} ```yaml 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 index 505a6b96b74e..39018f0f9fd2 100644 --- 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 @@ -54,7 +54,7 @@ No Windows, o arquivo `codeql-runner-win.exe` normalmente não exige alteração Após concluído o download do {% data variables.product.prodname_codeql_runner %} e verificado que pode ser executado, você deve disponibilizar o executor para cada servidor de CI que você pretende usar para {% data variables.product.prodname_code_scanning %}. É importante notar que cada servidor de CI que você pretende usar para {% data variables.product.prodname_code_scanning %} deve ter o {% data variables.product.prodname_codeql_runner %}. Você pode configurar cada servidor para copiar o executor a partir de um local central interno ou você pode usar a API REST para obter o executor direto do GitHub, por exemplo: ```shell -wget https://github.com/github/codeql-action/releases/download/codeql-bundle-20200826/codeql-runner-linux +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux chmod +x codeql-runner-linux ``` @@ -129,7 +129,7 @@ Este exemplo é semelhante ao exemplo anterior. No entanto, desta vez, o reposit > ... > 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". - Exporte essas variáveis para processos futuros para que a criação possa ser rastreada, por exemplo, executando " + Exporte essas variáveis para processos futuros para que o CodeQL possa monitorar a compilação, por exemplo, executando " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` 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 c5ec080b0f1c..21e58a4ac073 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 @@ -16,7 +16,7 @@ Você pode armazenar vários projetos nos repositórios do {% data variables.pro {% elsif enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} -You can store a variety of projects in {% data variables.product.product_name %} repositories, including innersource projects. With innersource, you can share code to make better, more reliable software. For more information on innersource, see {% data variables.product.company_short %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." +Você pode armazenar uma série de projetos em repositórios de {% data variables.product.product_name %}, incluindo projetos de innersource. Com o innersource, você pode compartilhar código para criar um software melhor e mais confiável. Para obter mais informações sobre innersource, consulte o whitepaper de {% data variables.product.company_short %}"[Uma introdução ao innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)". {% endif %} 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 6005c371c7c4..fbc8fd2f589d 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 @@ -25,7 +25,7 @@ Por exemplo, você pode usar bifurcações para propor alterações relacionadas O software de código aberto baseia-se na ideia de que ao compartilhar códigos, podemos criar softwares melhores e mais confiáveis. Para obter mais informações, consulte "[Sobre a Iniciativa Open Source](http://opensource.org/about)" em Iniciativa Open Source. -For more information about applying open source principles to your organization's development work on {% data variables.product.product_location %}, see {% data variables.product.prodname_dotcom %}'s whitepaper "[An introduction to innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." +Para obter mais informações sobre a aplicação dos princípios de código aberto ao trabalho de desenvolvimento da sua organização em {% data variables.product.product_location %}, consulte o white paper de {% data variables.product.prodname_dotcom %} "[Uma introdução ao innersource](https://resources.github.com/whitepapers/introduction-to-innersource/)." {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} diff --git a/translations/pt-BR/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md b/translations/pt-BR/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md index 184e6bfdfb2d..18179f1f4d75 100644 --- a/translations/pt-BR/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md +++ b/translations/pt-BR/content/github/getting-started-with-github/signing-up-for-a-new-github-account.md @@ -1,6 +1,6 @@ --- title: Fazer o registro em uma conta conta do GitHub -shortTitle: Sign up for a new GitHub account +shortTitle: Inscreva-se para uma nova conta no GitHub intro: 'O {% data variables.product.product_name %} oferece contas de usuário para pessoas e organizações para que equipes de pessoas trabalhem juntas.' redirect_from: - /articles/signing-up-for-a-new-github-account diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md index c499d62ca628..dce4a99695f4 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md @@ -1,24 +1,24 @@ --- -title: About managing vulnerable dependencies -intro: '{% data variables.product.prodname_dotcom %} helps you to avoid using third-party software that contains known vulnerabilities.' +title: Sobre a gestão de dependências vulneráveis +intro: '{% data variables.product.prodname_dotcom %} ajuda você a evitar o uso de software de terceiros que contém vulnerabilidades conhecidas.' versions: free-pro-team: '*' --- -{% data variables.product.prodname_dotcom %} provides the following tools for removing and avoiding vulnerable dependencies. +{% data variables.product.prodname_dotcom %} fornece as ferramentas a seguir para remover e evitar dependências vulneráveis. -#### Dependency graph -O gráfico de dependências é um resumo do manifesto e bloqueia arquivos armazenados em um repositório. It shows you the ecosystems and packages your codebase depends on (its dependencies) and the repositories and packages that depend on your project (its dependents). The information in the dependency graph is used by dependency review and {% data variables.product.prodname_dependabot %}. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)". +#### Gráfico de dependências +O gráfico de dependências é um resumo do manifesto e bloqueia arquivos armazenados em um repositório. Ele mostra os ecossistemas e pacotes dos quais a sua base de código depende (suas dependências) e os repositórios e pacotes que dependem do seu projeto (suas dependências). As informações no gráfico de dependências são usadas pela revisão das dependências e {% data variables.product.prodname_dependabot %}. Para obter mais informações, consulte "[Sobre o gráfico de dependência](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph)". -#### Dependency review -By checking the dependency reviews on pull requests you can avoid introducing vulnerabilities from dependencies into your codebase. If the pull requests adds a vulnerable dependency, or changes a dependency to a vulnerable version, this is highlighted in the dependency review. You can change the dependency to a patched version before merging the pull request. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." +#### Revisão de dependência +Ao verificar as revisões de dependências nos pull requests, você pode evitar a introdução de vulnerabilidades de dependências na sua base de código. Se os pull requests adicionarem uma dependência vulnerável, ou alterarem a dependência a uma versão vulnerável, isso será destacado na revisão de dependências. Você pode alterar a dependência para uma versão alterada antes de realizar o merge do pull request. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." #### {% data variables.product.prodname_dependabot_alerts %} -{% data variables.product.prodname_dotcom %} can create {% data variables.product.prodname_dependabot_alerts %} when it detects vulnerable dependencies in your repository. The alert is displayed on the Security tab for the repository. O alerta inclui um link para o arquivo afetado no projeto, e informações sobre uma versão corrigida. {% data variables.product.prodname_dotcom %} also notifies the maintainers of the repository, according to their notification preferences. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" +{% data variables.product.prodname_dotcom %} pode criar {% data variables.product.prodname_dependabot_alerts %} quando detectar dependências vulneráveis no seu repositório. O alerta é exibido na aba Segurança do repositório. O alerta inclui um link para o arquivo afetado no projeto, e informações sobre uma versão corrigida. {% data variables.product.prodname_dotcom %} também notifica os mantenedores do repositório, de acordo com as suas preferências de notificação. Para obter mais informações, consulte "[Sobre alertas para dependências vulneráveis](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)" #### {% data variables.product.prodname_dependabot_security_updates %} -When {% data variables.product.prodname_dotcom %} generates a {% data variables.product.prodname_dependabot %} alert for a vulnerable dependency in your repository, {% data variables.product.prodname_dependabot %} can automatically try to fix it for you. {% data variables.product.prodname_dependabot_security_updates %} are automatically generated pull requests that update a vulnerable dependency to a fixed version. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." +Quando {% data variables.product.prodname_dotcom %} gera um alerta de {% data variables.product.prodname_dependabot %} para uma dependência vulnerável no seu repositório, {% data variables.product.prodname_dependabot %} pode tentar corrigir automaticamente para você. {% data variables.product.prodname_dependabot_security_updates %} são pull requests gerados automaticamente que atualizam uma dependência vulnerável para uma versão fixa. Para obter mais informações, consulte "[Sobre {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." #### {% data variables.product.prodname_dependabot_version_updates %} -Enabling {% data variables.product.prodname_dependabot_version_updates %} takes the effort out of maintaining your dependencies. With {% data variables.product.prodname_dependabot_version_updates %}, whenever {% data variables.product.prodname_dotcom %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. By contrast, {% data variables.product.prodname_dependabot_security_updates %} only raises pull requests to fix vulnerable dependencies. For more information, see "[About Dependabot version updates](/github/administering-a-repository/about-dependabot-version-updates)." +Habilitar {% data variables.product.prodname_dependabot_version_updates %} remove o esforço de manter suas dependências. Com {% data variables.product.prodname_dependabot_version_updates %}, sempre que {% data variables.product.prodname_dotcom %} identifica uma dependência desatualizada, ele cria um pull request para atualizar o manifesto para a última versão da dependência. Em contrapartida, {% data variables.product.prodname_dependabot_security_updates %} apenas cria pull requests para corrigir dependências vulneráveis. Para obter mais informações, consulte "[Sobre atualizações da versão do Dependabot](/github/administering-a-repository/about-dependabot-version-updates)". diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md index f85505ecafb3..1ec7743a2f04 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies.md @@ -1,56 +1,58 @@ --- -title: Configuring notifications for vulnerable dependencies -shortTitle: Configuring notifications -intro: 'Optimize how you receive notifications about {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %}security{% endif %} alerts.' +title: Configurar notificações para dependências vulneráveis +shortTitle: Configurar notificações +intro: 'Otimiza como você recebe notificações sobre {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %}alertas de segurança{% endif %}.' versions: free-pro-team: '*' enterprise-server: '>=2.21' --- -### About notifications for vulnerable dependencies +### Sobre notificações para dependências vulneráveis -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}When {% data variables.product.prodname_dependabot %} detects vulnerable dependencies in your repositories, we generate a {% data variables.product.prodname_dependabot %} alert and display it on the Security tab for the repository. {% data variables.product.product_name %} notifies the maintainers of affected repositories about the new alert according to their notification preferences.{% else %}When {% data variables.product.product_name %} detects vulnerable dependencies in your repositories, it sends security alerts.{% endif %}{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.prodname_dependabot %} is enabled by default on all public repositories. For {% data variables.product.prodname_dependabot_alerts %}, by default, you will receive {% data variables.product.prodname_dependabot_alerts %} by email, grouped by the specific vulnerability. -{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}Quando {% data variables.product.prodname_dependabot %} detecta dependências vulneráveis nos seus repositórios, geramos um alerta {% data variables.product.prodname_dependabot %} e exibimo-lo na aba Segurança do repositório. {% data variables.product.product_name %} notifica os mantenedores dos repositórios afetados sobre o novo alerta de acordo com suas preferências de notificação.{% else %}Quando {% data variables.product.product_name %} detecta dependências vulneráveis no seu repositório, ele envia alertas de segurança.{% endif %}{% if currentVersion == "free-pro-team@latest" %} {% data variables.product.prodname_dependabot %} está habilitado por padrão em todos os repositórios públicos. Para {% data variables.product.prodname_dependabot_alerts %}, por padrão, você receberá {% data variables.product.prodname_dependabot_alerts %} por e-mail, agrupado pela vulnerabilidade específica. +{% endif %} -{% if currentVersion == "free-pro-team@latest" %}If you're an organization owner, you can enable or disable {% data variables.product.prodname_dependabot_alerts %} for all repositories in your organization with one click. You can also set whether the detection of vulnerable dependencies will be enabled or disabled for newly-created repositories. For more information, 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#enabling-or-disabling-a-feature-for-all-new-repositories-when-they-are-added)." +{% if currentVersion == "free-pro-team@latest" %}Se você é proprietário de uma organização, você pode habilitar ou desabilitar {% data variables.product.prodname_dependabot_alerts %} para todos os repositórios da sua organização com um clique. Você também pode definir se a detecção de dependências vulneráveis será habilitada ou desabilitada para repositórios recém-criados. Para obter mais informações, consulte "[Gerenciar configurações de segurança e análise para sua organização](/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization#enabling-or-disabling-a-feature-for-all-new-repositories-when-they-are-added)". {% endif %} {% if enterpriseServerVersions contains currentVersion and currentVersion == "enterprise-server@2.21" %} -Your site administrator needs to enable security alerts for vulnerable dependencies for {% data variables.product.product_location %} before you can use the feature. For more information, see "[Enabling alerts for vulnerable dependencies on {% data variables.product.prodname_ghe_server %}](/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)."{% endif %} +O administrador do seu site precisa habilitar alertas de segurança para dependências vulneráveis para +{% data variables.product.product_location %} antes de você poder usar o recurso. Para obter mais informações, consulte "[Habilitar alertas para dependências vulneráveis em {% data variables.product.prodname_ghe_server %}](/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server){% endif %} {% if enterpriseServerVersions contains currentVersion and currentVersion ver_gt "enterprise-server@2.20" %} -By default, if your site administrator has configured email for notifications on your enterprise, you will receive {% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} by email.{% endif %} +Por padrão, se o administrador do site tiver configurado e-mail para notificações na sua empresa, você receberá +{% if currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %} por e-mail.{% endif %} -{% if currentVersion ver_gt "enterprise-server@2.21" %}Site administrators can also enable {% data variables.product.prodname_dependabot_alerts %} without notifications. For more information, see "[Enabling {% data variables.product.prodname_dependabot_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 ver_gt "enterprise-server@2.21" %}Os administradores do site também podem habilitar {% data variables.product.prodname_dependabot_alerts %} sem notificações. Para obter mais informações, consulte "[Habilitar {% data variables.product.prodname_dependabot_alerts %} 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 %} -{% if currentVersion ver_lt "enterprise-server@2.22" %}Site administrators can also enable security alerts without notifications. For more information, see "[Enabling security 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 ver_lt "enterprise-server@2.22" %}Site administrators can also enable security alerts without notifications. Para obter mais informações, consulte "[Habilitar alertas de segurança para dependências vulneráveis no {% data variables.product.prodname_ghe_server %}](/enterprise/{{ currentVersion }}/admin/configuration/enabling-alerts-for-vulnerable-dependencies-on-github-enterprise-server)".{% 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 %} +### Configurar notificações para {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}alertas de segurança{% endif %} -You can configure notification settings for yourself or your organization from the Manage notifications drop-down {% octicon "bell" aria-label="The notifications bell" %} shown at the top of each page. For more information, see "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)." +Você pode definir as configurações de notificação para si mesmo ou para sua organização no menu suspenso Gerenciar notificações {% octicon "bell" aria-label="The notifications bell" %} exibido na parte superior de cada página. Para obter mais informações, consulte “[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-your-notification-settings)". {% data reusables.notifications.vulnerable-dependency-notification-delivery-method-customization %} {% data reusables.notifications.vulnerable-dependency-notification-options %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} - ![{% data variables.product.prodname_dependabot_alerts %} options](/assets/images/help/notifications-v2/dependabot-alerts-options.png) + ![Opções {% data variables.product.prodname_dependabot_alerts %} ](/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 %} -**Note:** You can filter your {% data variables.product.company_short %} inbox notifications to show {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% 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)." +**Observação:** Você pode filtrar suas notificações da caixa de entrada de {% data variables.product.company_short %} para mostrar {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 1" %}{% data variables.product.prodname_dependabot %}{% else %} alertas de segurança{% endif %}. Para obter mais informações, consulte "[Gerenciar notificações da 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.19" % %}{% data reusables.repositories.security-alerts-x-github-severity %} 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 email notifications](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}."{% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" % %}{% data reusables.repositories.security-alerts-x-github-severity %} 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 notificações de e-mail](/github/receiving-notifications-about-activity-on-github/about-email-notifications){% endif %}."{% endif %} -### How to reduce the noise from notifications for vulnerable dependencies +### Como reduzir o ruído das notificações para dependências vulneráveis -If you are concerned about receiving too many 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 %}, we recommend you opt into the weekly email digest, or turn off notifications while keeping {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} enabled. You can still navigate to see your {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}security alerts{% endif %} in your repository's Security tab.{% if currentVersion == "free-pro-team@latest" %} For more information, see "[Viewing and updating vulnerable dependencies in your repository](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)."{% endif %} +Se você estiver preocupado em receber muitas notificações 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 %}, recomendamos que você opte pelo resumo semanal por e-mail ou desative as notificações ao mesmo tempo que mantém os {% 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 %} habilitados. Você ainda pode navegar para ver os seus {% 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 %} na aba de Segurança do seu repositório. {% if currentVersion == "free-pro-team@latest" %} 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)".{% endif %} -### Further reading +### Leia mais -- "[Configuring notifications](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)" -- "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-is-queries)" +- "[Configurar notificações](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)" +- "[Gerenciar notificações da sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox#supported-is-queries)" diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md index cbb3ca596a20..c9d9ce7b78b7 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors.md @@ -76,11 +76,11 @@ Existem limites separados para solicitações de atualização de versões e seg A melhor maneira de resolver este erro é fazer o merge ou fechar alguns dos pull requests existentes e acionar um novo pull request manualmente. Para obter mais informações, consulte "[Acionar um pull request de {% data variables.product.prodname_dependabot %} manualmente](#triggering-a-dependabot-pull-request-manually)". -#### {% data variables.product.prodname_dependabot %} can't resolve your dependency files +#### {% data variables.product.prodname_dependabot %} não pode resolver seus arquivos de dependência -**Version updates only.** If {% data variables.product.prodname_dependabot %} attempts to check whether dependency references need to be updated in a repository, but can't access one or more of the referenced files, you will see the error message "{% data variables.product.prodname_dependabot %} can't resolve your LANGUAGE dependency files". +**Somente atualizações da versão.** Se {% data variables.product.prodname_dependabot %} tentar verificar se referências de dependências precisam ser atualizadas em um repositório, mas não for possível acessar um ou mais arquivos referenciados, você verá a mensagem de erro "{% data variables.product.prodname_dependabot %} não pode resolver seus arquivos de dependência de LANGUAGE". -{% data reusables.dependabot.private-dependencies-note %} Additionally, {% data variables.product.prodname_dependabot %} doesn't support private {% data variables.product.prodname_dotcom %} dependencies for all package managers. For more information, see "[About Dependabot version updates](/github/administering-a-repository/about-dependabot-version-updates#supported-repositories-and-ecosystems)." +{% data reusables.dependabot.private-dependencies-note %} Adicionalmente, {% data variables.product.prodname_dependabot %} não é compatível com dependências privadas {% data variables.product.prodname_dotcom %} para todos os gerenciadores de pacote. Para obter mais informações, consulte "[Sobre atualizações da versão do Dependabot](/github/administering-a-repository/about-dependabot-version-updates#supported-repositories-and-ecosystems)". ### Acionar um pull request de {% data variables.product.prodname_dependabot %} manualmente diff --git a/translations/pt-BR/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md b/translations/pt-BR/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md index e214d51c4558..64ec1b3b9899 100644 --- a/translations/pt-BR/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md +++ b/translations/pt-BR/content/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository.md @@ -17,7 +17,7 @@ A aba de alertas do {% data variables.product.prodname_dependabot %} do seu repo ### Sobre atualizações para dependências vulneráveis no seu repositório -{% data variables.product.product_name %} generates {% data variables.product.prodname_dependabot_alerts %} when we detect that your codebase is using dependencies with known vulnerabilities. For repositories where {% data variables.product.prodname_dependabot_security_updates %} are enabled, when {% data variables.product.product_name %} detects a vulnerable dependency in the default branch, {% data variables.product.prodname_dependabot %} creates a pull request to fix it. O pull request irá atualizar a dependência para a versão minimamente segura possível, o que é necessário para evitar a vulnerabilidade. +{% data variables.product.product_name %} gera {% data variables.product.prodname_dependabot_alerts %} quando detectamos que sua base de código está usando dependências com vulnerabilidades conhecidas. Para repositórios em que {% data variables.product.prodname_dependabot_security_updates %} estão habilitados, quando {% data variables.product.product_name %} detecta uma dependência vulnerável no branch padrão, {% data variables.product.prodname_dependabot %} cria um pull request para corrigi-la. O pull request irá atualizar a dependência para a versão minimamente segura possível, o que é necessário para evitar a vulnerabilidade. ### Visualizar e atualizar dependências vulneráveis 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 27ee1d9b3c70..97ab1fd06e03 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 @@ -22,7 +22,7 @@ Você pode optar por assinar notificações para: - Todas as atividades em um repositório ou em uma discussão em equipe. - Atividade CI, como o status de fluxos de trabalho nos repositórios configurados com {% data variables.product.prodname_actions %}. {% if currentVersion == "free-pro-team@latest" %} -- Issues, pulls requests, releases and discussions (if enabled) in a repository. +- Problemas, pull requests, versões e discussões (se habilitado) em um repositório. {% endif %} {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - Lançamentos em um repositório. 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 21b59a6445eb..0a07850cfc72 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 @@ -21,11 +21,11 @@ versions: ### Opções de entrega de notificação -You can receive notifications for activity on {% data variables.product.product_name %} in the following locations. +Você pode receber notificações de atividades em {% data variables.product.product_name %} nos locais a seguir. - - The notifications inbox in the {% data variables.product.product_name %} web interface{% 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 %} + - Caixa de notificações na interface web de {% data variables.product.product_name %} {% if currentVersion == "free-pro-team@latest" %} + - A caixa de entrada no {% 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 %} Para obter mais informações, consulte "[Escolhendo suas configurações de notificação](#choosing-your-notification-settings)". @@ -62,19 +62,19 @@ As notificações de e-mail também permitem flexibilidade com os tipos de notif 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 obter mais informações, consulte "[Sobre discussões de equipe](/github/building-a-strong-community/about-team-discussions)". -To see repositories that you're watching, go to your [watching page](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)". +Para ver repositórios que você está inspecionando, acesse a sua [página de inspeção](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)". {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} #### Configurar notificações {% endif %} -You can configure notifications for a repository on the repository page, or on your watching page. -{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} You can choose to only receive notifications for releases in a repository, or ignore all notifications for a repository.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +Você pode configurar as notificações para um repositório na página do repositório ou na página de visitas. +{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2. 0" %} Você pode optar por receber apenas notificações de versões em um repositório ou ignorar todas as notificações de um repositório.{% endif %}{% if currentVersion == "free-pro-team@latest" %} -#### About custom notifications +#### Sobre as notificações personalizadas {% data reusables.notifications-v2.custom-notifications-beta %} -You can customize notifications for a repository, for example, you can choose to only be notified when updates to one or more types of events (issues, pull request, releases, discussions) happen within a repository, or ignore all notifications for a repository. -{% endif %} For more information, see "[Viewing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#configuring-your-watch-settings-for-an-individual-repository)." +É possível personalizar notificações para um repositório. Você pode optar, por exemplo, por receber notificações somente quando atualizações para um ou mais tipos de eventos (problemas, pull request, versões, discussões) ocorrerem dentro de um repositório ou ignorar todas as notificações de um repositório. +{% endif %} Para obter mais informações, consulte "[Visualizar suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#configuring-your-watch-settings-for-an-individual-repository)". -#### Participating in conversations +#### Participar de conversas 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. 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 %}. @@ -109,9 +109,9 @@ Escolha um endereço de e-mail padrão para enviar atualizações de conversas q - 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. Sua organização pode exigir que o endereço de e-mail seja verificado para um domínio específico. 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, você também pode enviar notificações para diferentes endereços de e-mail. 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 "[Escolher onde as notificações de e-mail da sua organização são enviadas](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications#choosing-where-your-organizations-email-notifications-are-sent)". -You can also send notifications for a specific repository to an email address. Para obter mais informações, consulte "[Sobre notificações de email para push no seu repositório](/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository)". +Você também pode enviar notificações de um repositório específico para um endereço de e-mail. Para obter mais informações, consulte "[Sobre notificações de email para push no seu repositório](/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository)". {% data reusables.notifications-v2.email-notification-caveats %} 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 f3689ccbf96c..3fdbc3e4d916 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 @@ -11,7 +11,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ê 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 %} +**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 passando por abuso e deseja ignorar um repositório, entre em contato com {% data variables.contact.contact_support %} para que possamos ajudar. {% data reusables.policies.abuse %}{% endif %} {% endnote %} @@ -63,5 +63,5 @@ Quando você deixa de inspecionar um repositório, você cancela sua assinatura {% if currentVersion == "free-pro-team@latest" %} - deixar de inspecionar um repositório - ignorar todas as notificações de um repositório - - customize the types of event you receive notifications for (issues, pull requests, releases or discussions, if enabled) + - personalizar os tipos de eventos para os quais você recebe notificações (problemas, pull requests, versões ou discussões, se habilitado) {% endif %} \ No newline at end of file diff --git a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md index f1026b06e77d..d01efdc56dee 100644 --- a/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md +++ b/translations/pt-BR/content/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions.md @@ -36,12 +36,12 @@ Para ter uma visão geral das assinaturas de seu repositório, consulte "[Revisa {% if currentVersion == "free-pro-team@latest" %} {% tip %} -**Tip:** You can select the types of event to be notified of by using the **Custom** option of the **Watch/Unwatch** dropdown list in your [watching page](https://github.com/watching) or on any repository page on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Configuring your watch settings for an individual repository](#configuring-your-watch-settings-for-an-individual-repository)" below. +**Tip:** You can select the types of event to be notified of by using the **Custom** option of the **Watch/Unwatch** dropdown list in your [watching page](https://github.com/watching) or on any repository page on {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Definir as suas configurações de inspeção para um repositório individual](#configuring-your-watch-settings-for-an-individual-repository) abaixo. {% endtip %} {% endif %} -Muitas pessoas esquecem os repositórios que eles escolheram inspecionar no passado. Na página "Repositórios inspecionados" você pode rapidamente deixar de acompanhar repositórios. For more information on ways to unsubscribe, see "[Unwatch recommendations](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" on {% data variables.product.prodname_blog %} and "[Managing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." You can also create a triage workflow to help with the notifications you receive. For guidance on triage workflows, see "[Customizing a workflow for triaging your notifications](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)." +Muitas pessoas esquecem os repositórios que eles escolheram inspecionar no passado. Na página "Repositórios inspecionados" você pode rapidamente deixar de acompanhar repositórios. Para obter mais informações sobre formas de cancelamento de assinatura, consulte "[Cancelar inspeção de recomendações](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" em {% data variables.product.prodname_blog %} e "[Gerenciar suas assinaturas](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)". Também é possível criar um fluxo de trabalho de triagem para ajudar com as notificações que você recebe. Para obter orientação sobre fluxos de trabalho de triagem, consulte "[Personalizar um fluxo de trabalho para triagem das suas notificações](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)". ### Revisando todas as suas assinaturas @@ -74,15 +74,15 @@ Muitas pessoas esquecem os repositórios que eles escolheram inspecionar no pass {% tip %} - **Tip:** Instead of watching a repository, consider only receiving notifications {% if currentVersion == "free-pro-team@latest" %}when there are updates to issues, pull requests, releases or discussions (if enabled for the repository), or any combination of these options,{% else %}for releases in a repository,{% endif %} or completely unwatching a repository. + **Dica:** Em vez de inspecionar um repositório, considere receber apenas notificações {% if currentVersion == "free-pro-team@latest" %}quando houver atualizações sobre problemas, pull requests, versões ou discussões (se habilitado para o repositório), ou qualquer combinação destas opções,{% else %}para versões em um repositório,{% endif %} ou para cancelar a inspeção por completo de um repositório. - Quando você deixa de inspecionar um repositório, você ainda pode ser notificado quando for @mencionado ou estiver participando de um thread. When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. + Quando você deixa de inspecionar um repositório, você ainda pode ser notificado quando for @mencionado ou estiver participando de um thread. Ao definir a configuração para receber notificações de certos tipos de evento, você só será notificado quando houver atualizações desses tipos de eventos no repositório, quando você estiver participando de um tópico ou quando você ou a sua equipe for @mentioned. {% endtip %} ### Configurando as configurações de inspeção para um repositório individual -É possível escolher se deseja inspecionar ou não inspecionar um repositório individual. You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository. +É possível escolher se deseja inspecionar ou não inspecionar um repositório individual. Você também pode optar por receber notificações apenas sobre {% if currentVersion == "free-pro-team@latest" %}certos tipos de eventos como problemas, pull requests, discussões (se habilitado para o repositório) e {% endif %}novas versões, ou ignorar completamente um repositório individual. {% data reusables.repositories.navigate-to-repo %} 2. No canto superior direito, clique no menu suspenso "Inspecionar" para selecionar uma opção de inspeção. @@ -92,10 +92,10 @@ Muitas pessoas esquecem os repositórios que eles escolheram inspecionar no pass {% if currentVersion == "free-pro-team@latest" %} ![Opções de inspeção em um menu suspenso para repositórios](/assets/images/help/notifications-v2/watch-repository-options-custom.png) {% data reusables.notifications-v2.custom-notifications-beta %} -The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions. +A opção **Personalizar** permite que você personalize ainda mais as notificações para que você seja notificado apenas quando eventos específicos ocorrerem no repositório, além de participar e @mentions. - ![Custom watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom2.png) + ![Opções de inspeção personalizadas em um menu suspenso para um repositório](/assets/images/help/notifications-v2/watch-repository-options-custom2.png) -If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues. +Se você selecionar "Problemas", você será notificado e irá inscrever-se para receber atualizações sobre cada problema (incluindo aqueles que existiam antes de você selecionar esta opção) no repositório. Se você for @mentioned em um pull request neste repositório, você receberá notificações sobre isso também e será inscrito em atualizações desse pull request específico, além de ser notificado sobre problemas. {% endif %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/creating-an-issue.md b/translations/pt-BR/content/github/managing-your-work-on-github/creating-an-issue.md index 2696b3ff1f89..df45ccb91fa2 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/creating-an-issue.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/creating-an-issue.md @@ -1,7 +1,7 @@ --- title: Criar um problema intro: 'Os problemas podem ser usados para acompanhar erros, aprimoramentos ou outras solicitações.' -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: 'Pessoas com permissões de leitura podem criar um problema em um repositório onde os problemas estão habilitados.' redirect_from: - /articles/creating-an-issue versions: diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/managing-labels.md b/translations/pt-BR/content/github/managing-your-work-on-github/managing-labels.md index 82cae55e2afe..305bb5a45e93 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/managing-labels.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/managing-labels.md @@ -23,55 +23,56 @@ versions: github-ae: '*' --- -### Sobre etiquetas +### About labels -Você pode gerenciar seu trabalho no {% data variables.product.product_name %} criando etiquetas para classificar problemas e pull requests. You can apply labels in the repository the label was created in. Once a label exists, you can use the label on any issue or pull request within that repository. +You can manage your work on {% data variables.product.product_name %} by creating labels to categorize issues and pull requests. You can apply labels in the repository the label was created in. Once a label exists, you can use the label on any issue or pull request within that repository. -Qualquer pessoa com acesso de leitura a um repositório pode exibir e pesquisar etiquetas do repositório. Para criar, editar, aplicar ou excluir uma etiqueta, é preciso ter acesso de gravação ao repositório. +Anyone with read access to a repository can view and search the repository’s labels. To create, edit, apply, or delete a label, you must have write access to the repository. ### About default labels -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. +{% 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. -| Etiqueta | Descrição | -| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `bug` | Indicates an unexpected problem or unintended behavior{% 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 | +Label | Description +--- | --- +`bug` | Indicates an unexpected problem or unintended behavior{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.17" %} +`documentation` | 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 -Etiquetas padrão são incluídas em todos os novos repositórios quando criados, mas você pode editar ou excluir as etiquetas posteriormente. +Default labels are included in every new repository when the repository is created, but you can edit or delete the labels later. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %} -Os proprietários da organização podem personalizar as etiquetas padrão para repositórios na organização. Para obter mais informações, consulte "[Gerenciar etiquetas padrão nos repositórios da organização](/articles/managing-default-labels-for-repositories-in-your-organization)". +Organization owners can customize the default labels for repositories in their organization. For more information, see "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)." {% endif %} -### Criar uma etiqueta +### Creating a label {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} {% data reusables.project-management.labels %} -4. À direita do campo de pesquisa, clique em **New label** (Nova etiqueta). +4. To the right of the search field, click **New label**. {% data reusables.project-management.name-label %} {% data reusables.project-management.label-description %} {% data reusables.project-management.label-color-randomizer %} {% data reusables.project-management.create-label %} -### Aplicar etiquetas a problemas e pull requests +### Applying labels to issues and pull requests {% 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. 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) -### Editar uma etiqueta +### Editing a label {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issue-pr %} @@ -82,7 +83,7 @@ Os proprietários da organização podem personalizar as etiquetas padrão para {% data reusables.project-management.label-color-randomizer %} {% data reusables.project-management.save-label %} -### Excluir uma etiqueta +### Deleting a label Deleting a label will remove the label from issues and pull requests. {% data reusables.repositories.navigate-to-repo %} @@ -90,8 +91,8 @@ Deleting a label will remove the label from issues and pull requests. {% data reusables.project-management.labels %} {% data reusables.project-management.delete-label %} -### Leia mais -- "[Sobre etiquetas](/articles/about-labels)" +### Further reading +- "[About labels](/articles/about-labels)" - "[Filtering issues and pull requests by labels](/articles/filtering-issues-and-pull-requests-by-labels)"{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} - "[Managing default labels for repositories in your organization](/articles/managing-default-labels-for-repositories-in-your-organization)"{% endif %}{% if currentVersion == "free-pro-team@latest" %} - "[Encouraging helpful contributions to your project with labels](/github/building-a-strong-community/encouraging-helpful-contributions-to-your-project-with-labels)"{% endif %} diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md b/translations/pt-BR/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md index 487e1155e15c..4564930c4209 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/managing-your-work-with-issues-and-pull-requests.md @@ -1,5 +1,5 @@ --- -title: Managing your work with issues and pull requests +title: Gerenciar seu trabalho com problemas e pull requests intro: 'Você pode gerenciar seu trabalho no {% data variables.product.product_name %} criando problemas para rastrear ideias, melhorias, tarefas ou erros.' mapTopic: true redirect_from: diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md b/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md index 509bc78875ac..372125cd84ea 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md @@ -1,7 +1,7 @@ --- title: Abrindo um problema a partir de um comentário intro: É possível abrir um problema novo a partir de um comentário específico em um problema ou uma pull request. -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: 'Pessoas com permissões de leitura podem criar um problema em um repositório onde os problemas estão habilitados.' versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-code.md b/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-code.md index 22514def8589..33911bcfa9c9 100644 --- a/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-code.md +++ b/translations/pt-BR/content/github/managing-your-work-on-github/opening-an-issue-from-code.md @@ -1,7 +1,7 @@ --- title: Abrir um problema a partir de código intro: É possível abrir um problema novo a partir de uma linha ou linhas específicas de código em um arquivo ou pull request. -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: 'Pessoas com permissões de leitura podem criar um problema em um repositório onde os problemas estão habilitados.' redirect_from: - /articles/opening-an-issue-from-code versions: 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 295806bb4244..28a03999f767 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 @@ -11,7 +11,7 @@ versions: 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)". -You can only transfer issues between repositories owned by the same user or organization account.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}You can't transfer an issue from a private repository to a public repository.{% endif %} +Você só pode transferir problemas entre repositórios pertencentes à mesma conta de usuário ou de organização.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Você não pode transferir um problema de um repositório privado para um repositório público.{% 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)". 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 7d41fef484ae..d71d54c91b46 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 @@ -25,7 +25,7 @@ Com os termos da pesquisa de problemas e pull requests, é possível: - Filtrar problemas e pull requests que envolvem determinadas pessoas, mas não necessariamente as [**@mencionam**](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams): `state:open type:issue involves:octocat` - Filtrar problemas e pull requests por responsável: `state:open type:issue assignee:octocat` - Filtrar problemas e pull requests por etiqueta: `state:open type:issue label:"bug"` -- Filter out search terms by using `-` before the term: `state:open type:issue -author:octocat` +- Filtrar termos da pesquisa usando `-` antes do termo: `state:open type:issue -author:octocat` {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} Para problemas, você também pode usar a busca para: 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 ae547a25ad1e..f5afad49745d 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 @@ -33,7 +33,7 @@ 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 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 %} +**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 desejar ignorar um repositório, entre em contato com {% data variables.contact.contact_support %} para que possamos ajudar. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 50dadcbea097..3a829a53e750 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 @@ -37,12 +37,12 @@ A pesquisa do {% data variables.product.product_name %} usa um cluster do Elasti ### Tipos de pesquisa no {% data variables.product.prodname_dotcom %} -You can search for the following information across all repositories you can access on {% data variables.product.product_location %}. +Você pode pesquisar as seguintes informações em todos os repositórios que você pode acessar em {% data variables.product.product_location %}. - [Repositórios](/articles/searching-for-repositories) - [Tópicos](/articles/searching-topics) -- [Issues and pull requests](/articles/searching-issues-and-pull-requests){% if currentVersion == "free-pro-team@latest" %} -- [Discussions](/github/searching-for-information-on-github/searching-discussions){% endif %} +- [Problemas e pull requests](/articles/searching-issues-and-pull-requests){% if currentVersion == "free-pro-team@latest" %} +- [Discussões](/github/searching-for-information-on-github/searching-discussions){% endif %} - [Código](/articles/searching-code) - [Commits](/articles/searching-commits) - [Usuários](/articles/searching-users){% if currentVersion == "free-pro-team@latest" %} 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 10df7d995cb5..d51025a9bd96 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 @@ -11,7 +11,7 @@ versions: github-ae: '*' --- -{% data reusables.search.you-can-search-globally %} For more information, see "[About searching on GitHub](/articles/about-searching-on-github)." +{% data reusables.search.you-can-search-globally %} Para obter mais informações, consulte "[Sobre pesquisar no GitHub](/articles/about-searching-on-github)." Você pode pesquisar códigos usando somente estes qualificadores de pesquisa de código. Qualificadores de pesquisa específicos para repositórios, usuários ou commits não funcionarão com a pesquisa de códigos. @@ -27,7 +27,8 @@ Devido à complexidade da pesquisa de códigos, a execução das pesquisas apres - 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. +- Apenas repositórios com menos de 500.000 arquivos são pesquisáveis.{% if currentVersion == "free-pro-team@latest" %} +- Apenas repositórios que tiveram atividade ou apareceram nos resultados de pesquisa do último ano são pesquisáveis.{% endif %} - Com exceção das pesquisas por [`filename`](#search-by-filename), é necessário incluir pelo menos um termo da pesquisa ao pesquisar o código-fonte. Por exemplo, pesquisar [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) não é válido, enquanto pesquisar [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) é. - Os resultados da pesquisa exibem no máximo dois fragmentos do mesmo arquivo, mas o arquivo pode ter mais resultados. - Não é possível usar os seguintes caracteres-curinga na consulta de pesquisa: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. A pesquisa simplesmente ignora esses símbolos. 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 abc697740016..48ccd45b3cf4 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 @@ -96,11 +96,11 @@ Para pesquisar commits em todos os repositórios de um determinado usuário ou o | org:ORGNAME | [**test org:github**](https://github.com/search?utf8=%E2%9C%93&q=test+org%3Agithub&type=Commits) identifica as mensagens do commit com a palavra "test" nos repositórios de @github. | | repo:USERNAME/REPO | [**language repo:defunkt/gibberish**](https://github.com/search?utf8=%E2%9C%93&q=language+repo%3Adefunkt%2Fgibberish&type=Commits) identifica as mensagens do commit com a palavra "language" no repositório "gibberish" de @defunkt. | -### Filter by repository visibility +### Filtrar por visibilidade do repositório -The `is` qualifier matches commits from repositories with the specified visibility. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility). +O qualificador `is` corresponde a commits dos repositórios com a visibilidade especificada. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility). -| Qualifier | Example | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Commits) matches commits to public repositories.{% endif %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Commits) matches commits to internal repositories. | `is:private` | [**is:private**](https://github.com/search?q=is%3Aprivate&type=Commits) matches commits to private repositories. +| Qualificador | Exemplo | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Commits) corresponde aos dos repositórios públicos.{% endif %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Commits) corresponde aos commits dos repositórios internos. | `is:private` | [**is:private**](https://github.com/search?q=is%3Aprivate&type=Commits) corresponde aos commits dos repositórios privados. ### Leia mais diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-discussions.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-discussions.md index 0f1e21ca39f1..1ce7d37a55f1 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-discussions.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-discussions.md @@ -1,73 +1,73 @@ --- -title: Searching discussions -intro: You can search for discussions on {% data variables.product.product_name %} and narrow the results using search qualifiers. +title: Pesquisar discussões +intro: Você pode pesquisar discussões em {% data variables.product.product_name %} e limitar os resultados usando os qualificadores de busca. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About searching for discussions +### Sobre a pesquisa de discussões -You can search for discussions globally across all of {% data variables.product.product_name %}, or search for discussions within a particular organization or repository. Para obter mais informações, consulte "[Sobre a pesquisa no {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github)". +É possível pesquisar discussões globalmente em todos os {% data variables.product.product_name %} ou pesquisar discussões dentro de uma determinada organização ou repositório. Para obter mais informações, consulte "[Sobre a pesquisa no {% data variables.product.prodname_dotcom %}](/github/searching-for-information-on-github/about-searching-on-github)". {% data reusables.search.syntax_tips %} ### Pesquisar por título, texto ou comentários -With the `in` qualifier you can restrict your search for discussions to the title, body, or comments. You can also combine qualifiers to search a combination of title, body, or comments. When you omit the `in` qualifier, {% data variables.product.product_name %} searches the title, body, and comments. +Com o qualificador `in`, você pode restringir sua pesquisa por discussões sobre título, texto ou comentários. Você também pode combinar os qualificadores para pesquisar uma combinação de título, texto ou comentários. Ao omitir o qualificador `in` qualificador, {% data variables.product.product_name %} irá pesquisar o título, o texto e os comentários. | Qualifier | Exemplo | |:------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `in:title` | [**welcome in:title**](https://github.com/search?q=welcome+in%3Atitle&type=Discussions) matches discussions with "welcome" in the title. | -| `in:body` | [**onboard in:title,body**](https://github.com/search?q=onboard+in%3Atitle%2Cbody&type=Discussions) matches discussions with "onboard" in the title or body. | -| `in:comments` | [**thanks in:comments**](https://github.com/search?q=thanks+in%3Acomment&type=Discussions) matches discussions with "thanks" in the comments for the discussion. | +| `in:title` | [**welcome in:title**](https://github.com/search?q=welcome+in%3Atitle&type=Discussions) corresponde discussões ao título "welcome". | +| `in:body` | [**onboard in:title,body**](https://github.com/search?q=onboard+in%3Atitle%2Cbody&type=Discussions) corresponde discussões com "onboard" no título ou texto. | +| `in:comments` | [**thanks in:comments**](https://github.com/search?q=thanks+in%3Acomment&type=Discussions) corresponde discussões com "thanks" nos comentários para a discussão. | ### Pesquisar nos repositórios de um usuário ou uma organização -To search discussions in all repositories owned by a certain user or organization, you can use the `user` or `org` qualifier. To search discussions in a specific repository, you can use the `repo` qualifier. +Para pesquisar discussões em todos os repositórios pertencentes a um determinado usuário ou organização, você pode usar o qualificador `usuário` ou `org`. Para pesquisar discussões em um repositório específico, você pode usar o qualificador `repositório`. -| Qualifier | Exemplo | -|:------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| user:USERNAME | [**user:octocat feedback**](https://github.com/search?q=user%3Aoctocat+feedback&type=Discussions) matches discussions with the word "feedback" from repositories owned by @octocat. | -| org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=Discussions&utf8=%E2%9C%93) matches discussions in repositories owned by the GitHub organization. | -| repo:USERNAME/REPOSITORY | [**repo:nodejs/node created:<2021-01-01**](https://github.com/search?q=repo%3Anodejs%2Fnode+created%3A%3C2020-01-01&type=Discussions) matches discussions from @nodejs' Node.js runtime project that were created before January 2021. | +| Qualifier | Exemplo | +|:------------------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| user:USERNAME | [**user:octocat feedback**](https://github.com/search?q=user%3Aoctocat+feedback&type=Discussions) corresponde discussões com a palavra "feedback" dos repositórios pertencentes ao @octocat. | +| org:ORGNAME | [**org:github**](https://github.com/search?q=org%3Agithub&type=Discussions&utf8=%E2%9C%93) corresponde discussões em repositórios pertencentes à organização do GitHub. | +| repo:USERNAME/REPOSITORY | [**repo:nodejs/node created:<2021-01-01**](https://github.com/search?q=repo%3Anodejs%2Fnode+created%3A%3C2020-01-01&type=Discussions) corresponde discussões do projeto do tempo de execução do Node.js do @nodejs criadas antes de janeiro de 2021. | -### Filter by repository visibility +### Filtrar por visibilidade do repositório -You can filter by the visibility of the repository containing the discussions using the `is` qualifier. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +Você pode filtrar pela visibilidade do repositório que contém as discussões que usam o qualificador `is`. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." -| Qualifier | Example | :- | :- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Discussions) matches discussions in public repositories.{% endif %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Discussions) matches discussions in internal repositories. | `is:private` | [**is:private tiramisu**](https://github.com/search?q=is%3Aprivate+tiramisu&type=Discussions) matches discussions that contain the word "tiramisu" in private repositories you can access. +| Qualificador | Exemplo | :- | :- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Discussions) corresponde discussões em repositórios públicos.{% endif %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Discussions) corresponde discussões em repositórios internos. | `is:private` | [**is:private tiramisu**](https://github.com/search?q=is%3Aprivate+tiramisu&type=Discussions) corresponde discussões que contêm a palavra "tiramisu" em repositórios que você pode acessar. ### Pesquisar por autor -The `author` qualifier finds discussions created by a certain user. +O qualificador do `autor` encontra discussões criadas por um determinado usuário. -| Qualifier | Exemplo | -|:------------------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| author:USERNAME | [**cool author:octocat**](https://github.com/search?q=cool+author%3Aoctocat&type=Discussions) matches discussions with the word "cool" that were created by @octocat. | -| | [**bootstrap in:body author:octocat**](https://github.com/search?q=bootstrap+in%3Abody+author%3Aoctocat&type=Discussions) matches discussions created by @octocat that contain the word "bootstrap" in the body. | +| Qualifier | Exemplo | +|:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| author:USERNAME | [**cool author:octocat**](https://github.com/search?q=cool+author%3Aoctocat&type=Discussions) corresponde a discussões com a palavra "cool" criadas por @octocat. | +| | [**bootstrap in:body author:octocat**](https://github.com/search?q=bootstrap+in%3Abody+author%3Aoctocat&type=Discussions) corresponde a discussões criadas por @octocat que contêm a palavra "bootstrap" no texto. | ### Pesquisar por autor do comentário -The `commenter` qualifier finds discussions that contain a comment from a certain user. +O qualificador `commenter` encontra discussões que contêm um comentário de um usuário específico. -| Qualifier | Exemplo | -|:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| commenter:USERNAME | [**github commenter:becca org:github**](https://github.com/search?utf8=%E2%9C%93&q=github+commenter%3Abecca+org%3Agithub&type=Discussions) matches discussions in repositories owned by GitHub, that contain the word "github," and have a comment by @becca. | +| Qualifier | Exemplo | +|:------------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| commenter:USERNAME | [**github commenter:becca org:github**](https://github.com/search?utf8=%E2%9C%93&q=github+commenter%3Abecca+org%3Agithub&type=Discussions) corresponde às discussões em repositórios pertencentes ao GitHub, que contêm a palavra "github" e que têm um comentário de @becca. | -### Search by a user that's involved in a discussion +### Procurar por um usuário envolvido em uma discussão -You can use the `involves` qualifier to find discussions that involve a certain user. The qualifier returns discussions that were either created by a certain user, mention the user, or contain comments by the user. The `involves` qualifier is a logical OR between the `author`, `mentions`, and `commenter` qualifiers for a single user. +Você pode usar o qualificador `envolve` para encontrar discussões que envolvam um determinado usuário. O qualificador retorna discussões que ou foram criadas por um determinado usuário, menciona o usuário, ou contém comentários feitos pelo usuário. O qualificador `involves` é um operador lógico OU entre os qualificadores `autor`, `mentions` e `commenter` para um único usuário. | Qualifier | Exemplo | |:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| involves:USERNAME | **[involves:becca involves:octocat](https://github.com/search?q=involves%3Abecca+involves%3Aoctocat&type=Discussions)** matches discussions either @becca or @octocat are involved in. | +| involves:USERNAME | **[envolves:becca envolve:octocat](https://github.com/search?q=involves%3Abecca+involves%3Aoctocat&type=Discussions)** corresponde às discussões em que @becca ou @octocat estão envolvidos. | | | [**NOT beta in:body involves:becca**](https://github.com/search?q=NOT+beta+in%3Abody+involves%3Abecca&type=Discussions) matches discussions @becca is involved in that do not contain the word "beta" in the body. | ### Pesquisar por número de comentários -You can use the `comments` qualifier along with greater than, less than, and range qualifiers to search by the number of comments. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +You can use the `comments` qualifier along with greater than, less than, and range qualifiers to search by the number of comments. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | |:------------------------- |:-------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -76,7 +76,7 @@ You can use the `comments` qualifier along with greater than, less than, and ran ### Pesquisar por número de interações -You can filter discussions by the number of interactions with the `interactions` qualifier along with greater than, less than, and range qualifiers. The interactions count is the number of reactions and comments on a discussion. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +You can filter discussions by the number of interactions with the `interactions` qualifier along with greater than, less than, and range qualifiers. The interactions count is the number of reactions and comments on a discussion. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | |:------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -85,7 +85,7 @@ You can filter discussions by the number of interactions with the `interactions` ### Pesquisar por número de reações -You can filter discussions by the number of reactions using the `reactions` qualifier along with greater than, less than, and range qualifiers. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +You can filter discussions by the number of reactions using the `reactions` qualifier along with greater than, less than, and range qualifiers. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | |:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------ | diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-repositories.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-repositories.md index 6b22e9c55b8e..184ca067e354 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-repositories.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-for-repositories.md @@ -20,22 +20,22 @@ Para incluir bifurcações nos resultados da pesquisa, você precisará adiciona Com o qualificador `in`, você pode restringir a pesquisa ao nome do repositório, descrição do repositório, conteúdo do arquivo README ou qualquer combinação desses itens. Quando você omite esse qualificador, somente o nome e a descrição do repositório são pesquisados. -| Qualifier | Exemplo | -| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `in:name` | [**jquery in:name**](https://github.com/search?q=jquery+in%3Aname&type=Repositories) matches repositories with "jquery" in the repository name. | -| `in:description` | [**jquery in:name,description**](https://github.com/search?q=jquery+in%3Aname%2Cdescription&type=Repositories) matches repositories with "jquery" in the repository name or description. | -| `in:readme` | [**jquery in:readme**](https://github.com/search?q=jquery+in%3Areadme&type=Repositories) matches repositories mentioning "jquery" in the repository's README file. | -| `repo:owner/name` | [**repo:octocat/hello-world**](https://github.com/search?q=repo%3Aoctocat%2Fhello-world) identifica um nome de repositório específico. | +| Qualifier | Exemplo | +| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `in:name` | [**jquery in:name**](https://github.com/search?q=jquery+in%3Aname&type=Repositories) corresponde aos repositórios com "jquery" no nome do respositório. | +| `in:description` | [**jquery in:name,description**](https://github.com/search?q=jquery+in%3Aname%2Cdescription&type=Repositories) corresponde aos repositórios com "jquery" no nome ou descrição do repositório. | +| `in:readme` | [**jquery em:readme**](https://github.com/search?q=jquery+in%3Areadme&type=Repositories) corresponde aos repositórios que mencionam "jquery" no arquivo LEIAME do repositório. | +| `repo:owner/name` | [**repo:octocat/hello-world**](https://github.com/search?q=repo%3Aoctocat%2Fhello-world) identifica um nome de repositório específico. | ### Pesquisar com base no conteúdo do repositório -You can find a repository by searching for content in the repository's README file using the `in:readme` qualifier. Para obter mais informações, consulte "[Sobre LEIAME](/github/creating-cloning-and-archiving-repositories/about-readmes)". +Você pode encontrar um repositório pesquisando pelo conteúdo no arquivo LEIAME do repositório usando o qualificador `in:readme`. Para obter mais informações, consulte "[Sobre LEIAME](/github/creating-cloning-and-archiving-repositories/about-readmes)". Além de usar o `in:readme`, não é possível encontrar repositórios pesquisando um conteúdo específico no repositório. Para pesquisar um arquivo ou conteúdo específico em um repositório, você pode usar o localizador de arquivos os qualificadores de pesquisa específicos para código. Para obter mais informações, consulte "[Localizar arquivos no {% data variables.product.prodname_dotcom %}](/articles/finding-files-on-github)" e "[Pesquisar códigos](/articles/searching-code)". -| Qualifier | Exemplo | -| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `in:readme` | [**octocat in:readme**](https://github.com/search?q=octocat+in%3Areadme&type=Repositories) matches repositories mentioning "octocat" in the repository's README file. | +| Qualifier | Exemplo | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `in:readme` | [**octocat in:readme**](https://github.com/search?q=octocat+in%3Areadme&type=Repositories) corresponde aos repositórios que mencionam "octocat" no arquivo LEIAME do repositório. | ### Pesquisar nos repositórios de um usuário ou uma organização @@ -48,7 +48,7 @@ Para pesquisar em todos os repositórios de um determinado usuário ou organiza ### Pesquisar por tamanho do repositório -The `size` qualifier finds repositories that match a certain size (in kilobytes), using greater than, less than, and range qualifiers. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +O qualificador `size` procura repositórios que têm um tamanho específico (em kilobytes) usando os qualificadores maior que, menor que e intervalo. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -59,7 +59,7 @@ The `size` qualifier finds repositories that match a certain size (in kilobytes) ### Pesquisar por número de seguidores -You can filter repositories based on the number of users who follow the repositories, using the `followers` qualifier with greater than, less than, and range qualifiers. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +É possível filtrar repositórios com base no número de usuários que seguem os repositórios, usando o qualificador `followers` com os qualificadores com maior que, menor que e intervalo. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -68,7 +68,7 @@ You can filter repositories based on the number of users who follow the reposito ### Pesquisar por número de bifurcações -The `forks` qualifier specifies the number of forks a repository should have, using greater than, less than, and range qualifiers. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +O qualificador `forks` especifica o número de bifurcações que um repositório deve ter usando os qualificadores maior que, menor que e intervalo. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -79,7 +79,7 @@ The `forks` qualifier specifies the number of forks a repository should have, us ### Pesquisar por número de estrelas -You can search repositories based on the number of stars the repositories have, using greater than, less than, and range qualifiers. For more information, see "[Saving repositories with stars](/github/getting-started-with-github/saving-repositories-with-stars)" and "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +Você pode pesquisar repositórios com base no número de estrelas que os repositórios têm, usando os qualificadores maior que, menor que e intervalo. Para obter mais informações, consulte "[Salvar repositórios com estrelas](/github/getting-started-with-github/saving-repositories-with-stars)" e "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -103,7 +103,7 @@ Os dois usam uma data como parâmetro. {% data reusables.time_date.date_format % ### Pesquisar por linguagem -You can search repositories based on the language of the code in the repositories. +Você pode pesquisar repositórios com base na linguagem do código nos repositórios. | Qualifier | Exemplo | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -111,7 +111,7 @@ You can search repositories based on the language of the code in the repositorie ### Pesquisar por tópico -You can find all of the repositories that are classified with a particular topic. Para obter mais informações, consulte "[Classificar seu repositório com tópicos](/github/administering-a-repository/classifying-your-repository-with-topics)". +Você pode encontrar todos os repositórios classificados com um determinado tópico. Para obter mais informações, consulte "[Classificar seu repositório com tópicos](/github/administering-a-repository/classifying-your-repository-with-topics)". | Qualifier | Exemplo | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -119,7 +119,7 @@ You can find all of the repositories that are classified with a particular topic ### Pesquisar por número de tópicos -You can search repositories by the number of topics that have been applied to the repositories, using the `topics` qualifier along with greater than, less than, and range qualifiers. For more information, see "[Classifying your repository with topics](/github/administering-a-repository/classifying-your-repository-with-topics)" and "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +Você pode pesquisar repositórios pelo número de tópicos que foram aplicados aos repositórios, usando o qualificador `topics` junto com os qualificadores maior que, menor que e intervalo. Para obter mais informações, consulte "[Classificar seu repositório com tópicos](/github/administering-a-repository/classifying-your-repository-with-topics)" e "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". | Qualifier | Exemplo | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -130,7 +130,7 @@ You can search repositories by the number of topics that have been applied to th ### Pesquisar por licença -You can search repositories by the type of license in the repositories. You must use a license keyword to filter repositories by a particular license or license family. Para obter mais informações, consulte "[Licenciar um repositório](/github/creating-cloning-and-archiving-repositories/licensing-a-repository)". +Você pode pesquisar repositórios pelo tipo de licença nos repositórios. É preciso usar uma palavra-chave de licença para filtrar repositórios por uma determinada licença ou família de licenças. Para obter mais informações, consulte "[Licenciar um repositório](/github/creating-cloning-and-archiving-repositories/licensing-a-repository)". | Qualifier | Exemplo | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | @@ -138,33 +138,33 @@ You can search repositories by the type of license in the repositories. You must {% endif %} -### Search by repository visibility +### Pesquisar por visibilidade do repositório -You can filter your search based on the visibility of the repositories. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +Você pode filtrar sua pesquisa com base na visibilidade dos repositórios. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." -| Qualifier | Example | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public org:github**](https://github.com/search?q=is%3Apublic+org%3Agithub&type=Repositories) matches public repositories owned by {% data variables.product.company_short %}.{% endif %} | `is:internal` | [**is:internal test**](https://github.com/search?q=is%3Ainternal+test&type=Repositories) matches internal repositories that you can access and contain the word "test". | `is:private` | [**is:private pages**](https://github.com/search?q=is%3Aprivate+pages&type=Repositories) matches private repositories that you can access and contain the word "pages." +| Qualificador | Exemplo | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public org:github**](https://github.com/search?q=is%3Apublic+org%3Agithub&type=Repositories) corresponde aos repositórios públicos que pertencem a {% data variables.product.company_short %}.{% endif %} | `is:internal` | [**is:internal test**](https://github.com/search?q=is%3Ainternal+test&type=Repositories) corresponde aos repositórios internos que você pode acessar e que contêm a palavra "test". | `is:private` | [**is:private pages**](https://github.com/search?q=is%3Aprivate+pages&type=Repositories) corresponde a repositórios privados que você pode acessar e que contêm a palavra "pages". {% if currentVersion == "free-pro-team@latest" %} ### Pesquisar com base no fato de o repositório ser um espelho -You can search repositories based on whether the repositories are mirrors and hosted elsewhere. 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 pesquisar repositórios com base no fato de os repositórios serem espelhos e hospedados em outro lugar. 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)." -| Qualifier | Exemplo | -| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `mirror:true` | [**mirror:true GNOME**](https://github.com/search?utf8=%E2%9C%93&q=mirror%3Atrue+GNOME&type=) identifica os repositórios que são espelhos e contêm a palavra "GNOME". | -| `mirror:false` | [**mirror:false GNOME**](https://github.com/search?utf8=%E2%9C%93&q=mirror%3Afalse+GNOME&type=) matches repositories that are not mirrors and contain the word "GNOME." | +| Qualifier | Exemplo | +| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `mirror:true` | [**mirror:true GNOME**](https://github.com/search?utf8=%E2%9C%93&q=mirror%3Atrue+GNOME&type=) identifica os repositórios que são espelhos e contêm a palavra "GNOME". | +| `mirror:false` | [**mirror:false GNOME**](https://github.com/search?utf8=%E2%9C%93&q=mirror%3Afalse+GNOME&type=) corresponde aos repositórios que não são espelhos e contêm a palavra "GNOME". | {% endif %} ### Pesquisar com base no fato de o repositório estar arquivado -You can search repositories based on whether or not the repositories are archived. For more information, see "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)." +Você pode pesquisar repositórios com base no fato de os repositórios estarem ou não arquivados. Para obter mais informações, consulte "[Sobre o arquivamento de repositórios](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)." -| Qualifier | Exemplo | -| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `archived:true` | [**archived:true GNOME**](https://github.com/search?utf8=%E2%9C%93&q=archived%3Atrue+GNOME&type=) identifica os repositórios que estão arquivados e contêm a palavra "GNOME". | -| `archived:false` | [**archived:false GNOME**](https://github.com/search?utf8=%E2%9C%93&q=archived%3Afalse+GNOME&type=) matches repositories that are not archived and contain the word "GNOME." | +| Qualifier | Exemplo | +| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `archived:true` | [**archived:true GNOME**](https://github.com/search?utf8=%E2%9C%93&q=archived%3Atrue+GNOME&type=) identifica os repositórios que estão arquivados e contêm a palavra "GNOME". | +| `archived:false` | [**archived:false GNOME**](https://github.com/search?utf8=%E2%9C%93&q=archived%3Afalse+GNOME&type=) corresponde aos repositórios que não estão arquivados e contêm a palavra "GNOME". | {% if currentVersion == "free-pro-team@latest" %} 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 f71a73a79356..d057cc733572 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 @@ -64,46 +64,46 @@ Você pode filtrar somente problemas e pull requests abertos ou fechados usando | `is:open` | [**performance is:open is:issue**](https://github.com/search?q=performance+is%3Aopen+is%3Aissue&type=Issues) identifica os problemas abertos com a palavra "performance". | | `is:closed` | [**android is:closed**](https://github.com/search?utf8=%E2%9C%93&q=android+is%3Aclosed&type=) identifica os problemas e as pull requests fechados com a palavra "android". | -### Filter by repository visibility +### Filtrar por visibilidade do repositório -You can filter by the visibility of the repository containing the issues and pull requests using the `is` qualifier. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." +É possível filtrar pela visibilidade do repositório que contém os problemas e pull requests usando o qualificador `is`. Para obter mais informações, consulte "[Sobre a visibilidade do repositório](/github/creating-cloning-and-archiving-repositories/about-repository-visibility)." -| Qualifier | Example | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Issues) matches issues and pull requests in public repositories.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Issues) matches issues and pull requests in internal repositories.{% endif %} | `is:private` | [**is:private cupcake**](https://github.com/search?q=is%3Aprivate+cupcake&type=Issues) matches issues and pull requests that contain the word "cupcake" in private repositories you can access. +| Qualificador | Exemplo | ------------- | ------------- |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | `is:public` | [**is:public**](https://github.com/search?q=is%3Apublic&type=Issues) corresponde problemas e pull requests em repositórios públicos.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} | `is:internal` | [**is:internal**](https://github.com/search?q=is%3Ainternal&type=Issues) corresponde problemas e pull requests em repositórios internos.{% endif %} | `is:private` | [**is:private cupcake**](https://github.com/search?q=is%3Aprivate+cupcake&type=Issues) corresponde problemas e pull requests que contêm a palavra "cupcake" em repositórios privados que você pode acessar. ### Pesquisar por autor O qualificador `author` encontra problemas e pull requests criados por determinado usuário ou conta de integração. -| Qualifier | Exemplo | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| author:USERNAME | [**cool author:gjtorikian**](https://github.com/search?q=cool+author%3Agjtorikian&type=Issues) matches issues and pull requests with the word "cool" that were created by @gjtorikian. | -| | [**bootstrap in:body author:mdo**](https://github.com/search?q=bootstrap+in%3Abody+author%3Amdo&type=Issues) matches issues written by @mdo that contain the word "bootstrap" in the body. | -| author:app/USERNAME | [**author:app/robot**](https://github.com/search?q=author%3Aapp%2Frobot&type=Issues) matches issues created by the integration account named "robot." | +| Qualifier | Exemplo | +| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| author:USERNAME | [**cool author:gjtorikian**](https://github.com/search?q=cool+author%3Agjtorikian&type=Issues) corresponde os problemas e os pull requests com a palavra "cool" que foram criados por @gjtorikian. | +| | [**bootstrap in:body author:mdo**](https://github.com/search?q=bootstrap+in%3Abody+author%3Amdo&type=Issues) corresponde problemas escritos por @mdo que contêm a palavra "bootstrap" no texto. | +| author:app/USERNAME | [**author:app/robot**](https://github.com/search?q=author%3Aapp%2Frobot&type=Issues) corresponde a problemas criados pela conta de integração denominada "robot". | ### Pesquisar por responsável -O qualificador `assignee` encontra problemas e pull requests que foram atribuídos a um determinado usuário. You cannot search for issues and pull requests that have _any_ assignee, however, you can search for [issues and pull requests that have no assignee](#search-by-missing-metadata). +O qualificador `assignee` encontra problemas e pull requests que foram atribuídos a um determinado usuário. Não é possível pesquisar problemas e pull requests que têm _qualquer_ responsável, mas é possível pesquisar [problemas e pull requests que não tem nenhum responsável](#search-by-missing-metadata). | Qualifier | Exemplo | | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| assignee:USERNAME | [**assignee:vmg repo:libgit2/libgit2**](https://github.com/search?utf8=%E2%9C%93&q=assignee%3Avmg+repo%3Alibgit2%2Flibgit2&type=Issues) matches issues and pull requests in libgit2's project libgit2 that are assigned to @vmg. | +| assignee:USERNAME | [**assignee:vmg repo:libgit2/libgit2**](https://github.com/search?utf8=%E2%9C%93&q=assignee%3Avmg+repo%3Alibgit2%2Flibgit2&type=Issues) corresponde problemas e pull requests no libgit2 de libgit2 que foram atribuídos a @vmg. | ### Pesquisar por menção O qualificador `mentions` encontra problemas que mencionam um usuário específico. Para obter mais informações, consulte "[Mencionar pessoas e equipes](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)". -| Qualifier | Exemplo | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| mentions:USERNAME | [**resque mentions:defunkt**](https://github.com/search?q=resque+mentions%3Adefunkt&type=Issues) matches issues with the word "resque" that mention @defunkt. | +| Qualifier | Exemplo | +| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| mentions:USERNAME | [**resque mentions:defunkt**](https://github.com/search?q=resque+mentions%3Adefunkt&type=Issues) corresponde problemas com a palavra "resque" que mencionam @defunkt. | ### Pesquisar por menção da equipe Para organizações e equipes das quais você faz parte, você pode usar o qualificador `team` para encontrar problemas ou pull requests que fazem @menção a uma equipe específica na organização. Substitua os nomes de exemplo pelos nome da organização e da equipe para fazer uma pesquisa. -| Qualifier | Exemplo | -| ------------------------- | ----------------------------------------------------------------------------------------------------- | -| team:ORGNAME/TEAMNAME | **team:jekyll/owners** matches issues where the `@jekyll/owners` team is mentioned. | -| | **team:myorg/ops is:open is:pr** matches open pull requests where the `@myorg/ops` team is mentioned. | +| Qualifier | Exemplo | +| ------------------------- | ------------------------------------------------------------------------------------------------------------- | +| team:ORGNAME/TEAMNAME | **team:jekyll/owners** corresponde problemas em que a equipe `@jekyll/owners` é mencionada. | +| | **team:myorg/ops is:open is:pr** corresponde pull requests abertos em que a equipe `@myorg/ops` é mencionada. | ### Pesquisar por autor do comentário @@ -111,16 +111,16 @@ O qualificador `commenter` encontra problemas que contêm um comentário de um u | Qualifier | Exemplo | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| commenter:USERNAME | [**github commenter:defunkt org:github**](https://github.com/search?utf8=%E2%9C%93&q=github+commenter%3Adefunkt+org%3Agithub&type=Issues) matches issues in repositories owned by GitHub, that contain the word "github," and have a comment by @defunkt. | +| commenter:USERNAME | [**github commenter:defunkt org:github**](https://github.com/search?utf8=%E2%9C%93&q=github+commenter%3Adefunkt+org%3Agithub&type=Issues) corresponde problemas nos repositórios do GitHub que contêm a palavra "github" e têm um comentário de @defunkt. | ### Pesquisar por um usuário envolvido em um problema ou uma pull request Você pode usar o qualificador `involves` para encontrar problemas que envolvem de alguma forma um usuário específico. O qualificador `involves` é uma expressão lógica OR entre os qualificadores `author`, `assignee`, `mentions` e `commenter` para um único usuário. Em outras palavras, esse qualificador encontra problemas e pull requests que foram criados por um usuário, atribuídos a ele, que o mencionam ou que foram comentados por ele. -| Qualifier | Exemplo | -| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| involves:USERNAME | **[involves:defunkt involves:jlord](https://github.com/search?q=involves%3Adefunkt+involves%3Ajlord&type=Issues)** matches issues either @defunkt or @jlord are involved in. | -| | [**NOT bootstrap in:body involves:mdo**](https://github.com/search?q=NOT+bootstrap+in%3Abody+involves%3Amdo&type=Issues) matches issues @mdo is involved in that do not contain the word "bootstrap" in the body. | +| Qualifier | Exemplo | +| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| involves:USERNAME | **[involves:defunkt involves:jlord](https://github.com/search?q=involves%3Adefunkt+involves%3Ajlord&type=Issues)** corresponde problemas que envolvem @defunkt ou @jlord. | +| | [**NOT bootstrap in:body involves:mdo**](https://github.com/search?q=NOT+bootstrap+in%3Abody+involves%3Amdo&type=Issues) corresponde problemas que envolvem @mdo e não contêm a palavra "bootstrap" no texto. | {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} ### Procurar problema e pull requests vinculados diff --git a/translations/pt-BR/content/github/searching-for-information-on-github/searching-topics.md b/translations/pt-BR/content/github/searching-for-information-on-github/searching-topics.md index 6216c7b1e456..09a1e5ca4573 100644 --- a/translations/pt-BR/content/github/searching-for-information-on-github/searching-topics.md +++ b/translations/pt-BR/content/github/searching-for-information-on-github/searching-topics.md @@ -26,7 +26,7 @@ Se quiser explorar repositórios sobre um tópico específico, encontrar projeto O qualificador de pesquisa `is:featured` limita os resultados da pequisa aos tópicos com mais repositórios no {% data variables.product.product_name %}. Esses tópicos também são apresentados em https://github.com/topics/. -O qualificador de pesquisa `is:curated` limita os resultados da pequisa aos tópicos que os integrantes da comunidade adicionaram informações adicionais. For more information, see the [explore repository](https://github.com/github/explore). +O qualificador de pesquisa `is:curated` limita os resultados da pequisa aos tópicos que os integrantes da comunidade adicionaram informações adicionais. Para obter mais informações, consulte o [explorar o repositório](https://github.com/github/explore). Você pode filtrar os tópicos com base na data de criação usando parâmetro de data e `created:` ou com base em quantos repositórios estão associados ao tópico usando `repositories:n`. Esses dois qualificadores podem usar os [qualificadores maior que, menor que e intervalo](/articles/understanding-the-search-syntax). 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 48c1aef7d2ee..2645d52350be 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 @@ -10,7 +10,7 @@ versions: {% data reusables.github-actions.actions-billing %} -{% data reusables.github-actions.actions-spending-limit-brief %} For more information, see "[About spending limits](#about-spending-limits)." +{% data reusables.github-actions.actions-spending-limit-brief %} Para obter mais informações, consulte "[Sobre limites de gastos](#about-spending-limits)". Os minutos são reiniciados todos os meses, mas o uso do armazenamento não. @@ -73,6 +73,6 @@ Se uso de {% data variables.product.prodname_actions %} compartilha a data de co {% data reusables.github-actions.actions-spending-limit-detailed %} -For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions)." +Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, consulte "[Gerenciar seu limite de gastos para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-actions)". {% data reusables.dotcom_billing.actions-packages-unpaid-account %} 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 0acda75efa8c..57a18b62d843 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 @@ -10,7 +10,7 @@ versions: {% data reusables.package_registry.packages-billing %} -{% data reusables.package_registry.packages-spending-limit-brief %} For more information, see "[About spending limits](#about-spending-limits)." +{% data reusables.package_registry.packages-spending-limit-brief %} Para obter mais informações, consulte "[Sobre limites de gastos](#about-spending-limits)". {% data reusables.package_registry.container-registry-beta-billing-note %} @@ -54,6 +54,6 @@ Se uso de {% data variables.product.prodname_registry %} compartilha a data de c {% data reusables.package_registry.packages-spending-limit-detailed %} -For information on managing and changing your account's spending limit, see "[Managing your spending limit for {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages)." +Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, consulte "[Gerenciar seu limite de gastos para {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/managing-your-spending-limit-for-github-packages)". {% data reusables.dotcom_billing.actions-packages-unpaid-account %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md index 05d1cd39266f..29c00b76b45e 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/discounted-subscriptions-for-github-accounts.md @@ -18,11 +18,11 @@ versions: ### Descontos para contas pessoais -Além de repositórios públicos e privados ilimitados para alunos e docentes com o {% data variables.product.prodname_free_user %}, os alunos confirmados podem se inscrever no {% data variables.product.prodname_student_pack %} para receber outros benefícios de parceiros do {% data variables.product.prodname_dotcom %}. For more information, see "[Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)." +Além de repositórios públicos e privados ilimitados para alunos e docentes com o {% data variables.product.prodname_free_user %}, os alunos confirmados podem se inscrever no {% data variables.product.prodname_student_pack %} para receber outros benefícios de parceiros do {% data variables.product.prodname_dotcom %}. Para obter mais informações, consulte "[Aplicar a um pacote de desenvolvedor para estudante](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)". ### Descontos para escolas e universidades -Os docentes acadêmicos confirmados podem se inscrever na {% data variables.product.prodname_team %} para atividades de ensino ou pesquisa acadêmica. For more information, see "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)." Também é possível solicitar brindes de material educacional para os alunos. Para obter mais informações, visite [{% data variables.product.prodname_education %}](https://education.github.com/). +Os docentes acadêmicos confirmados podem se inscrever na {% data variables.product.prodname_team %} para atividades de ensino ou pesquisa acadêmica. Para obter mais informações, consulte "[Usar {% data variables.product.prodname_dotcom %} na sua sala de aula e pesquisa](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)". Também é possível solicitar brindes de material educacional para os alunos. Para obter mais informações, visite [{% data variables.product.prodname_education %}](https://education.github.com/). ### Descontos para organizações sem fins lucrativos e bibliotecas diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md index 973bef15682f..3af5b1f4806f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/downgrading-a-sponsorship.md @@ -9,9 +9,9 @@ versions: {% data reusables.sponsors.org-sponsors-release-phase %} -### About sponsorship downgrades +### Sobre downgrades de patrocínio -When you downgrade or cancel a sponsorship, the change will become effective on your next billing date. {% data reusables.sponsors.no-refunds %} +Ao fazer o downgrade ou cancelar um patrocínio, a alteração entrará em vigor na sua próxima data de cobrança. {% data reusables.sponsors.no-refunds %} ### Fazer downgrade de um patrocínio 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 4cdd70f72cd5..5ce1a7c6e527 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 @@ -12,11 +12,11 @@ versions: {% data reusables.github-actions.actions-spending-limit-brief %} -{% data reusables.actions.actions-packages-set-spending-limit %} 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 reusables.actions.actions-packages-set-spending-limit %} Para obter mais informações sobre os preços para uso de {% data variables.product.prodname_actions %}, consulte "[Sobre cobrança para {% data variables.product.prodname_actions %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-actions)". -As soon as you set a spending limit other than $0, you will be responsible for any existing overages in the current billing period. Por exemplo, se a sua organização usa o {% data variables.product.prodname_team %}, não permite excessos, e cria artefatos de fluxo de trabalho que aumentam seu uso de armazenamento para o mês de 1.9GB para 2.1GB, você usará um pouco mais de armazenamento do que os 2GB que seu produto inclui. +Assim que você definir um limite de gastos diferente de $ 0, você será responsável por todos os excedentes existentes no período de cobrança atual. Por exemplo, se a sua organização usa o {% data variables.product.prodname_team %}, não permite excessos, e cria artefatos de fluxo de trabalho que aumentam seu uso de armazenamento para o mês de 1.9GB para 2.1GB, você usará um pouco mais de armazenamento do que os 2GB que seu produto inclui. -Because you have not enabled overages, your next attempt to create a workflow artifact will fail. Você não receberá uma fatura pelo excesso de 0.1GB naquele mês. However, if you enable overages, your first bill will include the 0.1GB of existing overage for the current billing cycle, as well as any additional overages you accrue. +Como você não habilitou os excedentes, a sua próxima tentativa de criar um artefato de fluxo de trabalho falhará. Você não receberá uma fatura pelo excesso de 0.1GB naquele mês. No entanto, se você habilitar os excedentes, a sua primeira conta incluirá o 0,1 GB do excedente existente para o ciclo de cobrança atual, bem como qualquer superação adicional que você acumular. ### Gerenciando o limite de gastos de {% data variables.product.prodname_actions %} para sua conta de usuário 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 6334ab2ceac2..bbd37769ae76 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 @@ -12,11 +12,11 @@ versions: {% data reusables.package_registry.packages-spending-limit-brief %} -{% data reusables.actions.actions-packages-set-spending-limit %} 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 reusables.actions.actions-packages-set-spending-limit %} Para obter mais informações sobre os preços para uso de {% data variables.product.prodname_registry %}, consulte "[Sobre cobrança para {% data variables.product.prodname_registry %}](/github/setting-up-and-managing-billing-and-payments-on-github/about-billing-for-github-packages)". -As soon as you set a spending limit other than $0, you will be responsible for any existing overages in the current billing period. Por exemplo, se a sua organização usa o {% data variables.product.prodname_team %}, não permite excessos, e publica uma nova versão de um pacote privado que aumenta seu uso de armazenamento para o mês de 1.9GB para 2.1GB, a publicar a versão, você usará um pouco mais de armazenamento do que os 2GB que seu produto inclui. +Assim que você definir um limite de gastos diferente de $ 0, você será responsável por todos os excedentes existentes no período de cobrança atual. Por exemplo, se a sua organização usa o {% data variables.product.prodname_team %}, não permite excessos, e publica uma nova versão de um pacote privado que aumenta seu uso de armazenamento para o mês de 1.9GB para 2.1GB, a publicar a versão, você usará um pouco mais de armazenamento do que os 2GB que seu produto inclui. -Como você não ativou os excessos, sua próxima tentativa de publicar uma versão do pacote irá falhar. Você não receberá uma fatura pelo excesso de 0.1GB naquele mês. However, if you enable overages, your first bill will include the 0.1GB of existing overage for the current billing cycle, as well as any additional overages you accrue. +Como você não ativou os excessos, sua próxima tentativa de publicar uma versão do pacote irá falhar. Você não receberá uma fatura pelo excesso de 0.1GB naquele mês. No entanto, se você habilitar os excedentes, a sua primeira conta incluirá o 0,1 GB do excedente existente para o ciclo de cobrança atual, bem como qualquer superação adicional que você acumular. ### Gerenciando o limite de gastos de {% data variables.product.prodname_registry %} para sua conta de usuário diff --git a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md index d1df520918f9..fae13b17db8d 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-billing-and-payments-on-github/upgrading-a-sponsorship.md @@ -9,7 +9,7 @@ versions: {% data reusables.sponsors.org-sponsors-release-phase %} -### About sponsorship upgrades +### Sobre atualizações de patrocínio Quando você atualiza a camada do patrocínio, a alteração entra em vigor imediatamente. {% data reusables.sponsors.prorated-sponsorship %} 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 b6edad6a2ac6..a7f614c59a1b 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 @@ -20,7 +20,7 @@ versions: ### 1. Fazer backup do conteúdo da organização -Depois que você exclui uma organização, o GitHub **não pode restaurar o conteúdo que você tem lá**. Therefore, before you delete your organization, make sure you have a copy of all repositories, wikis, issues, and project boards from the account. +Depois que você exclui uma organização, o GitHub **não pode restaurar o conteúdo que você tem lá**. Portanto, antes de excluir sua organização, certifique-se de ter uma cópia de todos os repositórios, wikis, problemas e quadros de projetos da conta. ### 2. Excluir a organização diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md index a1494e70d46c..b8d2499e63c0 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/disabling-oauth-app-access-restrictions-for-your-organization.md @@ -19,4 +19,4 @@ versions: {% data reusables.organizations.org_settings %} {% data reusables.organizations.oauth_app_access %} 5. Clique em **Remove restrictions** (Remover restrições). ![Botão Remove restrictions (Remover restrições)](/assets/images/help/settings/settings-third-party-remove-restrictions.png) -6. Depois de revisar as informações sobre desabilitação de restrições de aplicativos de terceiros, clique em **Yes, remove application restrictions** (Sim, remover restrições de aplicativos). ![Remove confirmation button](/assets/images/help/settings/settings-third-party-confirm-disable.png) +6. Depois de revisar as informações sobre desabilitação de restrições de aplicativos de terceiros, clique em **Yes, remove application restrictions** (Sim, remover restrições de aplicativos). ![Botão de remover confirmação](/assets/images/help/settings/settings-third-party-confirm-disable.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md index 2c4efbef23e6..1d73dc2cf22f 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization.md @@ -1,25 +1,25 @@ --- -title: Managing discussion creation for repositories in your organization -intro: You can choose the permission levels that members require to create discussions in repositories owned by your organization. -permissions: Organization owners can manage discussion creation for repositories owned by the organization. +title: Gerenciar criação de discussões para repositórios na sua organização +intro: Você pode escolher os níveis de permissão exigidos pelos integrantes para criar discussões em repositórios pertencentes à sua organização. +permissions: Os proprietários da organização podem gerenciar a criação de discussões para repositórios pertencentes à organização. versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Allowing or disallowing users with read access to create discussions +### Permitir ou impedir usuários com acesso de leitura para criar discussões -By default, organization members with read access can create discussions if a repository administrator or organization owner enables discussions for a repository owned by the organization. +Por padrão, integrantes da organização com acesso de leitura podem criar discussões se um administrador ou proprietário da organização habilitar discussões para um repositório pertencente à organização. {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Repository discussions", select or deselect **Allow users with read access to create discussions**. ![Checkbox to allow people with read access to create discussions](/assets/images/help/discussions/toggle-allow-users-with-read-access-checkbox.png) -6. Clique em **Salvar**. !["Save" button for discussions settings](/assets/images/help/discussions/click-save.png) +5. Em "Discussões do repositório, selecione ou desmarque **Permitir que os usuários com acesso de leitura criem discussões**. ![Caixa de seleção para permitir que pessoas com acesso de leitura criem discussões](/assets/images/help/discussions/toggle-allow-users-with-read-access-checkbox.png) +6. Clique em **Salvar**. ![Botão "Salvar" para configurações de discussões](/assets/images/help/discussions/click-save.png) ### Leia mais -- "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" -- "[Managing discussions for your community](/discussions/managing-discussions-for-your-community)" +- "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" +- "[Gerenciar discussões para a sua comunidade](/discussions/managing-discussions-for-your-community)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md index 373a6aa0f8af..c3df4b4ca215 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-security-and-analysis-settings-for-your-organization.md @@ -12,35 +12,35 @@ O {% data variables.product.prodname_dotcom %} pode ajudar a proteger os reposit {% data reusables.security.some-security-and-analysis-features-are-enabled-by-default %} {% data reusables.security.security-and-analysis-features-enable-read-only %} -### Displaying the security and analysis settings +### Exibir as configurações de segurança e análise {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.security-and-analysis %} -The page that's displayed allows you to enable or disable security and analysis features for the repositories in your organization. +A página exibida permite que você habilite ou desabilite os recursos de segurança e análise dos repositórios na sua organização. -### Enabling or disabling a feature for all existing repositories +### Habilitar ou desabilitar um recurso para todos os repositórios existentes -1. Go to the security and analysis settings for your organization. For more information, see "[Displaying the security and analysis settings](#displaying-the-security-and-analysis-settings)." +1. Acesse as configurações de segurança e análise da sua organização. Para obter mais informações, consulte "[Exibir as configurações de segurança e análise](#displaying-the-security-and-analysis-settings)". 1. Em "Configurar recursos de segurança e análise" à direita do recurso, clique em **Desabilitar tudo** ou **Habilitar tudo**. ![Botão "Habilitar tudo" ou "Desabilitar tudo" para os recursos de "Configurar segurança e análise"](/assets/images/help/organizations/security-and-analysis-disable-or-enable-all.png) 1. Opcionalmente, habilite o recurso para novos repositórios na organização por padrão. ![Opção de "Habilitar por padrão" para novos repositórios](/assets/images/help/organizations/security-and-analysis-enable-by-default-in-modal.png) 1. Clique em **Desabilitar RECURSO** ou **Habilitar RECURSO** para desabilitar ou habilitar o recurso para todos os repositórios da sua organização. ![Botão para desabilitar ou habilitar recurso](/assets/images/help/organizations/security-and-analysis-enable-dependency-graph.png) -### Enabling or disabling a feature for all new repositories when they are added +### Habilitar ou desabilitar um recurso para todos os novos repositórios quando forem adicionados -1. Go to the security and analysis settings for your organization. For more information, see "[Displaying the security and analysis settings](#displaying-the-security-and-analysis-settings)." +1. Acesse as configurações de segurança e análise da sua organização. Para obter mais informações, consulte "[Exibir as configurações de segurança e análise](#displaying-the-security-and-analysis-settings)". 1. Em "Configurar recursos de segurança e análise", à direita do recurso, habilite ou desabilite o recurso por padrão para novos repositórios na sua organização. ![Caixa de seleção para habilitar ou desabilitar um recurso para novos repositórios](/assets/images/help/organizations/security-and-analysis-enable-or-disable-feature-checkbox.png) -### Allowing Dependabot to access private repositories +### Permitir que o Dependabot acesse repositórios privados -{% data variables.product.prodname_dependabot %} can check for outdated dependency references in a project and automatically generate a pull request to update them. To do this, {% data variables.product.prodname_dependabot %} must have access to the targeted dependency files. By default, {% data variables.product.prodname_dependabot %} can't update dependencies that are located in private repositories. However, if a dependency is in a private {% data variables.product.prodname_dotcom %} repository within the same organization as the project that uses that dependency, you can allow {% data variables.product.prodname_dependabot %} to update the version successfully by giving it access to the host repository. For more information, including details of limitations to private dependency support, see "[About Dependabot version updates](/github/administering-a-repository/about-dependabot-version-updates)." +{% data variables.product.prodname_dependabot %} pode verificar referências de dependências desatualizadas em um projeto e gerar automaticamente um pull request para atualizá-las. Para fazer isso, {% data variables.product.prodname_dependabot %} deve ter acesso aos arquivos de dependência de destino. Por padrão, {% data variables.product.prodname_dependabot %} não pode atualizar as dependências localizadas em repositórios privados. Entretanto, se uma dependência estiver em um repositório privado de {% data variables.product.prodname_dotcom %} dentro da mesma organização que o projeto que usa essa dependência, você pode permitir que {% data variables.product.prodname_dependabot %} atualize a versão com sucesso, dando-lhe acesso à hospedagem do repositório. Para obter mais informações, incluindo detalhes das limitações para o suporte de dependências privadas, consulte "[Sobre atualizações da versão do Dependabot](/github/administering-a-repository/about-dependabot-version-updates)". -1. Go to the security and analysis settings for your organization. For more information, see "[Displaying the security and analysis settings](#displaying-the-security-and-analysis-settings)." -1. In the "{% data variables.product.prodname_dependabot %} repository access" section, click the settings button **{% octicon "gear" aria-label="The Gear icon" %}**. ![Repository access setting button](/assets/images/help/organizations/repository-access-cog-button.png) A list is displayed showing all of the private repositories in your organization. ![The Repositories list](/assets/images/help/organizations/repositories-dialog.png) -1. Select the repositories that {% data variables.product.prodname_dependabot %} can access. -1. Click **Select repositories**. +1. Acesse as configurações de segurança e análise da sua organização. Para obter mais informações, consulte "[Exibir as configurações de segurança e análise](#displaying-the-security-and-analysis-settings)". +1. Na seção "acesso ao repositório de {% data variables.product.prodname_dependabot %}" clique no botão de configurações **{% octicon "gear" aria-label="The Gear icon" %}**. ![Repository access setting button](/assets/images/help/organizations/repository-access-cog-button.png) Uma lista é exibida mostrando todos os repositórios privados da sua organização. ![A lista de repositórios](/assets/images/help/organizations/repositories-dialog.png) +1. Selecione os repositórios que {% data variables.product.prodname_dependabot %} pode acessar. +1. Clique em **Selecionar repositórios**. ### Leia mais 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 1a56221145b1..34824faacd6e 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,19 +1,19 @@ --- -title: Managing the forking policy for your organization -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" or currentVersion == "github-ae@latest" %} and internal{% endif %} repositories owned by your organization.' +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" or currentVersion == "github-ae@latest" %} ou interno{% endif %} 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 -permissions: Organization owners can manage the forking policy for an organization. +permissions: Os proprietários da organização podem gerenciar a política de bifurcação de uma organização. versions: free-pro-team: '*' enterprise-server: '*' github-ae: '*' --- -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" or currentVersion == "github-ae@latest" %} and internal{% endif %} repositories. +Por padrão, as novas organizações são configuradas para impedir a bifurcação dos repositórios privados {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2. 9" or currentVersion == "github-ae@latest" %} e internos{% endif %}. -If you allow forking of private{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %} 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 currentVersion == "github-ae@latest" %} or internal{% endif %} repository. For more information, see "[Managing the forking policy for your repository](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)." +Se você permite a bifurcação do repositório privado{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" or currentVersion == "github-ae@latest" %} e interno{% 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" or currentVersion == "github-ae@latest" %} 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)". {% data reusables.organizations.internal-repos-enterprise %} @@ -21,11 +21,10 @@ If you allow forking of private{% if currentVersion == "free-pro-team@latest" or {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.member-privileges %} -5. Under "Repository forking", select **Allow forking of private repositories** or **Allow forking of private and internal repositories**. - ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-organization.png) -6. Click **Save**. +5. Em "Bifurcação do repositório", selecione **Permitir bifurcação de repositórios privados** ou **Permitir bifurcação de repositórios internos e privados**. ![Caixa de seleção para permitir ou proibir a bifurcação na organização](/assets/images/help/repository/allow-disable-forking-organization.png) +6. Clique em **Salvar**. -### Further reading +### Leia mais -- "[About forks](/articles/about-forks)" -- "[Repository permission levels for an organization](/articles/repository-permission-levels-for-an-organization)" +- "[Sobre bifurcações](/articles/about-forks)" +- "[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-updates-from-accounts-your-organization-sponsors.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md index 3c299456e6ee..7b8c1366843d 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors.md @@ -1,23 +1,23 @@ --- -title: Managing updates from accounts your organization sponsors -intro: You can manage the email address that receives updates from accounts your organization sponsors. +title: Gerenciar atualizações de contas que a sua organização patrocina +intro: Você pode gerenciar o endereço de e-mail que recebe atualizações de contas patrocinadas pela sua organização. versions: free-pro-team: '*' -permissions: Organization owners can manage updates from accounts the organization sponsors. +permissions: Os proprietários da organização podem gerenciar atualizações a partir de contas que a organização patrocina. --- {% data reusables.sponsors.org-sponsors-release-phase %} -The developers and organizations that your organization sponsors can send you updates about their work. You can manage the email address that receives these updates. +Os desenvolvedores e as organizações que sua organização patrocina podem enviar atualizações sobre o seu trabalho para você. Você pode gerenciar o endereço de e-mail que recebe essas atualizações. -You can also disable updates from accounts your organization sponsors. Para obter mais informações, consulte "[Gerenciar o patrocínio](/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship#managing-email-updates-for-your-sponsorship)". +Você também pode desabilitar atualizações de contas que a sua organização patrocina. Para obter mais informações, consulte "[Gerenciar o patrocínio](/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship#managing-email-updates-for-your-sponsorship)". {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} -1. Under "Sponsors update email (Private)", type the email address you want to receive updates from accounts your organization sponsors. ![Textbox to enter the email address to receive updates from sponsored accounts](/assets/images/help/sponsors/organization-update-email-textbox.png) +1. Em "E-mail de atualização de patrocínios (Privado)", digite o endereço de e-mail em que deseja receber atualizações de contas patrocinadas pela sua organização. ![Caixa de texto para inserir o endereço de email para receber atualizações de contas patrocinadas](/assets/images/help/sponsors/organization-update-email-textbox.png) 1. Clique em **Update profile** (Atualizar perfil). ![Botão Update profile (Atualizar perfil)](/assets/images/help/organizations/update-profile-button.png) ### Leia mais -- "[Supporting the open source community with {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors)" \ No newline at end of file +- "[Apoiar a comunidade de código aberto com {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors)" \ No newline at end of file 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 85584e4752a7..4f4cd7136b55 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 @@ -39,6 +39,7 @@ Os integrantes da organização podem ter funções de *proprietário*{% if curr | 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** | | | +| Restringir notificações de e-mail a domínios verificados (consulte "[Restringir notificações de e-mail para um domínio aprovado](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)" para obter informações) | **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** | | @@ -55,9 +56,9 @@ Os integrantes da organização podem ter funções de *proprietário*{% if curr | 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** | | | -| Sponsor accounts and manage the organization's sponsorships (see "[Sponsoring open-source contributors](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)" for details) | **X** | **X** | | -| Manage email updates from sponsored accounts (see "[Managing updates from accounts your organization's sponsors](/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors)" for details) | **X** | | | -| Attribute your sponsorships to another organization (see "[Attributing sponsorships to your organization](/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization)" for details ) | **X** | | | +| Patrocinar contas e gerenciar os patrocínios da organização (Consulte "[Patrocinar contribuidoresde código aberto](/github/supporting-the-open-source-community-with-github-sponsors/sponsoring-open-source-contributors)" para mais detalhes) | **X** | **X** | | +| Gerenciar atualizações de e-mail de contas patrocinadas (consulte "[Gerenciar atualizações de contas que a sua organização patrocina](/github/setting-up-and-managing-organizations-and-teams/managing-updates-from-accounts-your-organization-sponsors)" para obter detalhes) | **X** | | | +| Atribuir seus patrocínios a outra organização (consulte "[Atribuir de patrocínios à sua organização](/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization)" para obter mais 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** | | | 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 11a1b19126cf..b02423a03494 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 @@ -59,8 +59,9 @@ Além de gerenciar as configurações da organização, os proprietários da org | 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** | -| Create, edit, delete labels | | | **X** | **X** | **X** | -| Fechar, reabrir e atribuir todos os problemas e pull requests | | **X** | **X** | **X** | **X** | +| Criar, editar, excluir etiquetas | | | **X** | **X** | **X** | +| Fechar, reabrir e atribuir todos os problemas e pull requests | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Habilitar e desabilitar o merge automático em um pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | 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** | @@ -118,15 +119,15 @@ Além de gerenciar as configurações da organização, os proprietários da org | Criar [consultorias de segurança](/github/managing-security-vulnerabilities/about-github-security-advisories) | | | | | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [Visualizar 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) | **X** | **X** | **X** | **X** | **X** | | [Lista, descarta e exclui alertas de {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/managing-code-scanning-alerts-for-your-repository) | | | **X** | **X** | **X** |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| [Enable {% data variables.product.prodname_discussions %}](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository) in a repository | | | | **X** | **X** | -| [Create and edit categories](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository) for {% data variables.product.prodname_discussions %} | | | | **X** | **X** | -| [Move a discussion to a different category](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | -| [Transfer a discussion](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) to a new repository | | | **X** | **X** | **X** | -| [Manage pinned discussions](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | -| [Convert issues to discussions in bulk](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | -| [Lock and unlock discussions](/discussions/managing-discussions-for-your-community/moderating-discussions) | | **X** | **X** | **X** | **X** | -| [Individually convert issues to discussions](/discussions/managing-discussions-for-your-community/moderating-discussions) | | **X** | **X** | **X** | **X** | -| [Create new discussions and comment on existing discussions](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion) | **X** | **X** | **X** | **X** | **X** |{% endif %} +| [Habilitar {% data variables.product.prodname_discussions %}](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository) em um repositório | | | | **X** | **X** | +| [Criar e editar categorias](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository) para {% data variables.product.prodname_discussions %} | | | | **X** | **X** | +| [Mover uma discussão para uma categoria diferente](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | +| [Transferir uma discussão](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) para um novo repositório | | | **X** | **X** | **X** | +| [Gerenciar discussões fixadas](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | +| [Converter problemas para discussões em massa](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository) | | | **X** | **X** | **X** | +| [Bloquear e desbloquear discussões](/discussions/managing-discussions-for-your-community/moderating-discussions) | | **X** | **X** | **X** | **X** | +| [Converter individualmente problemas em discussões](/discussions/managing-discussions-for-your-community/moderating-discussions) | | **X** | **X** | **X** | **X** | +| [Criar novas discussões e comentar em discussões existentes](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion) | **X** | **X** | **X** | **X** | **X** |{% endif %} ### Leia mais diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index adba557615ef..ba899819fd52 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -Quando as restrições das notificações de e-mail são habilitadas na organização, os integrantes só conseguem receber notificações de e-mail sobre atividades da organização em um endereço de e-mail associado ao domínio verificado da organização. Para obter mais informações, consulte "[Verificar o domínio da sua organização](/articles/verifying-your-organization-s-domain)". +### Sobre restrições de e-mail + +Quando notificações de e-mail restritas são habilitadas em uma organização, os integrantes só podem usar um endereço de e-mail associado aos domínios verificados da organização para receber notificações de e-mail sobre a atividade da organização. Para obter mais informações, consulte "[Verificar o domínio da sua organização](/articles/verifying-your-organization-s-domain)". Os colaboradores externos não estão sujeitos a restrições de notificações por e-mail para domínios verificados. 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)". +Se a sua organização pertencer a uma conta corporativa, os integrantes da organização poderão receber notificações sobre quaisquer domínios verificados para a conta corporativa, além de quaisquer domínios verificados para a organização. Para obter mais informações, consulte "[Verificar o domínio da sua conta corporativa](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)". + +### Restringir notificações de e-mail para um domínio aprovado + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. Em "Enforcement preferences" (Preferências de aplicação), selecione **Restrict email notifications to domain email** (Restringir notificações de e-mail aos e-mails do domínio). ![Caixa de seleção para restringir as notificações de e-mail aos e-mails do domínio verificado](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. Clique em **Salvar**. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md index 15f6e26b5662..e44350b84bed 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/restricting-repository-visibility-changes-in-your-organization.md @@ -9,7 +9,7 @@ versions: github-ae: '*' --- -You can restrict the ability to change repository visibility to organization owners only, or allow members with admin privileges for a repository to also change visibility. +Você pode restringir a capacidade de alterar a visibilidade do repositório apenas para os proprietários da organização, ou permitir que os integrantes com privilégios de administrador de um repositório também alterem a visibilidade. {% warning %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index d1cc68bce1d0..26c9cd662e0d 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### Sobre a verificação do domínio + Para verificar domínios no {% data variables.product.product_name %}, você deve ter permissões de proprietário na organização. Para obter mais informações, consulte "[Níveis de permissão para uma organização](/articles/permission-levels-for-an-organization)". Você também precisará de acesso para modificar registros de domínio com o serviço de hospedagem de domínio. Após a verificação da propriedade dos domínios da sua organização, é exibido um selo "Verified" (Verificado) no perfil da organização. Se ela estiver no {% data variables.product.prodname_ghe_cloud %} e tiver concordado com os Termos de serviço corporativos, os proprietários da organização poderão verificar a identidade dos integrantes dela exibindo o endereço de e-mail de cada um deles no domínio verificado. Para obter mais informações, consulte "[Sobre a página de perfil da sua organização](/articles/about-your-organization-s-profile/)" e "[Atualizar para os Termos de serviço corporativos](/articles/upgrading-to-the-corporate-terms-of-service)". -Para exibir um selo "Verified" (Verificado), é preciso que as informações do e-mail e do site mostradas no perfil da organização correspondam aos domínios verificados. Se o site e o endereço de e-mail mostrados no perfil da organização estiverem hospedados em domínios diferentes, você deverá verificar os dois domínios. - -{% note %} - -**Observação:** se o endereço de e-mail e o site mostrados no perfil da organização usarem variantes do mesmo domínio, será preciso verificar ambas. Por exemplo, se o perfil da sua organização mostra o site `www.example.com` e o endereço de e-mail `info@example.com`, você deve verificar tanto `www.example.com` como `example.com`. +Se sua organização pertence a uma conta corporativa, será exibido um selo "Verificado" no perfil da sua organização para quaisquer domínios verificados para a conta corporativa, além de quaisquer domínios verificados para a organização. Para obter mais informações, consulte "[Verificar o domínio da sua conta corporativa](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)". -{% endnote %} +{% data reusables.organizations.verified-domains-details %} No {% data variables.product.prodname_ghe_cloud %}, após a verificação da propriedade do domínio da sua organização, você pode restringir as notificações de email para a organização a esse domínio. 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)." +### Verificar o domínio da organização + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. Clique em **Add a domain** (Adicionar um domínio). ![Botão Add a domain (Adicionar um domínio)](/assets/images/help/organizations/add-a-domain-button.png) -6. No campo de domínio, digite o domínio que deseja verificar e clique em **Add domain** (Adicionar domínio). ![Campo Add a domain (Adicionar um domínio)](/assets/images/help/organizations/add-domain-field.png) -7. Para criar um registro TXT DNS com o serviço de hospedagem de domínio, siga as instruções em **Add a DNS TXT record** (Adicionar um registro TXT DNS). Pode demorar até 72 horas para a configuração do DNS ser alterada. Uma vez confirmada a alteração, avance para a próxima etapa. ![Instruções para criar um registro TXT DNS](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **Dica:** você pode confirmar se a configuração do DNS foi alterada executando o comando `dig` na linha de comando. No exemplo de comando, substitua `ORGANIZATION` pelo nome da sua organização e `example.com` pelo domínio que deseja verificar. Você deverá ver o novo registro TXT listado na saída do comando. - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Aguarde a alteração da configuração de DNS, que pode demorar até 72 horas. Você pode confirmar que a configuração do DNS foi alterada executando o comando `dig` na linha de comando, substituindo `ORGANIZATION` pelo nome da sua organização e `example.com` pelo o domínio que você gostaria de verificar. Você deverá ver o novo registro TXT listado na saída do comando. ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - 8. Depois de confirmar que o registro TXT foi adicionado ao DNS, navegue até a guia Verified domain (Domínios verificados) nas configurações da organização. Siga as etapas 1 a 4 acima para localizar a guia Verified domains (Domínios verificados). ![Página de configurações de domínios verificados com domínio pendente](/assets/images/help/organizations/pending-domain-verification.png) -9. Ao lado do domínio com verificação pendente, clique em {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} e depois em **Continue verifying** (Continuar a verificação). ![Botão do domínio Continue verifying (Continuar a verificação)](/assets/images/help/organizations/continue-verifying-domain.png) -10. Clique em **Verify domain** (Verificar domínio). ![Botão Verify domain (Verificar domínio)](/assets/images/help/organizations/verify-domain-final-button.png) +{% data reusables.organizations.continue-verifying-domain %} 11. Depois que o selo "Verified" (Verificado) estiver visível na página de perfil da sua organização, a entrada TXT poderá ser excluída do registro DNS no serviço de hospedagem de domínio. ![Selo Verified (Verificado)](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md index 279c02212a1c..1128ff559164 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/about-enterprise-accounts.md @@ -20,7 +20,7 @@ Uma conta corporativa permite que você gerencie múltiplas organizações {% da - Segurança (logon único, autenticação de dois fatores) - Solicitações e compartilhamento de pacote de suporte com {% data variables.contact.enterprise_support %} -{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." Para obter mais informações sobre como gerenciar suas configurações de cobrança de {% data variables.product.prodname_ghe_server %}, consulte "[Gerenciar cobrança para sua empresa](/admin/overview/managing-billing-for-your-enterprise)". +{% data reusables.enterprise-accounts.enterprise-accounts-billing %} Para obter mais informações sobre como gerenciar sua assinatura de {% data variables.product.prodname_ghe_cloud %}, consulte "[Visualizar a assinatura e o uso para sua conta corporativa](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)". Para obter mais informações sobre como gerenciar suas configurações de cobrança de {% data variables.product.prodname_ghe_server %}, consulte "[Gerenciar cobrança para sua empresa](/admin/overview/managing-billing-for-your-enterprise)". Para obter mais informações sobre o {% data variables.product.prodname_ghe_cloud %} e {% data variables.product.prodname_ghe_server %}, consulte "[Produtos do {% data variables.product.prodname_dotcom %}](/articles/github-s-products)". Para atualizar para {% data variables.product.prodname_enterprise %} ou para começar com uma conta corporativa, entre em contato com {% data variables.contact.contact_enterprise_sales %}. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/index.md index 72035f7b2ce0..aafad0d5d94a 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..cd412d736462 --- /dev/null +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restringir notificações de e-mail da conta corporativa para domínios aprovados +intro: "Você pode impedir que as informações da sua empresa vazem para contas pessoais, restringindo notificações de e-mail sobre a atividade em organizações pertencentes à sua conta corporativa para domínios verificados." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Os proprietários das empresas podem restringir notificações de e-mail para uma conta corporativa. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### Sobre restrições de e-mail para a sua conta corporativa + +Ao restringir notificações de e-mail para domínios verificados, os integrantes da empresa só poderão usar um endereço de e-mail associado a um domínio verificado para receber notificações de e-mail sobre a atividade em organizações pertencentes à sua conta corporativa. Os domínios podem ser herdados da conta corporativa ou configurados para a organização específica. Para obter mais informações sobre restrições de e-mail para organizações, consulte "[Restringir notificações de e-mail para um domínio aprovado](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)". + +Se restrições de e-mail estiverem habilitadas para uma conta corporativa, os proprietários da organização não poderão desabilitar restrições de e-mail para qualquer organização que pertence à conta corporativa. Se ocorrerem alterações que resultem em uma organização não ter domínios verificados, herdado de uma conta corporativa pertencente à organização ou para uma organização específica, as restrições de e-mail serão desabilitadas para a organização. + +### Restringir notificações de e-mail para a conta corporativa + +Antes de restringir as notificações de e-mail para a conta corporativa, você deve verificar pelo menos um domínio para a conta corporativa. Para obter mais informações, consulte "[Verificar o domínio da sua conta corporativa](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)". + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. Clique em **Salvar**. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..4c158e0680c6 --- /dev/null +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verificar o domínio da conta corporativa +intro: 'Você pode confirmar a identidade das organizações pertencentes à conta corporativa verificando a propriedade dos nomes de domínio com {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Os proprietários das empresas podem verificar o domínio de uma conta corporativa. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### Sobre a verificação do domínio + +Você pode confirmar que os sites e endereços de e-mail listados nos perfis de qualquer organização pertencente à sua conta corporativa são controlados pela sua empresa verificando os domínios. Os domínios verificados para uma conta corporativa aplicam-se a todas as organizações pertencentes à conta corporativa, e os proprietários da organização podem verificar domínios adicionais para suas organizações. 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)." + +Depois de verificar a propriedade dos domínios da sua conta, será exibido um selo "Verificado" no perfil de cada organização com o domínio listado no seu perfil. {% data reusables.organizations.verified-domains-details %} + +Os proprietários da organização conseguirão de verificar a identidade dos integrantes da organização, visualizando o endereço de e-mail de cada integrante dentro do domínio verificado. + +Após verificar domínios para a sua conta corporativa, você poderá restringir notificações de e-mail para domínios verificados para todas as organizações pertencentes à sua conta corporativa. Para obter mais informações, consulte "[Restringir notificações de e-mail da sua conta corporativa para domínios aprovados](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)". + +Mesmo se você não restringir as notificações de e-mail para a conta corporativa, se o proprietário da organização tiver restringido as notificações de e-mail para a organização, os integrantes da organização poderão receber notificações de qualquer domínio verificado pela conta corporativa, além de qualquer domínio verificado para a organização. Para obter mais informações sobre restrição de notificações para uma organização, consulte "[Restringir notificações de e-mail para um domínio aprovado](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain). + +### Verificar o domínio da conta corporativa + +Para verificar o domínio da sua conta corporativa, você deve ter acesso para modificar registros de domínio com o seu serviço de hospedagem de domínio. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. Clique em **Add a domain** (Adicionar um domínio). ![Botão Add a domain (Adicionar um domínio)](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Aguarde a alteração da configuração de DNS, que pode demorar até 72 horas. Você pode confirmar que a configuração do DNS foi alterada executando o comando `dig` na linha de comando, substituindo `ENTERPRISE-CONTA` pelo nome da conta corporativa e `example.com` pelo o domínio que você gostaria de verificar. Você deverá ver o novo registro TXT listado na saída do comando. + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Opcionalmente, depois que o selo "Verificado" estiver visível nos perfis da sua organização, exclua a entrada TXT do registro do DNS no seu serviço de hospedagem de domínio. ![Selo Verified (Verificado)](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 4e5a892d3836..b2ba70604a67 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 @@ -1,6 +1,6 @@ --- -title: Sobre seu perfil -intro: 'Sua página de perfil conta a história do seu trabalho por meio de repositórios nos quais você está interessado, das contribuições que fez e das conversas que teve.' +title: About your profile +intro: 'Your profile page tells people the story of your work through the repositories you''re interested in, the contributions you''ve made, and the conversations you''ve had.' redirect_from: - /articles/viewing-your-feeds/ - /articles/profile-pages/ @@ -11,29 +11,29 @@ versions: github-ae: '*' --- -Você pode adicionar informações pessoais sobre si mesmo na bio, como locais em que trabalhou anteriormente, os projetos com os quais contribuiu ou interesses que você tem que outras pessoas talvez gostem de saber. Para obter mais informações, consulte "[Adicionar uma bio ao seu perfil](/articles/personalizing-your-profile/#adding-a-bio-to-your-profile)". +You can add personal information about yourself in your bio, like previous places you've worked, projects you've contributed to, or interests you have that other people may like to know about. For more information, see "[Adding a bio to your profile](/articles/personalizing-your-profile/#adding-a-bio-to-your-profile)." {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% data reusables.profile.profile-readme %} -![Arquivo LEIAME do perfil exibido no perfil](/assets/images/help/repository/profile-with-readme.png) +![Profile README file displayed on profile](/assets/images/help/repository/profile-with-readme.png) {% endif %} -As pessoas que visitam seu perfil veem uma linha do tempo da sua atividade de contribuição, como problemas e pull requests que abriu, commits que fez e pull requests que revisou. Você pode optar por exibir apenas contribuições públicas ou também incluir contribuições privadas e anônimas. Para obter mais informações, consulte "[Exibir contribuições na sua página de perfil](/articles/viewing-contributions-on-your-profile-page)" ou "[Mostrar ou ocultar contribuições privadas no perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)". +People who visit your profile see a timeline of your contribution activity, like issues and pull requests you've opened, commits you've made, and pull requests you've reviewed. You can choose to display only public contributions or to also include private, anonymized contributions. For more information, see "[Viewing contributions on your profile page](/articles/viewing-contributions-on-your-profile-page)" or "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)." People who visit your profile can also see the following information. -- Repositórios e gists que você possui ou com os quais contribui. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}You can showcase your best work by pinning repositories and gists to your profile. Para obter mais informações, consulte "[Fixar itens no seu perfil](/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile)".{% endif %} -- 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. 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" %} -- Badges that show if you use {% data variables.product.prodname_pro %} or participate in programs like the {% data variables.product.prodname_arctic_vault %}, {% data variables.product.prodname_sponsors %}, or the {% data variables.product.company_short %} Developer Program. Para obter mais informações, consulte "[Personalizar seu perfil](/github/setting-up-and-managing-your-github-profile/personalizing-your-profile#displaying-badges-on-your-profile)".{% endif %} +- Repositories and gists you own or contribute to. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}You can showcase your best work by pinning repositories and gists to your profile. For more information, see "[Pinning items to your profile](/github/setting-up-and-managing-your-github-profile/pinning-items-to-your-profile)."{% endif %} +- Repositories you've starred. For more information, see "[Saving repositories with stars](/articles/saving-repositories-with-stars/)." +- An overview of your activity in organizations, repositories, and teams you're most active in. 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" %} +- Badges that show if you use {% data variables.product.prodname_pro %} or participate in programs like the {% data variables.product.prodname_arctic_vault %}, {% data variables.product.prodname_sponsors %}, or the {% data variables.product.company_short %} Developer Program. For more information, see "[Personalizing your profile](/github/setting-up-and-managing-your-github-profile/personalizing-your-profile#displaying-badges-on-your-profile)."{% endif %} -Você também pode definir um status no seu perfil para fornecer informações sobre a sua disponibilidade. Para obter mais informações, consulte "[Configurar um status](/articles/personalizing-your-profile/#setting-a-status)". +You can also set a status on your profile to provide information about your availability. For more information, see "[Setting a status](/articles/personalizing-your-profile/#setting-a-status)." -### Leia mais +### Further reading -- "[Como configurar minha foto de perfil?](/articles/how-do-i-set-up-my-profile-picture)" -- "[Mostrar ou ocultar contribuições privadas no perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)" -- "[Exibir contribuições no perfil](/articles/viewing-contributions-on-your-profile)" +- "[How do I set up my profile picture?](/articles/how-do-i-set-up-my-profile-picture)" +- "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)" +- "[Viewing contributions on your profile](/articles/viewing-contributions-on-your-profile)" 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 9370ca2eebc9..e9409db8a957 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 @@ -52,7 +52,7 @@ Adicione uma bio em seu perfil para compartilhar informações sobre si mesmo co {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -Para um formulário mais longo e uma maneira mais proeminente de exibir informações personalizadas sobre você, também é possível usar um LEIAME do perfil. For more information, see "[Managing your profile README](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)." +Para um formulário mais longo e uma maneira mais proeminente de exibir informações personalizadas sobre você, também é possível usar um LEIAME do perfil. Para obter mais informações, consulte "[Gerenciar seu perfil LEIAME](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)". {% endif %} diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md index 7cfff2ab851f..65e69709dad3 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-profile/publicizing-or-hiding-your-private-contributions-on-your-profile.md @@ -1,6 +1,6 @@ --- title: Mostrar ou ocultar contribuições privadas no perfil -intro: 'Seu perfil do {% data variables.product.product_name %} mostra um gráfico de contribuições no seu repositório no último ano. You can choose to show anonymized activity from {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}private and internal{% else %}private{% endif %} repositories{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} in addition to the activity from public repositories{% endif %}.' +intro: 'Seu perfil do {% data variables.product.product_name %} mostra um gráfico de contribuições no seu repositório no último ano. Você pode optar por mostrar a atividade anônima de repositórios{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.19" %}privados e internos{% else %}privados{% endif %} {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} além da atividade de repositórios públicos{% endif %}.' redirect_from: - /articles/publicizing-or-hiding-your-private-contributions-on-your-profile versions: 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 22b05410dfa0..c3cc86365968 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 @@ -1,5 +1,5 @@ --- -title: Exibir contribuições no perfil +title: Viewing contributions on your profile intro: 'Your {% data variables.product.product_name %} profile shows off {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}your pinned repositories as well as{% endif %} a graph of your repository contributions over the past year.' redirect_from: - /articles/viewing-contributions/ @@ -11,89 +11,88 @@ versions: github-ae: '*' --- -{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Your contribution graph shows activity from public repositories. {% endif %}You can choose to show activity from {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}both public and {% endif %}private repositories, with specific details of your activity in private repositories anonymized. Para obter mais informações, consulte "[Mostrar ou ocultar contribuições privadas no perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)". +{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Your contribution graph shows activity from public repositories. {% endif %}You can choose to show activity from {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}both public and {% endif %}private repositories, with specific details of your activity in private repositories anonymized. For more information, see "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)." {% note %} -**Observação:** Os commits só aparecerão no seu gráfico de contribuições se o endereço de e-mail que você usou para criar das submissões estiver conectado à sua conta em {% data variables.product.product_name %}. Para obter mais informações, consulte "[Por que minhas contribuições não aparecem no meu perfil?](/articles/why-are-my-contributions-not-showing-up-on-my-profile#your-local-git-commit-email-isnt-connected-to-your-account)" +**Note:** Commits will only appear on your contributions graph if the email address you used to author the commits is connected to your account on {% data variables.product.product_name %}. For more information, see "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile#your-local-git-commit-email-isnt-connected-to-your-account)" {% endnote %} -### O que conta como contribuição +### What counts as a contribution -Na sua página de perfil, determinadas ações contam como contribuições: +On your profile page, certain actions count as contributions: -- 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 enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} -- Fazer coautoria de commits no branch `gh-pages` ou no branch padrão do repositório{% endif %} +- Committing to a repository's default branch or `gh-pages` branch +- Opening an issue +- Proposing a pull request +- Submitting a pull request review{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} +- Co-authoring commits in a repository's default branch or `gh-pages` branch{% endif %} {% data reusables.pull_requests.pull_request_merges_and_contributions %} -### Repositórios populares +### Popular repositories -Esta seção exibe os repositórios com a maioria dos inspetores. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Once you [pin repositories to your profile](/articles/pinning-repositories-to-your-profile), this section will change to "Pinned repositories."{% endif %} +This section displays your repositories with the most watchers. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}Once you [pin repositories to your profile](/articles/pinning-repositories-to-your-profile), this section will change to "Pinned repositories."{% endif %} -![Repositórios populares](/assets/images/help/profile/profile_popular_repositories.png) +![Popular repositories](/assets/images/help/profile/profile_popular_repositories.png) {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} -### Repositórios fixos +### Pinned repositories -Esta seção exibe até seis repositórios públicos e pode incluir tanto repositórios pertencentes a você como aqueles com os quais você contribuiu. Para ver detalhes importantes sobre os repositórios que você escolheu retratar, cada repositório nesta seção inclui um resumo do trabalho que está sendo feito, o número de [estrelas](/articles/saving-repositories-with-stars/) que ele recebeu e a principal linguagem de programação usada nele. Para obter mais informações, consulte "[Fixar repositórios no seu perfil](/articles/pinning-repositories-to-your-profile)". +This section displays up to six public repositories and can include your repositories as well as repositories you've contributed to. To easily see important details about the repositories you've chosen to feature, each repository in this section includes a summary of the work being done, the number of [stars](/articles/saving-repositories-with-stars/) the repository has received, and the main programming language used in the repository. For more information, see "[Pinning repositories to your profile](/articles/pinning-repositories-to-your-profile)." -![Repositórios fixos](/assets/images/help/profile/profile_pinned_repositories.png) +![Pinned repositories](/assets/images/help/profile/profile_pinned_repositories.png) {% endif %} -### Calendário de contribuições +### Contributions calendar -O calendário de contribuições mostra sua atividade de contribuição. +Your contributions calendar shows your contribution activity. -#### Exibir contribuições de horários específicos +#### Viewing contributions from specific times -- Clique no quadrado de um dia para mostrar as contribuições feitas durante esse período de 24 horas. -- Pressione *Shift* e clique no quadrado de outro dia para mostrar as contribuições feitas durante esse intervalo de tempo. +- Click on a day's square to show the contributions made during that 24-hour period. +- Press *Shift* and click on another day's square to show contributions made during that timespan. {% note %} -**Observação:** só é possível selecionar um intervalo de até um mês no calendário de contribuições. Mesmo que você selecione um período maior, será exibido apenas um mês de contribuições. +**Note:** You can select up to a one-month range on your contributions calendar. If you select a larger timespan, we will only display one month of contributions. {% endnote %} -![Gráfico de contribuição](/assets/images/help/profile/contributions_graph.png) +![Your contributions graph](/assets/images/help/profile/contributions_graph.png) -#### Como são calculados os horários de evento de contribuição +#### How contribution event times are calculated -Os registros de data e hora são calculados de forma diferente para commits e pull requests: -- Os **commits** usam as informações de fuso horário no registro de data e hora do commit. Para obter mais informações, consulte "[Solucionar problemas de commits na linha do tempo](/articles/troubleshooting-commits-on-your-timeline)". -- As **pull requests** e os **problemas** abertos no {% data variables.product.product_name %} usam o fuso horário do navegador. Os abertos pela API usam o registro de data e hora ou o fuso horário [especificado na chamada de API](https://developer.github.com/changes/2014-03-04-timezone-handling-changes). +Timestamps are calculated differently for commits and pull requests: +- **Commits** use the time zone information in the commit timestamp. For more information, see "[Troubleshooting commits on your timeline](/articles/troubleshooting-commits-on-your-timeline)." +- **Pull requests** and **issues** opened on {% data variables.product.product_name %} use your browser's time zone. Those opened via the API use the timestamp or time zone [specified in the API call](https://developer.github.com/changes/2014-03-04-timezone-handling-changes). -### Visão geral de atividade +### Activity overview -{% data reusables.profile.activity-overview-summary %} Para obter mais informações, consulte "[Exibir a visão geral das atividades no perfil](/articles/showing-an-overview-of-your-activity-on-your-profile)". +{% data reusables.profile.activity-overview-summary %} For more information, see "[Showing an overview of your activity on your profile](/articles/showing-an-overview-of-your-activity-on-your-profile)." -![Seção Visão geral de atividade no perfil](/assets/images/help/profile/activity-overview-section.png) +![Activity overview section on profile](/assets/images/help/profile/activity-overview-section.png) -As organizações retratadas na visão geral da atividade são priorizadas de acordo com a forma como você está ativo na organização. Se você for integrante de uma organização e @mencioná-la na bio do perfil, essa organização será priorizada na visão geral da atividade. Para obter mais informações, consulte “[Mencionar pessoas e equipes](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)” ou "[Adicionar uma bio ao seu perfil](/articles/adding-a-bio-to-your-profile/)". +The organizations featured in the activity overview are prioritized according to how active you are in the organization. If you @mention an organization in your profile bio, and you’re an organization member, then that organization is prioritized first in the activity overview. For more information, see “[Mentioning people and teams](/articles/basic-writing-and-formatting-syntax/#mentioning-people-and-teams)” or "[Adding a bio to your profile](/articles/adding-a-bio-to-your-profile/)." -### Atividade de contribuição +### Contribution activity -A seção de atividade de contribuição contém uma linha do tempo detalhada do seu trabalho, incluindo commits feitos exclusivamente por você ou em coautoria, solicitações de pull que você propôs e problemas que você abriu. Para ver suas contribuições ao longo do tempo, clique em **Mostrar mais atividade** na parte inferior da atividade de contribuição ou clique no ano em que você está interessado em visualizar, no lado direito da página. Momentos importantes, como a data em que você ingressou na organização, propôs sua primeira pull request ou abriu um problema relevante, são realçados na atividade de contribuição. Se você não conseguir ver determinados eventos na sua linha do tempo, verifique se ainda tem acesso à organização ou ao repositório em que o evento aconteceu +The contribution activity section includes a detailed timeline of your work, including commits you've made or co-authored, pull requests you've proposed, and issues you've opened. You can see your contributions over time by either clicking **Show more activity** at the bottom of your contribution activity or by clicking the year you're interested in viewing on the right side of the page. Important moments, like the date you joined an organization, proposed your first pull request, or opened a high-profile issue, are highlighted in your contribution activity. If you can't see certain events in your timeline, check to make sure you still have access to the organization or repository where the event happened. -![Filtro de hora de atividade de contribuição](/assets/images/help/profile/contributions_activity_time_filter.png) +![Contribution activity time filter](/assets/images/help/profile/contributions_activity_time_filter.png) {% if currentVersion != "github-ae@latest" %} -### Exibir contribuições da {% data variables.product.product_location_enterprise %} no {% data variables.product.prodname_dotcom_the_website %} -Se o administrador do site habilitou +### Viewing contributions from {% data variables.product.product_location_enterprise %} on {% data variables.product.prodname_dotcom_the_website %} -{% data variables.product.prodname_unified_contributions %}, você pode enviar contagens de contribuição de {% data variables.product.prodname_enterprise %} para o seu perfil de {% data variables.product.prodname_dotcom_the_website %}. Para obter mais informações, consulte "[Enviar suas contribuições do {% data variables.product.prodname_ghe_server %} para o {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile)". +If your site administrator has enabled {% data variables.product.prodname_unified_contributions %}, you can send {% data variables.product.prodname_enterprise %} contribution counts to your {% data variables.product.prodname_dotcom_the_website %} profile. For more information, see "[Sending your {% data variables.product.prodname_ghe_server %} contributions to your {% data variables.product.prodname_dotcom_the_website %}](/articles/sending-your-github-enterprise-server-contributions-to-your-github-com-profile)." {% endif %} -### Leia mais +### Further reading -- "[Visualizar contribuições na página de perfil](/articles/viewing-contributions-on-your-profile-page)" -- "[Por que minhas contribuições não aparecem no meu perfil?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)" -- "[Mostrar ou ocultar contribuições privadas no perfil](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)" -- "[Exibir a visão geral das atividades no perfil](/articles/showing-an-overview-of-your-activity-on-your-profile)" +- "[Viewing contributions on your profile page](/articles/viewing-contributions-on-your-profile-page)" +- "[Why are my contributions not showing up on my profile?](/articles/why-are-my-contributions-not-showing-up-on-my-profile)" +- "[Publicizing or hiding your private contributions on your profile](/articles/publicizing-or-hiding-your-private-contributions-on-your-profile)" +- "[Showing an overview of your activity on your profile](/articles/showing-an-overview-of-your-activity-on-your-profile)" 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 d47726d72a57..56bc439f157f 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 @@ -1,56 +1,56 @@ --- -title: Sobre seu painel pessoal +title: About your personal dashboard 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: 'Você pode visitar seu painel pessoal para acompanhar problemas e pull requests nos quais está trabalhando ou seguindo, navegar para os repositórios principais e páginas de equipe, manter-se atualizado sobre atividades recentes nas organizações e nos repositórios em que está inscrito e explorar repositórios recomendados.' +intro: 'You can visit your personal dashboard to keep track of issues and pull requests you''re working on or following, navigate to your top repositories and team pages, stay updated on recent activities in organizations and repositories you''re subscribed to, and explore recommended repositories.' versions: free-pro-team: '*' enterprise-server: '*' github-ae: '*' --- -### Acessar seu painel pessoal +### Accessing your personal dashboard -Seu quadro pessoal é a primeira página que você verá quando entrar no {% data variables.product.product_name %}. +Your personal dashboard is the first page you'll see when you sign in on {% data variables.product.product_name %}. -Para acessar seu quadro pessoal assim que se conectar, clique no {% octicon "mark-github" aria-label="The github octocat logo" %} no canto superior esquerdo de qualquer página em {% data variables.product.product_name %}. +To access your personal dashboard once you're signed in, click the {% octicon "mark-github" aria-label="The github octocat logo" %} in the upper-left corner of any page on {% data variables.product.product_name %}. -### Encontrar sua atividade recente +### Finding your recent activity -Na seção "Recent activity" (Atividade recente) do feed de notícias, você pode encontrar e acompanhar problemas e pull requests recém-atualizados nos quais você está trabalhando, além de visualizar até 12 atualizações recentes feitas nas últimas duas semanas. +In the "Recent activity" section of your news feed, you can quickly find and follow up with recently updated issues and pull requests you're working on. Under "Recent activity", you can preview up to 12 recent updates made in the last two weeks. {% data reusables.dashboard.recent-activity-qualifying-events %} -### Encontrar equipes e repositórios principais +### Finding your top repositories and teams -Na barra lateral esquerda do painel, é possível acessar os repositórios e equipes principais que usa. +In the left sidebar of your dashboard, you can access the top repositories and teams you use. -![lista de repositórios e equipes de diferentes organizações](/assets/images/help/dashboard/repositories-and-teams-from-personal-dashboard.png) +![list of repositories and teams from different organizations](/assets/images/help/dashboard/repositories-and-teams-from-personal-dashboard.png) -A lista dos principais repositórios é gerada automaticamente e pode incluir qualquer repositório com o qual você interagiu, independentemente de pertencer diretamente à sua conta. As interações incluem criação commits, abrir ou comentar em problemas e pull requests. A lista dos principais repositórios não pode ser editada, mas os repositórios serão excluídos da lista 4 meses após a última vez que você interagir com eles. +The list of top repositories is automatically generated, and can include any repository you have interacted with, whether it's owned directly by your account or not. Interactions include making commits and opening or commenting on issues and pull requests. The list of top repositories cannot be edited, but repositories will drop off the list 4 months after you last interacted with them. -Também é possível encontrar uma lista de seus repositórios, equipes e quadros de projeto recentemente visitados quando você clica na barra de pesquisa no topo de qualquer página do {% data variables.product.product_name %}. +You can also find a list of your recently visited repositories, teams, and project boards when you click into the search bar at the top of any page on {% data variables.product.product_name %}. -### Permanecer atualizado com as atividades da comunidade +### Staying updated with activity from the community -Na seção "All activity" (Todas as atividades) do feed de notícias, você pode exibir atualizações de repositórios em que está inscrito e de pessoas que você segue. Essa seção mostra atualizações dos repositórios que você inspeciona ou marca com estrela e dos usuários que você segue. +In the "All activity" section of your news feed, you can view updates from repositories you're subscribed to and people you follow. The "All activity" section shows updates from repositories you watch or have starred, and from users you follow. -Atualizações serão exibidas no feed de notícias quando um usuário que você segue: -- Marcar um repositório com estrelas. +You'll see updates in your news feed when a user you follow: +- Stars a repository. - Follows another user.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} - Creates a public repository.{% endif %} -- Abrir um problema ou uma pull request com a etiqueta "help wanted" ou "good first issue" em um repositório que você está inspecionando. +- Opens an issue or pull request with "help wanted" or "good first issue" label on a repository you're watching. - Pushes commits to a repository you watch.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} - Forks a public repository.{% endif %} -Para obter mais informações sobre como atribuir estrelas a repositórios e seguir pessoas, consulte "[Salvar repositórios com estrelas](/articles/saving-repositories-with-stars/)" e "[Seguir pessoas](/articles/following-people)". +For more information about starring repositories and following people, see "[Saving repositories with stars](/articles/saving-repositories-with-stars/)" and "[Following people](/articles/following-people)." -### Explorar repositórios recomendados +### Exploring recommended repositories -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 %} +In the "Explore repositories" section on the right side of your dashboard, you can explore recommended repositories in your communities. 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 %} -### Leia mais +### Further reading -- "[Sobre o painel da sua organização](/articles/about-your-organization-dashboard)" +- "[About your organization dashboard](/articles/about-your-organization-dashboard)" diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md index b15e839e490a..585280b29436 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/integrating-jira-with-your-personal-projects.md @@ -10,7 +10,7 @@ versions: {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.developer_settings %} -3. Na barra lateral esquerda, clique em **{% data variables.product.prodname_oauth_app %}s**. ![{% data variables.product.prodname_oauth_app %}s tab in the left sidebar](/assets/images/help/settings/developer-settings-oauth-apps.png) +3. Na barra lateral esquerda, clique em **{% data variables.product.prodname_oauth_app %}s**. ![Aba {% data variables.product.prodname_oauth_app %}s na barra lateral esquerda](/assets/images/help/settings/developer-settings-oauth-apps.png) 3. Clique em **Register a new application** (Registrar novo aplicativo). 4. Em **Application name** (Nome do aplicativo), digite "Jira". 5. Em **Homepage URL** (URL da página inicial), digite a URL completa da sua instância do JIRA. diff --git a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md index eab669c1f63d..227108831c2a 100644 --- a/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md +++ b/translations/pt-BR/content/github/setting-up-and-managing-your-github-user-account/managing-your-theme-settings.md @@ -1,21 +1,21 @@ --- -title: Managing your theme settings -intro: You can manage how {% data variables.product.product_name %} looks to you by setting a theme preference that either follows your system settings or always uses light mode or dark mode. +title: Gerenciar as configurações de temas +intro: Você pode gerenciar como {% data variables.product.product_name %} se parece com você definindo uma preferência de um tema que segue as configurações do sistema ou sempre usa o modo claro ou escuro. versions: free-pro-team: '*' --- {% note %} -**Note:** Theme settings is currently in beta and subject to change. +**Observação:** As configurações do tema estão atualmente em fase beta e sujeitas a alterações. {% endnote %} -For choice and flexibility in how and when you use {% data variables.product.product_name %}, you can configure theme settings to change how {% data variables.product.product_name %} looks to you. You can choose from two themes, light and dark, or you can configure {% data variables.product.product_name %} to follow your system settings. Some developers use dark theme for personal preference, to reduce power consumption on certain devices, or to reduce eye strain in low-light conditions. +Por escolha e flexibilidade sobre como e quando você usa {% data variables.product.product_name %}, você pode configurar configurações de tema para mudar como {% data variables.product.product_name %} fica para você. Você pode escolher dois temas, claro e escuro, ou você pode configurar {% data variables.product.product_name %} para seguir as configurações do seu sistema. Alguns desenvolvedores usam tema escuro para preferências pessoais, para reduzir o consumo de energia em certos dispositivos ou para reduzir o cansaço da vista em condições de pouco brilho. {% data reusables.user_settings.access_settings %} -1. In the user settings sidebar, click **Appearance**. !["Apperance" tab in user settings sidebar](/assets/images/help/settings/appearance-tab.png) -1. Under "Theme", select a theme preference. ![Radio buttons for theme settings](/assets/images/help/settings/theme-settings-radio-buttons.png) +1. Na barra lateral de configurações do usuário, clique em **Aparência**. ![Aba "Aparência" na barra lateral de configurações do usuário](/assets/images/help/settings/appearance-tab.png) +1. Em "Tema", selecione uma preferência de tema. ![Botões de opção para configurações de tema](/assets/images/help/settings/theme-settings-radio-buttons.png) ### Leia mais 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 e489eba672bf..fd56d5542362 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: 'A repository owned by a user account has two permission levels: the repository owner and collaborators.' +intro: 'Um repositório pertencente a uma conta de usuário tem dois níveis de permissão: o proprietário do repositório e colaboradores.' redirect_from: - /articles/permission-levels-for-a-user-account-repository versions: @@ -9,33 +9,33 @@ versions: github-ae: '*' --- -### About permissions levels for a user account repository +### Sobre os níveis de permissões para um repositório de conta de usuário -Repositories owned by user accounts have one owner. Ownership permissions can't be shared with another user account. +Repositórios pertencentes a contas de usuário têm um proprietário. As permissões de propriedade não podem ser compartilhadas com outra conta de usuário. -You can also {% if currentVersion == "free-pro-team@latest" %}invite{% else %}add{% endif %} users on {% data variables.product.product_name %} to your repository as collaborators. For more information, see "[Inviting collaborators to a personal repository](/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)." +Você também pode {% if currentVersion == "free-pro-team@latest" %}convidar{% else %}add{% endif %} usuários em {% data variables.product.product_name %} para o seu repositório como colaboradores. Para obter mais informações, consulte "[Convidar colaboradores para um repositório pessoal](/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)". {% tip %} -**Tip:** If you require more granular access to a repository owned by your user account, consider transferring the repository to an organization. Para obter mais informações, consulte "[Transferir um repositório](/github/administering-a-repository/transferring-a-repository#transferring-a-repository-owned-by-your-user-account)". +**Dica:** Se você precisar de mais acesso granular a um repositório pertencente à sua conta de usuário, considere transferir o repositório para uma organização. Para obter mais informações, consulte "[Transferir um repositório](/github/administering-a-repository/transferring-a-repository#transferring-a-repository-owned-by-your-user-account)". {% endtip %} -### Owner access for a repository owned by a user account +### Acesso de proprietário para um repositório de propriedade de uma conta de usuário -O proprietário do repositório tem controle total do repositório. In addition to the actions that any collaborator can perform, the repository owner can perform the following actions. +O proprietário do repositório tem controle total do repositório. Além das ações que qualquer colaborador pode executar, o proprietário do repositório pode executar as ações a seguir. | Ação | Mais informações | |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| {% if currentVersion == "free-pro-team@latest" %}Invite collaborators{% else %}Add collaborators{% endif %} | | +| {% if currentVersion == "free-pro-team@latest" %}Convidar colaboradores{% else %}Adicionar colaboradores{% endif %} | | | "[Convidar colaboradores para um repositório pessoal](/github/setting-up-and-managing-your-github-user-account/inviting-collaborators-to-a-personal-repository)" | | -| Change the visibility of the repository | "[Setting repository visibility](/github/administering-a-repository/setting-repository-visibility)" |{% if currentVersion == "free-pro-team@latest" %} -| Limit interactions with the repository | "[Limiting interactions in your repository](/github/building-a-strong-community/limiting-interactions-in-your-repository)" |{% endif %} +| Alterar a visibilidade do repositório | "[Configurar a visibilidade do repositório](/github/administering-a-repository/setting-repository-visibility)" {% if currentVersion == "free-pro-team@latest" %} +| Limitar interações com o repositório | "[Limitar interações no seu repositório](/github/building-a-strong-community/limiting-interactions-in-your-repository)",{% endif %} | Fazer merge de uma pull request em um branch protegido, mesmo sem revisões de aprovação | "[Sobre branches protegidos](/github/administering-a-repository/about-protected-branches)" | | Excluir o repositório | "[Excluir um repositório](/github/administering-a-repository/deleting-a-repository)" | -| Manage the repository's topics | "[Classifying your repository with topics](/github/administering-a-repository/classifying-your-repository-with-topics)" |{% if currentVersion == "free-pro-team@latest" %} -| Manage security and analysis settings for the repository | "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" |{% endif %}{% if currentVersion == "free-pro-team@latest" %} -| Enable the dependency graph for a private repository | "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)" |{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| Gerenciar tópicos do repositório | "[Classificar seu repositório com tópicos](/github/administering-a-repository/classifying-your-repository-with-topics)" {% if currentVersion == "free-pro-team@latest" %} +| Gerenciar configurações de segurança e análise para o repositório | "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" |{% endif %}{% if currentVersion == "free-pro-team@latest" %} +| Habilitar o gráfico de dependências para um repositório privado | "[Exploring the dependencies of a repository](/github/visualizing-repository-data-with-graphs/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)" |{% endif %}{% if currentVersion == "free-pro-team@latest" %} | Excluir pacotes | "[Deleting a package](/github/managing-packages-with-github-packages/deleting-a-package)" |{% endif %} | Customize the repository's social media preview | "[Customizing your repository's social media preview](/github/administering-a-repository/customizing-your-repositorys-social-media-preview)" | | Create a template from the repository | "[Creating a template repository](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)" |{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} @@ -46,7 +46,8 @@ O proprietário do repositório tem controle total do repositório. In addition | Definir os proprietários do código do repositório | "[Sobre proprietários do código](/github/creating-cloning-and-archiving-repositories/about-code-owners)" | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Criar consultorias de segurança | "[Sobre {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Exibir um botão de patrocinador | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Exibir um botão de patrocinador | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| Ação | Mais informações | -|:----------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Bifurcar o repositório | "[Sobre bifurcações](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | "[Criar e editar marcos para problemas e pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | "[Criar uma pull request de uma bifurcação](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | -| Submit a review on a pull request that affects the mergeability of the pull request | "[Revisando alterações propostas em uma pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | -| Create and edit a wiki for the repository | "[Sobre wikis](/github/building-a-strong-community/about-wikis)" | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| Ação | Mais informações | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Bifurcar o repositório | "[Sobre bifurcações](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | "[Criar e editar marcos para problemas e pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | "[Criar uma pull request de uma bifurcação](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | +| Submit a review on a pull request that affects the mergeability of the pull request | "[Revisando alterações propostas em uma pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | +| Create and edit a wiki for the repository | "[Sobre wikis](/github/building-a-strong-community/about-wikis)" | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| Remover a si mesmos como colaboradores do repositório | "[Remover a si mesmo de um repositório de colaborador](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | +| Remover a si mesmos como colaboradores do repositório | "[Remover a si mesmo de um repositório de colaborador](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | ### Leia mais 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 fca35ec045de..a1348c88cea2 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 @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} analisa seus dados {% dat product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- 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 %}. 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 345811a3b5e8..8cf0195d42b3 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 @@ -8,7 +8,7 @@ versions: **ESTES TERMOS E CONDIÇÕES (O "CONTRATO") REGEM SUA PARTICIPAÇÃO NO PROGRAMA DO GITHUB MARKETPLACE. AO SE INSCREVER PARA PARTICIPAR DO PROGRAMA DE MARKETPLACE OU AO CLICAR EM "ACEITO" ABAIXO, VOCÊ ESTÁ CONFIRMANDO QUE ENTENDE ESTE ACORDO E QUE ACEITA TODOS OS SEUS TERMOS E CONDIÇÕES. SE VOCÊ ESTÁ FIRMANDO ESTE CONTRATO EM NOME DE UMA EMPRESA OU OUTRA ENTIDADE LEGAL, VOCÊ CONFIRMA QUE POSSUI A AUTORIZAÇÃO LEGAL PARA VINCULAR A ENTIDADE A ESTE CONTRATO, NO QUAL "VOCÊ" REPRESENTARÁ A ENTIDADE QUE VOCÊ REPRESENTA.** -Data de entrada em vigor: 21 de Julho de 2020 +Effective Date: January 1, 2021 ### 1. DEFINIÇÕES @@ -143,7 +143,7 @@ No caso de sua Listagem ser involuntariamente removida por ser defeituosa, malic **6.1** O GitHub será o vendedor de registro de Produtos de Desenvolvedor comprados pelos Usuários Finais via Marketplace. -**6.2** Os preços para as Listagens do Marketplace de Aplicações para Desenvolvedores serão definidos em dólares americanos (USD). O Desenvolvedor tem controle completo sobre a definição de preços para cada Listagem e, uma vez definidos, tais preços não podem ser alterados. Você pode aposentar um plano de preços para uma Listagem existente e adicionar um novo plano de preços para tal Listagem, desde que esse novo plano de preços não impacte negativamente os Usuários Finais existentes. Os preços definidos para Produtos de Desenvolvedor determinarão o valor de pagamento que você receberá. O GitHub repassará 75% do preço de venda em dólares americanos sem redução de impostos, exceto para quaisquer impostos retidos que sejam exigidos pela lei aplicável. Os 25% restantes do preço de venda serão alocados e retidos pelo GitHub. No final de cada mês, e ao atingir um valor mínimo de 500 dólares, o GitHub efetuará sua parte dos pagamentos. +**6.2** Os preços para as Listagens do Marketplace de Aplicações para Desenvolvedores serão definidos em dólares americanos (USD). O Desenvolvedor tem controle completo sobre a definição de preços para cada Listagem e, uma vez definidos, tais preços não podem ser alterados. Você pode aposentar um plano de preços para uma Listagem existente e adicionar um novo plano de preços para tal Listagem, desde que esse novo plano de preços não impacte negativamente os Usuários Finais existentes. Os preços definidos para Produtos de Desenvolvedor determinarão o valor de pagamento que você receberá. O GitHub repassará 95% do preço de venda em dólares americanos sem redução de impostos, exceto para quaisquer impostos retidos que sejam exigidos pela lei aplicável. Os 5% restantes do preço de venda serão alocados e retidos pelo GitHub. No final de cada mês, e ao atingir um valor mínimo de 500 dólares, o GitHub efetuará sua parte dos pagamentos. **6.3** Requisitos de Reembolso. Você será responsável por especificar os termos e as condições em relação aos reembolsos aos seus Usuários Finais. Em nenhuma circunstância o GitHub será responsável por oferecer suporte para reembolsos e o GitHUb não terá responsabilidade pelo pagamento de quaisquer reembolsos. @@ -169,7 +169,7 @@ SOB NENHUMA CIRCUNSTÂNCIA E SOB NENHUMA TEORIA JURÍDICA (SEJA POR CONTRATO, RE **10.3** O GitHub pode rescindir este Contrato a qualquer momento se (a) você tiver violado qualquer disposição deste Contrato ou (b) o GitHub for obrigado a fazê-lo por lei. -**10.4** Efeitos da Rescisão pelo Desenvolvedor. Após receber quarenta e cinco (45) dias de aviso prévio por escrito de rescisão do Desenvolvedor, o Desenvolvedor será impedido de assumir novos clientes via Marketplace. Quaisquer taxas pendentes serão remetidas após a rescisão e remoção do Produto de Desenvolvedor do Marketplace. Se a rescisão for iniciada como resultado de uma alteração do GitHub para estes termos (Seção 11), os termos em vigor imediatamente antes de tal modificação regem o período de aviso prévio de 45 dias até a data da rescisão real. +**10.4** Efeitos da Rescisão pelo Desenvolvedor. Após receber quarenta e cinco (45) dias de aviso prévio por escrito de rescisão do Desenvolvedor, o Desenvolvedor será impedido de assumir novos clientes via Marketplace. Quaisquer taxas pendentes serão remetidas após a rescisão e remoção do Produto de Desenvolvedor do Marketplace. If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** As obrigações das Seções 2, 3, 4, 5, 8, 9 e 12-18 sobreviverão a qualquer expiração ou rescisão deste Contrato. 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 30cc600abf07..d77a4c5b285d 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 vigência: 16 de novembro de 2020 +Effective date: December 19, 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. @@ -26,24 +26,24 @@ Esta é uma versão resumida das nossas diretrizes. Para obter as informações ### Sumário -| Seção | Conteúdo | -| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| [Que tipo de informação o GitHub coleta](#what-information-github-collects) | O GitHub coleta informações diretamente de você para fins de registro, pagamento, transações e perfil de usuário. Também coletamos automaticamente suas informações de uso, cookies e tecnologias similares, bem como informações do dispositivo, sujeitas ao seu consentimento, quando necessário. O GitHub também pode coletar Informações Pessoais de Usuário de terceiros. Coletamos somente a quantidade mínima de informações pessoais necessárias de você, a menos que você decida compartilhar mais informações. | -| [Que tipo de informação o GitHub _não_ coleta](#what-information-github-does-not-collect) | Não coletamos informações de crianças com menos de 13 anos nem coletamos [Informações Pessoais Confidenciais](https://gdpr-info.eu/art-9-gdpr/). | -| [Como o GitHub usa suas informações](#how-github-uses-your-information) | Nesta seção, descrevemos as formas como usamos suas informações, inclusive para fornecer o Serviço, para nos comunicarmos com você, para fins de segurança e conformidade, e para melhorar nosso Serviço. A seção também descreve a base jurídica na qual processamos suas informações quando tal processamento for exigido por lei. | -| [Como compartilhamos as informações obtidas](#how-we-share-the-information-we-collect) | Podemos compartilhar suas informações com terceiros diante de uma das seguintes circunstâncias: com seu consentimento, com nossos prestadores de serviços para fins de segurança, para cumprir as nossas obrigações legais, ou quando houver mudança de controle ou venda de entidades corporativas ou unidades de negócios. Não vendemos suas informações pessoais e não hospedamos anúncios no GitHub. Consulte uma lista de prestadores de serviços que acessam suas informações. | -| [Outras informações importantes](#other-important-information) | Oferecemos informações adicionais específicas relacionadas a conteúdo de repositórios, informações públicas e Organizações no GitHub. | -| [Serviços adicionais](#additional-services) | Oferecemos informações sobre ofertas de serviço adicionais, inclusive aplicativos de terceiros, GitHub Pages e aplicativos do GitHub. | -| [Como você pode acessar e controlar as informações obtidas](#how-you-can-access-and-control-the-information-we-collect) | Propomos algumas medidas para você acessar, alterar ou excluir suas informações pessoais. | -| [Uso de cookies e rastreamento](#our-use-of-cookies-and-tracking) | Usamos cookies para fins de funcionalidade geral do site, e usamos alguns poucos serviços de rastreamento e análise em determinadas partes do site. Temos uma página que torna o processo bastante transparente. Veja mais detalhes nesta seção. | -| [Como o GitHub protege suas informações](#how-github-secures-your-information) | Tomamos todas as medidas razoavelmente necessárias para proteger a confidencialidade, a integridade e a disponibilidade das suas informações pessoais no GitHub e para proteger a resiliência dos nossos servidores. | -| [Práticas globais de privacidade do GitHub](#githubs-global-privacy-practices) | Fornecemos os mesmos altos padrões de proteção de privacidade a todos os nossos usuários em todo o mundo. | -| [Nossa comunicação com você](#how-we-communicate-with-you) | Nossa comunicação com você ocorrerá por e-mail. É possível controlar os nossos meios de contato com você nas configurações da sua conta. | -| [Resolução de conflitos](#resolving-complaints) | Na hipótese improvável de sermos incapazes de resolver um problema de privacidade de dados de forma rápida e detalhada, indicaremos um caminho para a resolução de litígios. | -| [Mudanças nesta Declaração de Privacidade](#changes-to-our-privacy-statement) | Você receberá notificações sobre mudanças concretas nesta Declaração de Privacidade 30 dias antes de tais mudanças entrarem em vigor. Também é possível acompanhar as mudanças no nosso repositório da Política do Site. | -| [Licença](#license) | Esta Declaração de Privacidade é licenciada sob a [licença Creative Commons Zero](https://creativecommons.org/publicdomain/zero/1.0/). | -| [Contato com a GitHub](#contacting-github) | Entre em contato em caso de dúvidas sobre a nossa Declaração de Privacidade. | -| [Traduções](#translations) | Acesse os links para consultar algumas traduções da Declaração de Privacidade. | +| Seção | Conteúdo | +| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| [Que tipo de informação o GitHub coleta](#what-information-github-collects) | O GitHub coleta informações diretamente de você para fins de registro, pagamento, transações e perfil de usuário. We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. O GitHub também pode coletar Informações Pessoais de Usuário de terceiros. Coletamos somente a quantidade mínima de informações pessoais necessárias de você, a menos que você decida compartilhar mais informações. | +| [Que tipo de informação o GitHub _não_ coleta](#what-information-github-does-not-collect) | Não coletamos informações de crianças com menos de 13 anos nem coletamos [Informações Pessoais Confidenciais](https://gdpr-info.eu/art-9-gdpr/). | +| [Como o GitHub usa suas informações](#how-github-uses-your-information) | Nesta seção, descrevemos as formas como usamos suas informações, inclusive para fornecer o Serviço, para nos comunicarmos com você, para fins de segurança e conformidade, e para melhorar nosso Serviço. A seção também descreve a base jurídica na qual processamos suas informações quando tal processamento for exigido por lei. | +| [Como compartilhamos as informações obtidas](#how-we-share-the-information-we-collect) | Podemos compartilhar suas informações com terceiros diante de uma das seguintes circunstâncias: com seu consentimento, com nossos prestadores de serviços para fins de segurança, para cumprir as nossas obrigações legais, ou quando houver mudança de controle ou venda de entidades corporativas ou unidades de negócios. Não vendemos suas informações pessoais e não hospedamos anúncios no GitHub. Consulte uma lista de prestadores de serviços que acessam suas informações. | +| [Outras informações importantes](#other-important-information) | Oferecemos informações adicionais específicas relacionadas a conteúdo de repositórios, informações públicas e Organizações no GitHub. | +| [Serviços adicionais](#additional-services) | Oferecemos informações sobre ofertas de serviço adicionais, inclusive aplicativos de terceiros, GitHub Pages e aplicativos do GitHub. | +| [Como você pode acessar e controlar as informações obtidas](#how-you-can-access-and-control-the-information-we-collect) | Propomos algumas medidas para você acessar, alterar ou excluir suas informações pessoais. | +| [Uso de cookies e rastreamento](#our-use-of-cookies-and-tracking) | We only use strictly necessary cookies to provide, secure and improve our service. Temos uma página que torna o processo bastante transparente. Veja mais detalhes nesta seção. | +| [Como o GitHub protege suas informações](#how-github-secures-your-information) | Tomamos todas as medidas razoavelmente necessárias para proteger a confidencialidade, a integridade e a disponibilidade das suas informações pessoais no GitHub e para proteger a resiliência dos nossos servidores. | +| [Práticas globais de privacidade do GitHub](#githubs-global-privacy-practices) | Fornecemos os mesmos altos padrões de proteção de privacidade a todos os nossos usuários em todo o mundo. | +| [Nossa comunicação com você](#how-we-communicate-with-you) | Nossa comunicação com você ocorrerá por e-mail. É possível controlar os nossos meios de contato com você nas configurações da sua conta. | +| [Resolução de conflitos](#resolving-complaints) | Na hipótese improvável de sermos incapazes de resolver um problema de privacidade de dados de forma rápida e detalhada, indicaremos um caminho para a resolução de litígios. | +| [Mudanças nesta Declaração de Privacidade](#changes-to-our-privacy-statement) | Você receberá notificações sobre mudanças concretas nesta Declaração de Privacidade 30 dias antes de tais mudanças entrarem em vigor. Também é possível acompanhar as mudanças no nosso repositório da Política do Site. | +| [Licença](#license) | Esta Declaração de Privacidade é licenciada sob a [licença Creative Commons Zero](https://creativecommons.org/publicdomain/zero/1.0/). | +| [Contato com a GitHub](#contacting-github) | Entre em contato em caso de dúvidas sobre a nossa Declaração de Privacidade. | +| [Traduções](#translations) | Acesse os links para consultar algumas traduções da Declaração de Privacidade. | ## Declaração de Privacidade do GitHub @@ -74,8 +74,8 @@ Se você tiver uma Conta paga conosco, se vender um aplicativo no [GitHub Market ##### Informações de uso Se você acessar nosso Serviço ou Site, coletaremos automaticamente as mesmas informações básicas coletadas pela maioria dos serviços, sujeitando-nos ao seu consentimento, quando necessário. A coleta inclui informações sobre o seu uso do Serviço, como as páginas que você visualiza, o site referenciado, seu endereço IP, informações da sessão, e a data e hora de cada solicitação. Essas informações são obtidas igualmente de todos os visitantes do Site, independentemente de terem Conta ou não. Esses dados podem incluir Informações Pessoais de Usuário. -##### Cookies e informações de tecnologias semelhantes -Conforme descrito em mais detalhes a seguir e sujeitos ao seu seu consentimento, quando necessário, coletaremos informações automaticamente de cookies e tecnologias afins (como ID de cookie e configurações) para manter a sua conexão, lembrar suas preferências e identificar você e seu dispositivo. +##### Cookies +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### Informações do dispositivo Podemos coletar determinadas informações sobre o seu dispositivo, como endereço IP, dados de navegador ou aplicativo cliente, preferências de idioma, sistema operacional, versão de aplicativo, tipo e ID de dispositivo, e modelo e fabricante de dispositivo. Esses dados podem incluir Informações Pessoais de Usuário. @@ -235,15 +235,17 @@ Com isso, o endereço de e-mail que você informou [nas suas configurações de #### Cookies -O GitHub usa cookies e tecnologias similares (por exemplo, HTML5 localStorage) para tornar as interações com o 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 semelhantes (doravante denominadas, coletivamente, "cookies") para prestar nossos serviços como, por exemplo, manter você conectado, 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. +GitHub only uses strictly necessary cookies. Cookies são pequenos arquivos de texto que os sites costumam armazenar nos discos rígidos de computadores ou dispositivos móveis de visitantes. -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. +We use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### Rastreamento e análise +By using our service, 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 our service. -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. +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. -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). +#### DNT + +"[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 a sua 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 habilitar essa sinalização. Há também bons aplicativos que bloqueiam o rastreamento online, como [Badger de Privacidade](https://privacybadger.org/). ### Como o GitHub protege suas informações 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 7b1e842e7da2..8738ffd486b9 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,9 +10,9 @@ versions: free-pro-team: '*' --- -Data de vigência: **2 de outubro de 2020** +Entrada em vigor: **30 de dezembro de 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). +O GitHub fornece um grande acordo de transparência em relação à forma como usamos seus dados, como os coletamos e com quem compartilhamos. To that end, we provide this page, which details [our subprocessors](#github-subprocessors), and how we use [cookies](#cookies-on-github). ### Subprocessadores GitHub @@ -29,14 +29,13 @@ Quando compartilhamos suas informações com terceiros subprocessadores, tais co | 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 | Estados Unidos | Estados Unidos | -| LinkedIn Navigator | Serviço de enriquecimento de dados de marketing | Estados Unidos | Estados Unidos | +| LinkedIn Navigator | Data enrichment service | 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 | | Mailgun | Provedor de serviços de correio transacional | Estados Unidos | Estados Unidos | | Microsoft | Microsoft Services | Estados Unidos | Estados Unidos | | Monday.com | Colaboração da equipe e plataforma de gerenciamento de projetos | Estados Unidos | Israel | | Nexmo | Provedor de notificação de SMS | Estados Unidos | Estados Unidos | -| Oracle | Sistema financeiro corporativo | Estados Unidos | Estados Unidos | | Salesforce.com | Gerenciamento de relacionamento com clientes | Estados Unidos | Estados Unidos | | Sendgrid | Provedor de serviços de correio transacional | Estados Unidos | Estados Unidos | | Sentry.io | Provedor de monitoramento de aplicativo | Estados Unidos | Estados Unidos | @@ -49,16 +48,15 @@ Quando trouxermos um novo subprocessador que lida com as Informações Pessoais ### Cookies no GitHub -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. +GitHub uses 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. 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á conectado. | um ano | +| GitHub | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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 | @@ -66,32 +64,19 @@ Como o número e os nomes dos cookies podem mudar, a tabela abaixo pode ser atua | 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á conectado. | um ano | +| 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 | `_octo` | This cookie is used for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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 | `tz` | This cookie allows us to customize timestamps to your time zone. | 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 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 a sua 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 habilitar essa sinalização. Há também bons aplicativos que bloqueiam o rastreamento on-line, 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. +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, certain pages on our website may set other third party cookies. 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. 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 564b63e926ab..f6143c9435d8 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 @@ -162,8 +162,6 @@ c/o Corporation Service Company 2710 Gateway Oaks Drive, Suite 150N Sacramento, CA 95833-3505 ``` -Você também pode enviar uma cópia de cortesia para legal@support.github.com. - Por favor, faça suas solicitações da forma mais específica e breve quanto for possível, incluindo as seguintes informações: - Informações completas sobre a autoridade emissora do pedido de informações diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md index e8c74a55e7c3..f504f76676e2 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/about-github-sponsors.md @@ -27,7 +27,7 @@ Quando você se tornar um desenvolvedor patrocinado ou uma organização patroci {% endnote %} -O {% data variables.product.prodname_matching_fund %} visa beneficiar os membros da comunidade {% data variables.product.prodname_dotcom %} que desenvolvem softwares de código aberto que promovem as [{% data variables.product.prodname_dotcom %}Diretrizes da Comunidade](/github/site-policy/github-community-guidelines). Payments to sponsored organizations and payments from organizations are not eligible for {% data variables.product.prodname_matching_fund %}. +O {% data variables.product.prodname_matching_fund %} visa beneficiar os membros da comunidade {% data variables.product.prodname_dotcom %} que desenvolvem softwares de código aberto que promovem as [{% data variables.product.prodname_dotcom %}Diretrizes da Comunidade](/github/site-policy/github-community-guidelines). Pagamentos a organizações patrocinadas e pagamentos de organizações não são elegíveis para {% data variables.product.prodname_matching_fund %}. Para ser elegível para o {% data variables.product.prodname_matching_fund %}, você deve criar um perfil que atrairá uma comunidade que irá sustentar você a longo prazo. Para obter mais informações sobre criar um perfil forte, consulte "[Editando os detalhes de seu perfil para {% data variables.product.prodname_sponsors %}](/github/supporting-the-open-source-community-with-github-sponsors/editing-your-profile-details-for-github-sponsors)". diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md index 57b1b5a4d6cf..a37a687cc7d3 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/attributing-sponsorships-to-your-organization.md @@ -1,13 +1,13 @@ --- -title: Attributing sponsorships to your organization -intro: 'You can attribute the sponsorships paid by one of your organizations to another organization.' +title: Atribuir patrocínios à sua organização +intro: 'Você pode atribuir os patrocínios pagos por uma das suas organizações a outra organização.' versions: free-pro-team: '*' -permissions: People who are organization owners of both organizations can attribute one organization's sponsorships to another organization. +permissions: As pessoas que são proprietárias de organizações de ambas as organizações podem atribuir patrocínios de uma organização à outra organização. --- -1. Navigate to the organization whose sponsorships you want to attribute to another organization. -1. Under your organization name, click {% octicon "heart" aria-label="The heart icon" %} **Sponsoring**. !["Sponsoring" tab](/assets/images/help/sponsors/sponsoring-tab.png) -1. In the upper-right corner, click {% octicon "gear" aria-label="The gear icon" %} **Settings**. !["Settings" button](/assets/images/help/sponsors/sponsoring-settings-button.png) -1. Under "Link sponsorships to another account", use the drop-down menu, then click the organization you want this organization's sponsorships to be attributed to. ![Drop-down menu to select account](/assets/images/help/sponsors/select-an-account-drop-down.png) -1. Click **Link account**. !["Link account" button](/assets/images/help/sponsors/link-account-button.png) \ No newline at end of file +1. Acesse a organização cujos patrocínios você deseja atribuir a outra organização. +1. No nome da sua organização, clique em {% octicon "heart" aria-label="The heart icon" %} **Patrocínio**. ![Aba "Patrocínio"](/assets/images/help/sponsors/sponsoring-tab.png) +1. No canto superior direito, clique em {% octicon "gear" aria-label="The gear icon" %} **Configurações**. ![Botão "Configurações"](/assets/images/help/sponsors/sponsoring-settings-button.png) +1. Em "Vincular patrocínios a outra conta", use o menu suspenso e, em seguida, clique na organização à qual você deseja que os patrocínios desta organização sejam atribuídos. ![Menu suspenso para selecionar conta](/assets/images/help/sponsors/select-an-account-drop-down.png) +1. Clique em **Vincular conta**. ![Botão "Vincular conta"](/assets/images/help/sponsors/link-account-button.png) \ No newline at end of file diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md index 76e12fb4fe61..53ed7d83be3f 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/configuring-webhooks-for-events-in-your-sponsored-account.md @@ -5,11 +5,11 @@ versions: free-pro-team: '*' --- -### About webhooks for events in your sponsored account +### Sobre webhooks para eventos da sua conta patrocinada -Para monitorar as alterações de seus patrocínios, como os cancelamentos no final de um período de pagamento, você pode criar webhooks para sua conta de usuário ou organização patrocinada. When you set up a webhook for your sponsored account, you'll receive updates when sponsorships are created, edited, or deleted. Para obter mais informações, consulte o [`evento de patrocínio` de webhook](/webhooks/event-payloads/#sponsorship). +Para monitorar as alterações de seus patrocínios, como os cancelamentos no final de um período de pagamento, você pode criar webhooks para sua conta de usuário ou organização patrocinada. Ao configurar um webhook para sua conta patrocinada, você receberá atualizações quando patrocinadores forem criados, editados ou excluídos. Para obter mais informações, consulte o [`evento de patrocínio` de webhook](/webhooks/event-payloads/#sponsorship). -### Managing webhooks for events in your sponsored account +### Gerenciando webhooks para eventos na sua conta patrocinada {% data reusables.sponsors.navigate-to-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-webhooks-tab %} diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md index a2f37ed2bf04..92c1fb6276d0 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/contacting-your-sponsors.md @@ -7,11 +7,11 @@ versions: free-pro-team: '*' --- -### About sponsorship updates +### Sobre atualizações de patrocínio Seus patrocinadores podem escolher se querem receber atualizações sobre seu trabalho por e-mail. Para obter mais informações, consulte "[Gerenciar o patrocínio](/articles/managing-your-sponsorship)". -For sponsored developer accounts, the update will come from your user account's primary email address. Se você habilitou a privacidade do endereço de e-mail, em sua conta de usuário, a atualização virá de `noreply@github.com`. For sponsored organizations, the update will come from the organization's `noreply@github.com` email address. Para obter mais informações, consulte "[Setting your commit email address](/articles/setting-your-commit-email-address)." +Para contas de desenvolvedor patrocinado, a atualização virá do endereço de e-mail principal da sua conta de usuário. Se você habilitou a privacidade do endereço de e-mail, em sua conta de usuário, a atualização virá de `noreply@github.com`. Para organizações patrocinadas, a atualização virá do endereço de e-mail `noreply@github.com` da organização. Para obter mais informações, consulte "[Setting your commit email address](/articles/setting-your-commit-email-address)." ### Entrar em contato com os patrocinadores 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 e85a0cd300f4..7ba5908a689f 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 @@ -10,12 +10,12 @@ versions: ### Sobre os perfis dos patrocinadores -Seu perfil do {% data variables.product.prodname_sponsors %} diz aos patrocinadores potenciais por que eles devem apoiá-lo. People see your sponsor profile when they click the **Sponsor** button on your profile. Recomendamos incluir as seguintes informações. +Seu perfil do {% data variables.product.prodname_sponsors %} diz aos patrocinadores potenciais por que eles devem apoiá-lo. As pessoas veem seu perfil de patrocinador quando clicam no botão **Patrocinador** no seu perfil. Recomendamos incluir as seguintes informações. - Trabalho de código aberto para o qual você contribui - Por que você está comprometido com o desenvolvimento de código aberto -### Editing your profile details +### Editar as informações do seu perfil {% data reusables.sponsors.navigate-to-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-profile-tab %} diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md index 169aec7b6020..ddf67ec67731 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-payouts-from-github-sponsors.md @@ -13,7 +13,7 @@ Só é possível gerenciar seus pagamentos {% data variables.product.prodname_sp {% data reusables.sponsors.payout-info %} -### Viewing and editing payout information +### Visualizar e editar informações de pagamento {% data reusables.sponsors.navigate-to-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-payouts-tab %} diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md index 80757c3bfcc2..ac061d77345a 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship-goal.md @@ -1,17 +1,17 @@ --- title: Gerenciando sua meta de patrocínio -intro: You can set a goal for your sponsored developer or sponsored organization account to help the community understand the impact of sponsoring you. +intro: Você pode definir uma meta para o seu desenvolvedor patrocinado ou conta da organização patrocinada para ajudar a comunidade a entender o impacto de patrocinar você. versions: free-pro-team: '*' --- ### Sobre metas de patrocínio -You can set a funding goal for your sponsored account and share the goal with your community. Metas ajudam você a entender o impacto que você tem na comunidade de código aberto e construir sua presença no programa {% data variables.product.prodname_sponsors %}. +Você pode definir uma meta de financiamento para a sua conta patrocinada e compartilhar o objetivo com sua comunidade. Metas ajudam você a entender o impacto que você tem na comunidade de código aberto e construir sua presença no programa {% data variables.product.prodname_sponsors %}. Sua meta pode definir um objetivo para o número de patrocinadores que você deseja ter ou a quantidade de dinheiro que você quer ganhar a cada mês. Você só pode definir em uma meta de cada vez. Depois de atingir uma meta, você pode definir outra meta. -### Setting a goal +### Definir uma meta {% data reusables.sponsors.navigate-to-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-your-goals-tab %} diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md index dc253cf0d9f3..70d474d0f353 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/managing-your-sponsorship.md @@ -1,6 +1,6 @@ --- title: Gerenciar o patrocínio -intro: You can manage who can see your sponsorship and whether you receive email updates from the sponsored account. +intro: Você pode gerenciar quem pode ver seu patrocínio e se você recebe atualizações de e-mail de uma conta patrocinada. redirect_from: - /articles/managing-your-sponsorship versions: @@ -17,9 +17,9 @@ versions: {% data reusables.sponsors.who-can-see-your-sponsorship %} {% data reusables.sponsors.update-sponsorship %} -### Managing email updates for your sponsorship +### Gerenciar atualizações de e-mail para seu patrocínio -You can choose whether an account you sponsor can send you email updates about their work. The sponsored account will not have access to your email address. +Você pode escolher se uma conta que você patrocina pode enviar para você atualizações de e-mail sobre o trabalho deles. A conta patrocinada não terá acesso ao seu endereço de e-mail. {% data reusables.sponsors.manage-updates-for-orgs %} @@ -31,5 +31,5 @@ You can choose whether an account you sponsor can send you email updates about t ### Leia mais -- "[Upgrading a sponsorship](/articles/upgrading-a-sponsorship)" -- "[Downgrading a sponsorship](/articles/downgrading-a-sponsorship)" \ No newline at end of file +- "[Atualizar um patrocínio](/articles/upgrading-a-sponsorship)" +- "[Fazer o downgrade de um patrocínio](/articles/downgrading-a-sponsorship)" \ No newline at end of file diff --git a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md index ee78f5bc1d35..200240de30da 100644 --- a/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md +++ b/translations/pt-BR/content/github/supporting-the-open-source-community-with-github-sponsors/viewing-your-sponsors-and-sponsorships.md @@ -7,7 +7,7 @@ versions: free-pro-team: '*' --- -### About sponsors and sponsorships +### Sobre patrocinadores e patrocínios Você pode ver a análise sobre seus patrocínios atuais e anteriores, os pagamentos que recebeu de patrocinadores e eventos, como cancelamentos e mudanças na camada dos patrocinadores para seus patrocínios. Você também pode visualizar as atividades, tais como novos patrocinadores, alterações e cancelamentos nos patrocínios. Você pode filtrar a lista de atividades por data. Você também pode exportar dados de patrocínio para a conta que você está visualizando em formato CSV ou JSON. @@ -23,7 +23,7 @@ Você pode ver a análise sobre seus patrocínios atuais e anteriores, os pagame ### Exportando seus dados de patrocínio -If you have sponsors, you can export your sponsorship data. {% data variables.product.prodname_dotcom %} will send you an email with export data for all of your sponsors for the month you select. After the export is complete, you can export another month of data. You can export up to 10 sets of data per hour for any of your sponsored accounts. +Se você tiver patrocinadores, você poderá exportar os seus dados de patrocínio. {% data variables.product.prodname_dotcom %} enviará um e-mail com os dados de exportação de todos os seus patrocinadores para o mês que você selecionar. Depois que a exportação estiver concluída, você poderá exportar mais um mês de dados. Você pode exportar até 10 conjuntos de dados por hora para qualquer uma das suas contas patrocinadas. {% data reusables.sponsors.navigate-to-sponsors-dashboard %} {% data reusables.sponsors.navigate-to-sponsors-tab %} 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 aa6d8e0a5fe9..060f2c6e1e3a 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 @@ -39,12 +39,6 @@ Se foram detectadas vulnerabilidades no repositório, estas são exibidas na par 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 {% data variables.product.prodname_dependabot_alerts %}. -{% note %} - -**Observação:** {% data variables.product.prodname_ghe_server %} não preenche a vista de **Dependentes**. - -{% endnote %} - ![Gráfico de dependências](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ Todas as dependências diretas e indiretas especificadas no manifesto do reposit {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %} 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 são exibidas na parte superior da visualização para usuários com acesso a alertas de segurança. -{% note %} - -**Observação:** {% data variables.product.prodname_ghe_server %} não preenche a vista de **Dependentes**. - -{% endnote %} - ![Gráfico de dependências](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,6 +81,24 @@ Você também pode habilitar ou desabilitar o gráfico de dependências para tod 4. Leia a mensagem sobre a concessão de acesso somente leitura pelo {% data variables.product.product_name %} aos dados do repositório para habilitar o gráfico de dependências e, em seguida, ao lado de "Gráfico de Dependência", clique em **Habilitar**. ![Botão "Habilitar" para o gráfico de dependência](/assets/images/help/repository/dependency-graph-enable-button.png) Você pode desabilitar o gráfico de dependências a qualquer momento clicando em **Desabilitar** ao lado de "Gráfico de dependência" na aba de análise & de Segurança &. + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} ### Solução de problemas para o gráfico de dependências 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 1733bbe5d690..d0415191bee6 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,8 +40,9 @@ 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`. The `CNAME` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% 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 @@ -72,6 +73,8 @@ Para configurar um domínio apex, como `example.com`, você deve configurar um a 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% 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 domínio apex. Confirme que os resultados correspondem aos endereços IP do {% data variables.product.prodname_pages %} acima. ```shell diff --git a/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index f0096f9390e8..bbccb941ee94 100644 --- a/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/pt-BR/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -39,11 +39,7 @@ Verifique se o seu site não: - Usa mais de um subdomínio `www`. Por exemplo, `www.example.com` e `www.anotherexample.com`. - Usa um domínio apex e um subdomínio personalizado. Por exemplo, `example.com` e `docs.example.com`. -{% warning %} - -**Aviso:** é altamente recomendável não usar registros DNS curingas, como `*.example.com`. O registro DNS curinga permite que qualquer pessoa hospede um site do {% data variables.product.prodname_pages %} em um dos subdomínios que você tem. - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} Para obter uma lista de domínios personalizados compatíveis, consulte "[Sobre domínios personalizados e o {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages/#supported-custom-domains)". diff --git a/translations/pt-BR/content/graphql/overview/resource-limitations.md b/translations/pt-BR/content/graphql/overview/resource-limitations.md index 8e0614d77266..3c9af52fe1ea 100644 --- a/translations/pt-BR/content/graphql/overview/resource-limitations.md +++ b/translations/pt-BR/content/graphql/overview/resource-limitations.md @@ -117,7 +117,7 @@ Estes dois exemplos mostram como calcular os nós totais em uma chamada. = 22,060 total nodes -### Limite de taxa +## Limite de taxa O [limite de taxas](/rest/overview/resources-in-the-rest-api#rate-limiting) do GraphQL API v4 é diferente dos limites de taxa do REST API v3. @@ -130,12 +130,6 @@ Para representar com precisão o custo de servidor de uma consulta, a API v4 do O limite de taxa de câmbio da API v4 do GraphQL é **5.000 pontos por hora**. -{% if currentVersion == "free-pro-team@latest" %} - -Para {% data variables.product.prodname_github_apps %} ou {% data variables.product.prodname_oauth_app %} que pertencem a uma conta do {% data variables.product.prodname_ghe_cloud %}, pedidos de recursos pertencentes à mesma conta {% data variables.product.prodname_ghe_cloud %} tem um limite ampliado de 15.000 pontos por hora. - -{% endif %} - Observe que 5.000 pontos por hora não é o mesmo que 5.000 chamadas por hora: a API v4 do GraphQL e a API v3 de REST usam diferentes limites de taxa. {% note %} diff --git a/translations/pt-BR/content/graphql/reference/enums.md b/translations/pt-BR/content/graphql/reference/enums.md index 0019aefc701e..bafce385715d 100644 --- a/translations/pt-BR/content/graphql/reference/enums.md +++ b/translations/pt-BR/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: Enumeradores redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/input-objects.md b/translations/pt-BR/content/graphql/reference/input-objects.md index 4845c3de1b29..656f27c4eb1b 100644 --- a/translations/pt-BR/content/graphql/reference/input-objects.md +++ b/translations/pt-BR/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: Objetos de entrada redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/interfaces.md b/translations/pt-BR/content/graphql/reference/interfaces.md index 339990ae3c7e..a821d1b8a197 100644 --- a/translations/pt-BR/content/graphql/reference/interfaces.md +++ b/translations/pt-BR/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: Interfaces redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/mutations.md b/translations/pt-BR/content/graphql/reference/mutations.md index 8365f3caca22..2d467a63642f 100644 --- a/translations/pt-BR/content/graphql/reference/mutations.md +++ b/translations/pt-BR/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: Mutações redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/objects.md b/translations/pt-BR/content/graphql/reference/objects.md index f228814c6d36..4e9a62a90c67 100644 --- a/translations/pt-BR/content/graphql/reference/objects.md +++ b/translations/pt-BR/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: Objetos redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/queries.md b/translations/pt-BR/content/graphql/reference/queries.md index 20d32d9d2b26..f605ff9ede0e 100644 --- a/translations/pt-BR/content/graphql/reference/queries.md +++ b/translations/pt-BR/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: Consultas miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/scalars.md b/translations/pt-BR/content/graphql/reference/scalars.md index 0f23bbe7b489..40b4cdd3c0b4 100644 --- a/translations/pt-BR/content/graphql/reference/scalars.md +++ b/translations/pt-BR/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: Escalares redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/graphql/reference/unions.md b/translations/pt-BR/content/graphql/reference/unions.md index 9807979baa9a..2aacf2970f7e 100644 --- a/translations/pt-BR/content/graphql/reference/unions.md +++ b/translations/pt-BR/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: Uniões redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index 13a566a4e135..095142dfda68 100644 --- a/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/pt-BR/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ Você pode escolher quais contribuidores estão incluídos nas métricas e criar ### Leia mais - "[Métricas disponíveis com {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)" -- "[{% data variables.product.prodname_insights %} e proteção de dados para sua organização](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} e proteção de dados para sua organização" \ No newline at end of file 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 79356c20ec24..41d9c8a1bc40 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 @@ -99,4 +99,4 @@ Para configurar o {% data variables.product.prodname_insights %} para conectar-s ### Leia mais - "[Gerenciar repositórios](/insights/installing-and-configuring-github-insights/managing-repositories)" -- "[{% data variables.product.prodname_insights %} e proteção de dados para sua organização](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} e proteção de dados para sua organização" diff --git a/translations/pt-BR/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/pt-BR/content/packages/guides/configuring-npm-for-use-with-github-packages.md index a3283e899f06..4cff9b09243c 100644 --- a/translations/pt-BR/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/pt-BR/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: **Note:** 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" or currentVersion ver_gt "enterprise-server@2.22" %} +### Limits for published npm versions + +If you publish over 1,000 npm package versions to {% data variables.product.prodname_registry %}, you may see performance issues and timeouts occur during usage. + +To reduce the number of versions you have published for your npm package, consider deleting package versions. Para obter mais informações, consulte "[Excluir um pacote](/packages/manage-packages/deleting-a-package)". + +In the future, {% data variables.product.company_short %} will enforce a hard limit on publishing more than 1,000 versions of an npm package. When we start enforcing the 1,000 versions limit for each npm package hosted on {% data variables.product.prodname_registry %}, we will offer more guidance on how to manage your package versions. + +{% endif %} + ### Autenticar-se no {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/pt-BR/content/packages/guides/deleting-a-container-image.md b/translations/pt-BR/content/packages/guides/deleting-a-container-image.md index 5157d0388ecf..8a1584970bc1 100644 --- a/translations/pt-BR/content/packages/guides/deleting-a-container-image.md +++ b/translations/pt-BR/content/packages/guides/deleting-a-container-image.md @@ -1,6 +1,6 @@ --- title: Excluir uma imagem de contêiner -intro: 'É possível excluir uma versão de uma imagem privada de contêiner usando o GraphQL ou em {% data variables.product.prodname_dotcom %}.' +intro: 'You can delete a specific version or all versions of a private or public container image on {% data variables.product.prodname_dotcom %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ Ao excluir pacotes públicos, esteja ciente de que você pode quebrar projetos q ### Excluir uma versão de uma imagem de contêiner de usuário em {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "[Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-a-user-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-user-level %} 5. À esquerda, clique em **Gerenciar versões**. -5. À direita da versão que você deseja excluir, clique em **Excluir**. ![Botão de excluir pacote](/assets/images/help/package-registry/delete-package-button.png) -6. Para confirmar a exclusão, digite o nome do pacote e clique em **Eu entendo as consequências. Exclua esta versão**. ![Botão de confirmar exclusão de pacote](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. Para confirmar a exclusão, digite o nome do pacote e clique em **Eu entendo as consequências. Exclua esta versão**. ![Botão de confirmar exclusão de pacote](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### Excluir uma versão de uma imagem de contêiner de uma organização no {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "[Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-an-organization-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-org-level %} 5. À esquerda, clique em **Gerenciar versões**. -5. À direita da versão que você deseja excluir, clique em **Excluir**. ![Botão de excluir pacote](/assets/images/help/package-registry/delete-package-button.png) -6. Para confirmar a exclusão, digite o nome do pacote e clique em **Eu entendo as consequências. Exclua esta versão**. ![Botão de confirmar exclusão de pacote](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. Para confirmar a exclusão, digite o nome do pacote e clique em **Eu entendo as consequências. Exclua esta versão**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-user-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-org-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Botão de excluir pacote](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Botão de confirmar exclusão de pacote](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/pt-BR/content/packages/index.md b/translations/pt-BR/content/packages/index.md index 5f69c1a281dc..28687b92f653 100644 --- a/translations/pt-BR/content/packages/index.md +++ b/translations/pt-BR/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: - - + - + title: ghcr.io container names redirect to the container page + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: Filter for tagged and untagged containers + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ + - title: Packages container support is an opt-in beta date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: Organization admins access to containers - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: Packages now respects IP allow list settings - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/pt-BR/content/rest/overview/libraries.md b/translations/pt-BR/content/rest/overview/libraries.md index 11477bb9a233..d07518ca711f 100644 --- a/translations/pt-BR/content/rest/overview/libraries.md +++ b/translations/pt-BR/content/rest/overview/libraries.md @@ -7,6 +7,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
    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 0dce11161924..062ccc1e80bd 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 @@ -42,8 +42,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -239,7 +240,7 @@ Error code name | Description -----------|-----------| `missing` | A resource does not exist. `missing_field` | A required field on a resource has not been set. -`invalid` | The formatting of a field is invalid. Review the documentation for the for more specific information. +`invalid` | The formatting of a field is invalid. Review the documentation for more specific information. `already_exists` | Another resource has the same value as this field. This can happen in resources that must have some unique key (such as label names). `unprocessable` | The inputs provided were invalid. @@ -270,7 +271,7 @@ Verb | Description `HEAD` | Can be issued against any resource to get just the HTTP header info. `GET` | Used for retrieving resources. `POST` | Used for creating resources. -`PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A PATCH request may accept one or more of the attributes to update the resource. PATCH is a relatively new and uncommon HTTP verb, so resource endpoints also accept `POST` requests. +`PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A `PATCH` request may accept one or more of the attributes to update the resource. `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. `DELETE` |Used for deleting resources. diff --git a/translations/pt-BR/content/rest/reference/enterprise-admin.md b/translations/pt-BR/content/rest/reference/enterprise-admin.md index bcbefb21d9f7..da5c8969e163 100644 --- a/translations/pt-BR/content/rest/reference/enterprise-admin.md +++ b/translations/pt-BR/content/rest/reference/enterprise-admin.md @@ -40,7 +40,7 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### 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 enterpriseServerVersions contains currentVersion %} 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. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** {% if enterpriseServerVersions contains currentVersion %}(which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) {% endif %}or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} 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 %} Enterprise administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% if enterpriseServerVersions contains currentVersion %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% 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 f4336a141cb6..609107932dc6 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 @@ -135,12 +135,12 @@ _Pesquisar_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _Responsáveis_ _Eventos_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _Etiquetas_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) diff --git a/translations/pt-BR/data/release-notes/2-20/23.yml b/translations/pt-BR/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..eba26c163ef5 --- /dev/null +++ b/translations/pt-BR/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '17-12-2020' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/pt-BR/data/release-notes/2-21/14.yml b/translations/pt-BR/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..9bd0fa2e0db8 --- /dev/null +++ b/translations/pt-BR/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '17-12-2020' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/pt-BR/data/release-notes/2-22/6.yml b/translations/pt-BR/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..f3fc5db2c980 --- /dev/null +++ b/translations/pt-BR/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '17-12-2020' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/pt-BR/data/reusables/actions/environments-beta.md b/translations/pt-BR/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/pt-BR/data/reusables/actions/forked-secrets.md b/translations/pt-BR/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..0132f98a4a1b --- /dev/null +++ b/translations/pt-BR/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +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. diff --git a/translations/pt-BR/data/reusables/classroom/assignments-classroom-prerequisite.md b/translations/pt-BR/data/reusables/classroom/assignments-classroom-prerequisite.md index 06284dad51ae..ccf7bc92adbb 100644 --- a/translations/pt-BR/data/reusables/classroom/assignments-classroom-prerequisite.md +++ b/translations/pt-BR/data/reusables/classroom/assignments-classroom-prerequisite.md @@ -1 +1 @@ -You must create a classroom before you can create an assignment. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." +You must create a classroom before you can create an assignment. Para obter mais informações, consulte "[Gerenciar salas de aula](/education/manage-coursework-with-github-classroom/manage-classrooms)". diff --git a/translations/pt-BR/data/reusables/classroom/click-classroom-in-list.md b/translations/pt-BR/data/reusables/classroom/click-classroom-in-list.md index fe7d091cdc72..a6211be58351 100644 --- a/translations/pt-BR/data/reusables/classroom/click-classroom-in-list.md +++ b/translations/pt-BR/data/reusables/classroom/click-classroom-in-list.md @@ -1 +1 @@ -1. In the list of classrooms, click the classroom you want to view. ![Classroom in list of classrooms for an organization](/assets/images/help/classroom/click-classroom-in-list.png) +1. In the list of classrooms, click the classroom you want to view. ![Sala de aula na lista de salas de aula de uma organização](/assets/images/help/classroom/click-classroom-in-list.png) diff --git a/translations/pt-BR/data/reusables/classroom/for-more-information-about-assignment-creation.md b/translations/pt-BR/data/reusables/classroom/for-more-information-about-assignment-creation.md index 8fd113d76353..229f29698dfa 100644 --- a/translations/pt-BR/data/reusables/classroom/for-more-information-about-assignment-creation.md +++ b/translations/pt-BR/data/reusables/classroom/for-more-information-about-assignment-creation.md @@ -1 +1 @@ -For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +Para obter mais informações, consulte "[Criar uma atividade individual](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" ou "[Criar uma atividade em grupo](/education/manage-coursework-with-github-classroom/create-a-group-assignment)". 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 16df66772690..913ff0dd6661 100644 --- a/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md +++ b/translations/pt-BR/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn` (apenas v1) (especifique `npm`) +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`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 %} monitore seu arquivo de manifesto de dependência para novas versões, use `pacote-ecosystem: "pip"` no seu arquivo *dependabot.yml*. diff --git a/translations/pt-BR/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/pt-BR/data/reusables/developer-site/pull_request_forked_repos_link.md index 7ee3021f384a..02b360dafd24 100644 --- a/translations/pt-BR/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/pt-BR/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -10,4 +10,4 @@ Quando você cria uma pull request a partir de um repositório bifurcado para o Fluxos de trabalho não são executados em repositórios bifurcados por padrão. Você deve habilitar o GitHub Actions na aba **Actions** (Ações) do repositório bifurcado. -As permissões para o `GITHUB_TOKEN` em repositórios bifurcados são somente leitura. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. Para obter mais informações, consulte "[Autenticação com o GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)". diff --git a/translations/pt-BR/data/reusables/discussions/click-discussion-in-list.md b/translations/pt-BR/data/reusables/discussions/click-discussion-in-list.md index 8156c86331db..2a96e33ffd6c 100644 --- a/translations/pt-BR/data/reusables/discussions/click-discussion-in-list.md +++ b/translations/pt-BR/data/reusables/discussions/click-discussion-in-list.md @@ -1 +1 @@ -1. In the list of discussions, click the discussion you want to view. ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) +1. Na lista de discussões, clique na discussão que você deseja visualizar. ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) diff --git a/translations/pt-BR/data/reusables/discussions/edit-category-details.md b/translations/pt-BR/data/reusables/discussions/edit-category-details.md index 8004b70314c3..07bcebadd8a6 100644 --- a/translations/pt-BR/data/reusables/discussions/edit-category-details.md +++ b/translations/pt-BR/data/reusables/discussions/edit-category-details.md @@ -1 +1 @@ -Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +Edite o emoji, título, descrição e formato de discussão para a categoria. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." diff --git a/translations/pt-BR/data/reusables/discussions/marking-a-comment-as-an-answer.md b/translations/pt-BR/data/reusables/discussions/marking-a-comment-as-an-answer.md index bdefffdea0d8..80305caedfcc 100644 --- a/translations/pt-BR/data/reusables/discussions/marking-a-comment-as-an-answer.md +++ b/translations/pt-BR/data/reusables/discussions/marking-a-comment-as-an-answer.md @@ -1,4 +1,4 @@ -You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. Para obter mais informações, consulte "[Sobre discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)". When you mark a question as an answer, {% data variables.product.product_name %} will highlight the comment and replies to the comment to help visitors quickly find the answer. diff --git a/translations/pt-BR/data/reusables/education/apply-for-team.md b/translations/pt-BR/data/reusables/education/apply-for-team.md index fcec4b895c92..70d120b7eb6a 100644 --- a/translations/pt-BR/data/reusables/education/apply-for-team.md +++ b/translations/pt-BR/data/reusables/education/apply-for-team.md @@ -1 +1 @@ -- Solicite o [{% data variables.product.prodname_team %}](/articles/github-s-products) grátis, que permite usuários e repositórios privados ilimitados. For more information, see "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)." +- Solicite o [{% data variables.product.prodname_team %}](/articles/github-s-products) grátis, que permite usuários e repositórios privados ilimitados. Para obter mais informações, consulte "[Aplicar um desconto para educador ou pesquisador](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)". diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/pt-BR/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/pt-BR/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/pt-BR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/pt-BR/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/gated-features/actions-shared.md b/translations/pt-BR/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..05c53435a655 --- /dev/null +++ b/translations/pt-BR/data/reusables/gated-features/actions-shared.md @@ -0,0 +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 %} não está disponível para repositórios privados pertencentes a contas usando os planos de legado por repositório. diff --git a/translations/pt-BR/data/reusables/gated-features/actions.md b/translations/pt-BR/data/reusables/gated-features/actions.md index 7b5d269daf8b..bafbe8fae92d 100644 --- a/translations/pt-BR/data/reusables/gated-features/actions.md +++ b/translations/pt-BR/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{{ 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/pt-BR/data/reusables/gated-features/auto-merge.md b/translations/pt-BR/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/pt-BR/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/gated-features/environments.md b/translations/pt-BR/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/pt-BR/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/pt-BR/data/reusables/github-actions/permissions-statement-environment.md b/translations/pt-BR/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/pt-BR/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/pt-BR/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/pt-BR/data/reusables/github-actions/sidebar-environment.md b/translations/pt-BR/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/pt-BR/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. diff --git a/translations/pt-BR/data/reusables/notifications/outbound_email_tip.md b/translations/pt-BR/data/reusables/notifications/outbound_email_tip.md index d03a58ca8c2f..7d476bbe8bf1 100644 --- a/translations/pt-BR/data/reusables/notifications/outbound_email_tip.md +++ b/translations/pt-BR/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. Para mais informações, entre em contato com o administrador do site. {% endnote %} - {% endif %} diff --git a/translations/pt-BR/data/reusables/organizations/add-dns-txt-record.md b/translations/pt-BR/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..b20b466e34bc --- /dev/null +++ b/translations/pt-BR/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. Para criar um registro TXT DNS com o serviço de hospedagem de domínio, siga as instruções em **Add a DNS TXT record** (Adicionar um registro TXT DNS). ![Instruções para criar um registro TXT DNS](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/organizations/add-domain.md b/translations/pt-BR/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..83f906a286e7 --- /dev/null +++ b/translations/pt-BR/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. No campo de domínio, digite o domínio que deseja verificar e clique em **Add domain** (Adicionar domínio). ![Campo Add a domain (Adicionar um domínio)](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/organizations/continue-verifying-domain.md b/translations/pt-BR/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..ab063f1c9a1e --- /dev/null +++ b/translations/pt-BR/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Botão do domínio Continue verifying (Continuar a verificação)](/assets/images/help/organizations/continue-verifying-domain.png) +10. Clique em **Verify domain** (Verificar domínio). ![Botão Verify domain (Verificar domínio)](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/organizations/restrict-email-notifications.md b/translations/pt-BR/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..4b044551751e --- /dev/null +++ b/translations/pt-BR/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. Em "Enforcement preferences" (Preferências de aplicação), selecione **Restrict email notifications to domain email** (Restringir notificações de e-mail aos e-mails do domínio). ![Caixa de seleção para restringir as notificações de e-mail aos e-mails do domínio verificado](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/organizations/verified-domains-details.md b/translations/pt-BR/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..3795e2ef7b43 --- /dev/null +++ b/translations/pt-BR/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. Se o site e o endereço de e-mail mostrados no perfil da organização estiverem hospedados em domínios diferentes, você deverá verificar os dois domínios. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/pages/wildcard-dns-warning.md b/translations/pt-BR/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..38d20bf70be2 --- /dev/null +++ b/translations/pt-BR/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**Aviso:** é altamente recomendável não usar registros DNS curingas, como `*.example.com`. O registro DNS curinga permite que qualquer pessoa hospede um site do {% data variables.product.prodname_pages %} em um dos subdomínios que você tem. + +{% endwarning %} 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 dad57b6e738a..ce9bd815f924 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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 %} +Suspender uma instalação do {% data variables.product.prodname_github_app %} está atualmente na versão 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)". diff --git a/translations/pt-BR/data/reusables/profile/profile-readme.md b/translations/pt-BR/data/reusables/profile/profile-readme.md index 891026b40c93..b19f12985921 100644 --- a/translations/pt-BR/data/reusables/profile/profile-readme.md +++ b/translations/pt-BR/data/reusables/profile/profile-readme.md @@ -1 +1 @@ -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. You can edit your profile README with {% data variables.product.company_short %} Flavored Markdown to create a personalized section on your profile. For more information, see "[Managing your profile README](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)." +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. You can edit your profile README with {% data variables.product.company_short %} Flavored Markdown to create a personalized section on your profile. Para obter mais informações, consulte "[Gerenciar seu perfil LEIAME](/github/setting-up-and-managing-your-github-profile/managing-your-profile-readme)". diff --git a/translations/pt-BR/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/pt-BR/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/pt-BR/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/pt-BR/data/reusables/pull_requests/you-can-auto-merge.md b/translations/pt-BR/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..784c6733e9fd --- /dev/null +++ b/translations/pt-BR/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. Para obter mais informações, consulte "[Fazer merge automático de um pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)". +{% endif %} \ No newline at end of file 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 57a206f28cbd..2b3dce80ccc2 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 @@ -When you search for a date, you can use greater than, less than, and range qualifiers to further filter results. For more information, see "[Understanding the search syntax](/github/searching-for-information-on-github/understanding-the-search-syntax)." +When you search for a date, you can use greater than, less than, and range qualifiers to further filter results. Para obter mais informações, consulte "[Entender a sintaxe de pesquisa](/github/searching-for-information-on-github/understanding-the-search-syntax)". 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 03c54ad08cfd..76b68f23101a 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 @@ -117,6 +117,7 @@ runs: {% endraw %} #### `outputs..value` + **Required** The value that the output parameter will be mapped to. You can set this to a `string` or an expression with context. For example, you can use the `steps` context to set the `value` of an output to the output value of a step. 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)". @@ -204,9 +205,11 @@ For example, this `cleanup.js` will only run on Linux-based runners: **Required** The run steps that you plan to run in this action. -##### `runs.steps.run` +##### `runs.steps[*].run` **Required** The command you want to run. This can be inline or a script in your action repository: + +{% raw %} ```yaml runs: using: "composite" @@ -214,6 +217,7 @@ runs: - run: ${{ github.action_path }}/test/script.sh shell: bash ``` +{% endraw %} Alternatively, you can use `$GITHUB_ACTION_PATH`: @@ -227,23 +231,23 @@ runs: For more information, see "[`github context`](/actions/reference/context-and-expression-syntax-for-github-actions#github-context)". -##### `runs.steps.shell` +##### `runs.steps[*].shell` **Required** The shell where you want to run the command. You can use any of the shells listed [here](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell). -##### `runs.steps.name` +##### `runs.steps[*].name` **Optional** The name of the composite run step. -##### `runs.steps.id` +##### `runs.steps[*].id` **Optional** A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)". -##### `runs.steps.env` +##### `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 {% 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` +##### `runs.steps[*].working-directory` **Optional** Specifies the working directory where the command is run. diff --git a/translations/ru-RU/content/actions/guides/about-continuous-integration.md b/translations/ru-RU/content/actions/guides/about-continuous-integration.md index 55a950c59553..2df3ff6117e5 100644 --- a/translations/ru-RU/content/actions/guides/about-continuous-integration.md +++ b/translations/ru-RU/content/actions/guides/about-continuous-integration.md @@ -25,7 +25,7 @@ Building and testing your code requires a server. You can build and test updates ### 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)." +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. 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 index 20c76a3bee7c..996109505608 100644 --- a/translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/ru-RU/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% 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)." +To authenticate to your private registry, you'll need to store your npm authentication token as a secret. For example, create a repository 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. +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 `NODE_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). diff --git a/translations/ru-RU/content/actions/guides/building-and-testing-powershell.md b/translations/ru-RU/content/actions/guides/building-and-testing-powershell.md index 11a2a58d307b..cad875bc8479 100644 --- a/translations/ru-RU/content/actions/guides/building-and-testing-powershell.md +++ b/translations/ru-RU/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ The `always()` function configures the job to continue processing even if there ### Publishing to PowerShell Gallery -You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use repository secrets to store any tokens or credentials needed to publish your package. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." +You can configure your workflow to publish your PowerShell module to the PowerShell Gallery when your CI tests pass. You can use secrets to store any tokens or credentials needed to publish your package. For more information, see "[Creating and using encrypted secrets](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)." The following example creates a package and uses `Publish-Module` to publish it to the PowerShell Gallery: 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 index 4acf9b7beb4c..ac05b2e4d7d6 100644 --- a/translations/ru-RU/content/actions/guides/building-and-testing-python.md +++ b/translations/ru-RU/content/actions/guides/building-and-testing-python.md @@ -391,7 +391,7 @@ jobs: 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)." +You can store any access tokens or credentials needed to publish your package using 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 diff --git a/translations/ru-RU/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/ru-RU/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..a4c7ce00e06b --- /dev/null +++ b/translations/ru-RU/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: Deploying to Amazon Elastic Container Service +intro: You can deploy to Amazon Elastic Container Service (ECS) as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/), and deploy it to [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/). + +On every new release in your {% data variables.product.company_short %} repository, the {% data variables.product.prodname_actions %} workflow builds and pushes a new container image to Amazon ECR, and then deploys a new task definition to Amazon ECS. + +### Требования + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps for Amazon ECR and ECS: + +1. Create an Amazon ECR repository to store your images. + + For example, using [the AWS CLI](https://aws.amazon.com/cli/): + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Ensure that you use the same Amazon ECR repository name (represented here by `MY_ECR_REPOSITORY`) for the `ECR_REPOSITORY` variable in the workflow below. + + Ensure that you use the same AWS region value for the `AWS_REGION` (represented here by `MY_AWS_REGION`) variable in the workflow below. + +2. Create an Amazon ECS task definition, cluster, and service. + + For details, follow the [Getting started wizard on the Amazon ECS console](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), or the [Getting started guide](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) in the Amazon ECS documentation. + + Ensure that you note the names you set for the Amazon ECS service and cluster, and use them for the `ECS_SERVICE` and `ECS_CLUSTER` variables in the workflow below. + +3. Store your Amazon ECS task definition as a JSON file in your {% data variables.product.company_short %} repository. + + The format of the file should be the same as the output generated by: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Ensure that you set the `CONTAINER_NAME` variable in the workflow below as the container name in the `containerDefinitions` section of the task definition. + +4. Create {% data variables.product.prodname_actions %} secrets named `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to store the values for your Amazon IAM access key. + + For more information on creating secrets for {% data variables.product.prodname_actions %}, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + See the documentation for each action used below for the recommended IAM policies for the IAM user, and methods for handling the access key credentials. + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to Amazon ECR. It then updates the task definition with the new image ID, and deploys the task definition to Amazon ECS. + +Ensure that you provide your own values for all the variables in the `env` key of the workflow. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### Additional resources + +For more information on the services used in these examples, see the following documentation: + +* "[Security best practices in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)" in the Amazon AWS documentation. +* Official AWS "[Configure AWS Credentials](https://github.com/aws-actions/configure-aws-credentials)" action. +* Official AWS [Amazon ECR "Login"](https://github.com/aws-actions/amazon-ecr-login) action. +* Official AWS [Amazon ECS "Render Task Definition"](https://github.com/aws-actions/amazon-ecs-render-task-definition) action. +* Official AWS [Amazon ECS "Deploy Task Definition"](https://github.com/aws-actions/amazon-ecs-deploy-task-definition) action. diff --git a/translations/ru-RU/content/actions/guides/deploying-to-azure-app-service.md b/translations/ru-RU/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..32ac95fb4092 --- /dev/null +++ b/translations/ru-RU/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: Deploying to Azure App Service +intro: You can deploy to Azure App Service as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build, test, and deploy an application to [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/). + +Azure App Service can run web apps in several languages, but this guide demonstrates deploying an existing Node.js project. + +### Требования + +Before creating your {% data variables.product.prodname_actions %} workflow, you will first need to complete the following setup steps: + +1. Create an Azure App Service plan. + + For example, you can use the Azure CLI to create a new App Service plan: + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + In the command above, replace `MY_RESOURCE_GROUP` with your pre-existing Azure Resource Group, and `MY_APP_SERVICE_PLAN` with a new name for the App Service plan. + + See the Azure documentation for more information on using the [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/): + + * For authentication, see "[Sign in with Azure CLI](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)". + * If you need to create a new resource group, see "[az group](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)." + +2. Create a web app. + + For example, you can use the Azure CLI to create an Azure App Service web app with a node runtime: + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + In the command above, replace the parameters with your own values, where `MY_WEBAPP_NAME` is a new name for the web app. + +3. Configure an Azure publish profile and create an `AZURE_WEBAPP_PUBLISH_PROFILE` secret. + + Generate your Azure deployment credentials using a publish profile. For more information, see "[Generate deployment credentials](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)" in the Azure documentation. + + In your {% data variables.product.prodname_dotcom %} repository, create a secret named `AZURE_WEBAPP_PUBLISH_PROFILE` that contains the contents of the publish profile. For more information on creating secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build, test, and deploy the Node.js project to Azure App Service. + +Ensure that you set `AZURE_WEBAPP_NAME` in the workflow `env` key to the name of the web app you created. + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### Additional resources + +The following resources may also be useful: + +* For the original starter workflow, see [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml) in the {% data variables.product.prodname_actions %} `starter-workflows` repository. +* The action used to deploy the web app is the official Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) action. +* The "[Create a Node.js web app in Azure](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)" quickstart in the Azure web app documentation demonstrates using VS Code with the [Azure App Service extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice). diff --git a/translations/ru-RU/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/ru-RU/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..3628c6eaa12d --- /dev/null +++ b/translations/ru-RU/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: Deploying to Google Kubernetes Engine +intro: You can deploy to Google Kubernetes Engine as part of your continuous deployment (CD) 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 %} + +### Introduction + +This guide explains how to use {% data variables.product.prodname_actions %} to build a containerized application, push it to Google Container Registry (GCR), and deploy it to Google Kubernetes Engine (GKE). + +GKE is a managed Kubernetes cluster service from Google Cloud that can host your containerized workloads in the cloud or in your own datacenter. For more information, see [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine). + +### Требования + +Before you proceed with creating the workflow, you will need to complete the following steps for your Kubernetes project. This guide assumes the root of your project already has a `Dockerfile` and a Kubernetes Deployment configuration file. For an example, see [google-github-actions](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke). + +#### Creating a GKE cluster + +To create the GKE cluster, you will first need to authenticate using the `gcloud` CLI. For more information on this step, see the following articles: +- [`gcloud auth login`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI and Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +Например: + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### Enabling the APIs + +Enable the Kubernetes Engine and Container Registry APIs. Например: + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### Configuring a service account and storing its credentials + +This procedure demonstrates how to create the service account for your GKE integration. It explains how to create the account, add roles to it, retrieve its keys, and store them as a base64-encoded [encrypted repository secret](/actions/reference/encrypted-secrets) named `GKE_SA_KEY`. + +1. Create a new service account: + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. Retrieve the email address of the service account you just created: + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. Add roles to the service account. Note: Apply more restrictive roles to suit your requirements. + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. Download the JSON keyfile for the service account: + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. Store the project ID as a secret named `GKE_PROJECT`: + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### (Optional) Configuring kustomize +Kustomize is an optional tool used for managing YAML specs. After creating a _kustomization_ file, the workflow below can be used to dynamically set fields of the image and pipe in the result to `kubectl`. For more information, see [kustomize usage](https://github.com/kubernetes-sigs/kustomize#usage). + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to GCR. It then uses the Kubernetes tools (such as `kubectl` and `kustomize`) to pull the image into the cluster deployment. + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### Additional resources + +For more information on the tools used in these examples, see the following documentation: + +* For the full starter workflow, see the ["Build and Deploy to GKE" workflow](https://github.com/actions/starter-workflows/blob/master/ci/google.yml). +* For more starter workflows and accompanying code, see Google's [{% data variables.product.prodname_actions %} example workflows](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/). +* The Kubernetes YAML customization engine: [Kustomize](https://kustomize.io/). +* "[Deploying a containerized web application](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)" in the Google Kubernetes Engine documentation. diff --git a/translations/ru-RU/content/actions/guides/index.md b/translations/ru-RU/content/actions/guides/index.md index 4a0e3a32c74b..19b976dfcca4 100644 --- a/translations/ru-RU/content/actions/guides/index.md +++ b/translations/ru-RU/content/actions/guides/index.md @@ -36,6 +36,14 @@ You can use {% data variables.product.prodname_actions %} to create custom conti {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### Creating custom continuous deployment workflows + +You can use {% data variables.product.prodname_actions %} to create custom continuous deployment (CD) workflows that deploy projects to a number of cloud partner ecosystems. + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### 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 %}. diff --git a/translations/ru-RU/content/actions/guides/publishing-docker-images.md b/translations/ru-RU/content/actions/guides/publishing-docker-images.md index 62536e072786..9d74b3db6823 100644 --- a/translations/ru-RU/content/actions/guides/publishing-docker-images.md +++ b/translations/ru-RU/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ In this guide, we will use the Docker `build-push-action` action to build the Do 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. +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 "[Pushing a Docker container image to Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)" 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 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)." +* `username` and `password`: This is your Docker Hub username and password. We recommend storing your Docker Hub username and password as secrets 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 %} diff --git a/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md b/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md index 8069dc936c7d..542c50c2b86c 100644 --- a/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/ru-RU/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ If you add steps in your workflow to configure the `publishConfig` fields in you 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)." +To perform authenticated operations against the npm registry in your workflow, you'll need to store your npm authentication token as a secret. For example, create a repository 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`. diff --git a/translations/ru-RU/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/ru-RU/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index a2f5f1a7ecd4..b24159ce4967 100644 --- a/translations/ru-RU/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/translations/ru-RU/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/ru-RU/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md b/translations/ru-RU/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md index 10ac634a539e..b7aa8e6513be 100644 --- a/translations/ru-RU/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md +++ b/translations/ru-RU/content/actions/hosting-your-own-runners/monitoring-and-troubleshooting-self-hosted-runners.md @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/ru-RU/content/actions/index.md b/translations/ru-RU/content/actions/index.md index 4365c6f49508..39b2e0d29179 100644 --- a/translations/ru-RU/content/actions/index.md +++ b/translations/ru-RU/content/actions/index.md @@ -25,6 +25,10 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: + - + title: Workflow visualization + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ - title: Removing set-env and add-path commands on November 16 date: '2020-11-09' @@ -33,14 +37,6 @@ changelog: title: Ubuntu-latest workflows will use Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - - title: MacOS Big Sur Preview - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - - title: Self-Hosted Runner Group Access Changes - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU redirect_from: - /articles/automating-your-workflow-with-github-actions/ 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 index 6fb3134867ba..be8b6c25f242 100644 --- 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 @@ -76,7 +76,7 @@ steps: #### 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`: +Referring to a specific branch means that the action will always use 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: 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 index 8d3c70684858..5bc71b695801 100644 --- 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 @@ -1,7 +1,7 @@ --- 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.' +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,{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} environments,{% endif %} and labels.' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: For more information, see ["Using labels with self-hosted runners](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Using environments + +You can configure environments with protection rules and secrets. Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." +{% endif %} + ### Дальнейшие шаги 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-jenkins-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-jenkins-to-github-actions.md index 6ab845e88b06..c1a4b1bb0af9 100644 --- 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 @@ -57,7 +57,7 @@ Jenkins uses directives to manage _Declarative Pipelines_. These directives defi | 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) | +| [`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) | diff --git a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index 497aa02c44b7..9f34eb94af73 100644 --- a/translations/ru-RU/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/ru-RU/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ When migrating from Travis CI, consider the following key features in {% data va #### Storing secrets -{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} also includes policies that allow you to limit access to secrets at the repository and organization level. For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." +{% data variables.product.prodname_actions %} allows you to store secrets and reference them in your jobs. {% data variables.product.prodname_actions %} organizations can limit which repositories can access organization secrets. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}Environment protection rules can require manual approval for a workflow to access environment secrets. {% endif %}For more information, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." #### Sharing files between jobs and workflows 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 index 5e104fc5b90c..c6a734ce0807 100644 --- 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 @@ -19,7 +19,7 @@ This guide explains how to configure security hardening for certain {% data vari ### 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 %}. +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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environment{% else %} or repository{% endif %} 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. @@ -38,6 +38,10 @@ To help prevent accidental disclosure, {% data variables.product.product_name %} - **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. +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **Consider requiring review for access to secrets** + - You can use required reviewers to protect environment secrets. A workflow job cannot access environment secrets until approval is granted by a reviewer. For more information about storing secrets in environments or requiring reviews for environments, see "[Encrypted secrets](/actions/reference/encrypted-secrets)" and "[Environments](/actions/reference/environments)." +{% endif %} ### Using third-party actions @@ -66,13 +70,13 @@ This means that a compromise of a single action within a workflow can be very si ### 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. +{% data variables.product.product_name %} is intentionally scoped for a single repository at a time. The `GITHUB_TOKEN` 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 a workflow, 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. +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. 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** +1. **The `GITHUB_TOKEN`** - 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** 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 index f28a20c8b64e..a4787be05af4 100644 --- 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 @@ -13,6 +13,9 @@ versions: 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/index.md b/translations/ru-RU/content/actions/managing-workflow-runs/index.md index 8905d8b08742..4d5e7554b128 100644 --- a/translations/ru-RU/content/actions/managing-workflow-runs/index.md +++ b/translations/ru-RU/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- 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.' +intro: 'You can view the status and results of each step in your workflow, cancel a pending workflow, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}review deployments, {% endif %}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 @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/ru-RU/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/ru-RU/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..cbeb7fe2ce54 --- /dev/null +++ b/translations/ru-RU/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: Reviewing deployments +intro: You can approve or reject jobs awaiting review. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About required reviews in workflows + +Jobs that reference an environment configured with required reviewers will wait for an approval before starting. While a job is awaiting approval, it has a status of "Waiting". If a job is not approved within 30 days, the workflow run will be automatically canceled. + +For more information about environments and required approvals, see "[Environments](/actions/reference/environments)." + +### Approving or rejecting a job + +1. Navigate to the workflow run that requires review. For more information about navigating to a workflow run, see "[Viewing workflow run history](/actions/managing-workflow-runs/viewing-workflow-run-history)." +2. Click **Review deployments**. ![Review deployments](/assets/images/actions-review-deployments.png) +3. Select the job environment(s) to approve or reject. Optionally, leave a comment. ![Approve deployments](/assets/images/actions-approve-deployments.png) +4. Approve or reject: + - To approve the job, click **Approve and deploy**. Once a job is approved (and any other environment protection rules have passed), the job will proceed. At this point, the job can access any secrets stored in the environment. + - To reject the job, click **Reject**. If a job is rejected, the workflow will fail. 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 index 600f7715674c..31154efd327f 100644 --- a/translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/ru-RU/content/actions/reference/authentication-in-a-workflow.md @@ -14,8 +14,6 @@ versions: {% 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. diff --git a/translations/ru-RU/content/actions/reference/encrypted-secrets.md b/translations/ru-RU/content/actions/reference/encrypted-secrets.md index a5648dde2704..3fd80100a491 100644 --- a/translations/ru-RU/content/actions/reference/encrypted-secrets.md +++ b/translations/ru-RU/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- title: Encrypted secrets -intro: Encrypted secrets allow you to store sensitive information in your repository or organization. +intro: Encrypted secrets allow you to store sensitive information in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environments{% else %} or repository{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,14 +12,19 @@ versions: --- {% data reusables.actions.enterprise-beta %} +{% data reusables.actions.environments-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. +Secrets are encrypted environment variables that you create in an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environment{% else %} or repository{% endif %}. The secrets that 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 %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +For secrets stored at the environment level, you can enable required reviewers to control access to the secrets. A workflow job cannot access environment secrets until approval is granted by required approvers. +{% endif %} + #### Naming your secrets The following rules apply to secret names: @@ -27,7 +32,10 @@ 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. +* Secret names are not case-sensitive. +* Secret names must be unique at the level they are created at. For example, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}a secret created at the environment level must have a unique name in that environment, {% endif %}a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level. + + If a secret with the same name exists at multiple levels, the secret at the lower level takes precedence. For example, if an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Similarly, if an organization, repository, and environment all have a secret with the same name, the environment-level secret takes precedence.{% endif %} 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. @@ -43,6 +51,10 @@ You can use and read encrypted secrets in a workflow file if you have access to {% endwarning %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Organization and repository secrets are read when a workflow run is queued, and environment secrets are read when a job referencing the environment starts. +{% endif %} + You can also manage secrets using the REST API. For more information, see "[Secrets](/rest/reference/actions#secrets)." #### Limiting credential permissions @@ -56,12 +68,27 @@ When generating credentials, we recommend that you grant the minimum permissions {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} {% data reusables.github-actions.sidebar-secret %} -1. Click **Add a new secret**. +1. Click **New repository 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. +If your repository {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}has environment secrets or {% endif %}can access secrets from the parent organization, then those secrets are also listed on this page. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Creating encrypted secrets for an environment + +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click on the environment that you want to add a secret to. +1. Under **Environment secrets**, click **Add secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the value for your secret. +1. Click **Add secret**. +{% endif %} ### Creating encrypted secrets for an organization @@ -72,7 +99,7 @@ When creating a secret in an organization, you can use a policy to limit which r {% data reusables.organizations.navigate-to-org %} {% data reusables.organizations.org_settings %} {% data reusables.github-actions.sidebar-secret %} -1. Click **New secret**. +1. Click **New organization 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. @@ -90,7 +117,7 @@ You can check which access policies are being applied to a secret in your organi ### 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. +{% data reusables.actions.forked-secrets %} 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)." @@ -150,7 +177,7 @@ steps: ### Limits for secrets -Your workflow can have up to 100 secrets. The names of secret environment variables must be unique in a repository. +You can store up to 1,000 secrets per organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 secrets per repository, and 100 secrets per environment{% else %} and 100 secrets per repository{% endif %}. A workflow may use up to 100 organization secrets and 100 repository secrets.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Additionally, a job referencing an environment may use up to 100 environment secrets.{% endif %} 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)." diff --git a/translations/ru-RU/content/actions/reference/environment-variables.md b/translations/ru-RU/content/actions/reference/environment-variables.md index cb4bb85fb700..d87be6dcc32f 100644 --- a/translations/ru-RU/content/actions/reference/environment-variables.md +++ b/translations/ru-RU/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)." +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: @@ -51,8 +51,8 @@ We strongly recommend that actions use environment variables to access the files | `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_HEAD_REF` | Only set for pull request events. The name of the head branch. | +| `GITHUB_BASE_REF` | Only set for pull request events. The name of the base branch. | | `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 %}`. | diff --git a/translations/ru-RU/content/actions/reference/environments.md b/translations/ru-RU/content/actions/reference/environments.md new file mode 100644 index 000000000000..58585b2950b1 --- /dev/null +++ b/translations/ru-RU/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: Environments +intro: You can configure environments with protection rules and secrets. A workflow job can reference an environment to use the environment's protection rules and secrets. +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### About environments + +You can configure environments with protection rules and secrets. When a workflow job references an environment, the job won't start until all of the environment's protection rules pass. A job also cannot access secrets that are defined in an environment until all the environment protection rules pass. + +{% if currentVersion == "free-pro-team@latest" %} +Environment protection rules and environment secrets are only available on public repositories. If you convert a repository from public to private, any configured protection rules or environment secrets will be ignored, and you will not be able to configure any environments. If you convert your repository back to public, you will have access to any previously configured protection rules and environment secrets. +{% endif %} + +#### Environment protection rules + +Environment protection rules require specific conditions to pass before a job referencing the environment can proceed. You can use environment protection rules to require a manual approval or to delay a job. + +##### Required reviewers + +Use required reviewers to require a specific person or team to approve workflow jobs that reference the environment. You can list up to six users or teams as reviewers. The reviewers must have at least read access to the repository. Only one of the required reviewers needs to approve the job for it to proceed. + +For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +##### Wait timer + +Use a wait timer to delay a job for a specific amount of time after the job is initially triggered. The time (in minutes) must be an integer between 0 and 43,200 (30 days). + +#### Environment secrets + +Secrets stored in an environment are only available to workflow jobs that reference the environment. If the environment requires approval, a job cannot access environment secrets until one of the required reviewers approves it. For more information about secrets, see "[Encrypted secrets](/actions/reference/encrypted-secrets)." + +### Creating an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click **New environment**. +1. Enter a name for the environment, then click **Configure environment**. Environment names are not case sensitive. An environment name may not exceed 255 characters and must be unique within the repository. +1. Configure any environment protection rules or environment secrets. + +Running a workflow that references an environment that does not exist will create an environment with the referenced name. The newly created environment will not have any protection rules or secrets configured. Anyone that can edit workflows in the repository can create environments via a workflow file, but only repository admins can configure the environment. + +### Referencing an environment + +Each job in a workflow can reference a single environment. Any protection rules configured for the environment must pass before a job referencing the environment is sent to a runner. When the job is sent to the runner, the job can access the environment's secrets. + +For more information on syntax to reference environments in workflows, see "[Workflow syntax for GitHub Actions](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)." For more information on reviewing jobs that reference an environment with required reviewers, see "[Reviewing deployments](/actions/managing-workflow-runs/reviewing-deployments)." + +When a workflow references an environment, the environment will appear in the repository's deployments. For more information about viewing current and previous deployments, see "[Viewing deployment history](/developers/overview/viewing-deployment-history)." + +### Deleting an environment + +{% data reusables.github-actions.permissions-statement-environment %} + +Deleting an environment will delete all secrets and protection rules associated with the environment. Any jobs currently waiting because of protection rules from the deleted environment will automatically fail. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Next the the environment that you want to delete, click {% octicon "trashcan" aria-label="The trashcan icon" %}. +2. Click **I understand, delete this environment**. 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 10b9a27f8724..233474b01723 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 @@ -309,9 +309,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`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | +| Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------- | -------------- | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | Last commit on default branch | Default branch | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -576,7 +576,13 @@ on: #### `pull_request_target` -This event is similar to `pull_request`, except that it runs in the context of the base repository of the pull request, rather than in the merge commit. This means that you can more safely make your secrets available to the workflows triggered by the pull request, because only workflows defined in the commit on the base repository are run. For example, this event allows you to create workflows that label and comment on pull requests, based on the contents of the event payload. +This event runs in the context of the base of the pull request, rather than in the merge commit as the `pull_request` event does. This prevents executing unsafe workflow code from the head of the pull request that could alter your repository or steal any secrets you use in your workflow. This event allows you to do things like create workflows that label and comment on pull requests based on the contents of the event payload. + +{% warning %} + +**Warning:** The `pull_request_target` event is granted a read/write repository token and can access secrets, even when it is triggered from a fork. Although the workflow runs in the context of the base of the pull request, you should make sure that you do not check out, build, or run untrusted code from the pull request with this event. Additionally, any caches share the same scope as the base branch, and to help prevent cache poisoning, you should not save the cache if there is a possibility that the cache contents were altered. + +{% endwarning %} | Webhook event payload | Activity types | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- | -------------- | @@ -725,4 +731,4 @@ on: {% 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)." -If you would like to trigger a workflow from a workflow run, you can trigger the event using a personal access token. You'll need to create a personal access token and store it as a secret. To minimize your {% data variables.product.prodname_actions %} usage costs, ensure that you don't create recursive or unintended workflow runs. For more information, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." +If you would like to trigger a workflow from a workflow run, you can trigger the event using a personal access token. You'll need to create a personal access token and store it as a secret. To minimize your {% data variables.product.prodname_actions %} usage costs, ensure that you don't create recursive or unintended workflow runs. For more information on storing a personal access token as a secret, see "[Creating and storing encrypted secrets](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)." diff --git a/translations/ru-RU/content/actions/reference/index.md b/translations/ru-RU/content/actions/reference/index.md index 8ba0434eae90..6d08e2db337d 100644 --- a/translations/ru-RU/content/actions/reference/index.md +++ b/translations/ru-RU/content/actions/reference/index.md @@ -27,11 +27,19 @@ You can configure workflows to run when specific GitHub events occur, at a sched ### 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. +{% 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{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or environments{% else %} or repository{% endif %}. {% data variables.product.prodname_dotcom %} encrypts all secrets. {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Environments + +Workflow jobs can reference environments that have protection rules or environment-specific secrets. + +{% link_in_list /environments %} +{% endif %} + ### {% 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. 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 e93f3ed69b80..9d4eb18a9fae 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 @@ -305,11 +305,13 @@ steps: `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. +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### Пример +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 71898fbdfd22..954d2a359f50 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 @@ -187,7 +187,7 @@ For more information about cron syntax, see "[Events that trigger workflows](/ac ### `env` -A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all jobs and steps in the workflow. You can also set environment variables that are only available to a job or step. For more information, see [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: A workflow run is made up of one or more jobs. Jobs run in parallel by default. To run jobs sequentially, you can define dependencies on other jobs using the `jobs..needs` keyword. -Each job runs in an environment specified by `runs-on`. +Each job runs in a runner 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 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. @@ -320,6 +320,39 @@ 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)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +The environment that the job references. All environment protection rules must pass before a job referencing the environment is sent to a runner. For more information, see "[Environments](/actions/reference/environments)." + +You can provide the environment as only the environment `name`, or as an environment object with the `name` and `url`. The URL maps to `environment_url` in the deployments API. For more information about the deployments API, see "[Deployments](/rest/reference/repos#deployments)." + +##### Example using a single environment name + +```yaml +environment: staging_environment +``` + +##### Example using environment name and URL + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +The URL can be an expression and can use any context except for the `secrets` context. For more information about expressions, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." + +#### Пример +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `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). @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps.env`](#jobsjob_idstepsenv). +A `map` of environment variables that are available to all steps in the job. You can also set environment variables for the entire workflow or an individual step. For more information, see [`env`](#env) and [`jobs..steps[*].env`](#jobsjob_idstepsenv). {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `jobs..steps[*].id` A unique identifier for the step. You can use the `id` to reference the step in contexts. For more information, see "[Context and expression syntax for {% data variables.product.prodname_actions %}](/actions/reference/context-and-expression-syntax-for-github-actions)." -### `jobs..steps.if` +### `jobs..steps[*].if` You can use the `if` conditional to prevent a step from running unless a condition is met. You can use any supported context and expression to create a conditional. @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` A name for your step to display on {% data variables.product.prodname_dotcom %}. -### `jobs..steps.uses` +### `jobs..steps[*].uses` Selects an action to run as part of a step in your job. An action is a reusable unit of code. You can use an action defined in the same repository as the workflow, a public repository, or in a [published Docker container image](https://hub.docker.com/). @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` Runs command-line programs using the operating system's shell. If you do not provide a `name`, the step name will default to the text specified in the `run` command. @@ -675,7 +708,7 @@ For built-in shell keywords, we provide the following defaults that are executed - There doesn't seem to be a way to fully opt into fail-fast behavior other than writing your script to check each error code and respond accordingly. Because we can't actually provide that behavior by default, you need to write this behavior into your script. - `cmd.exe` will exit with the error level of the last program it executed, and it will return the error code to the runner. This behavior is internally consistent with the previous `sh` and `pwsh` default behavior and is the `cmd.exe` default, so this behavior remains intact. -### `jobs..steps.with` +### `jobs..steps[*].with` A `map` of the input parameters defined by the action. Each input parameter is a key/value pair. Input parameters are set as environment variables. The variable is prefixed with `INPUT_` and converted to upper case. @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` A `string` that defines the inputs for a Docker container. {% data variables.product.prodname_dotcom %} passes the `args` to the container's `ENTRYPOINT` when the container starts up. An `array of strings` is not supported by this parameter. @@ -718,7 +751,7 @@ 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` +### `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. @@ -734,7 +767,7 @@ steps: The `entrypoint` keyword is meant to be used with Docker container actions, but you can also use it with JavaScript actions that don't define any inputs. -### `jobs..steps.env` +### `jobs..steps[*].env` Sets environment variables for steps to use in the runner environment. You can also set environment variables for the entire workflow or a job. For more information, see [`env`](#env) and [`jobs..env`](#jobsjob_idenv). @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` Prevents a job from failing when a step fails. Set to `true` to allow a job to pass when this step fails. -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` The maximum number of minutes to run the step before killing the process. @@ -769,7 +802,7 @@ The maximum number of minutes to let a job run before {% data variables.product. ### `jobs..strategy` -A strategy creates a build matrix for your jobs. You can define different variations of an environment to run each job in. +A strategy creates a build matrix for your jobs. You can define different variations to run each job in. ### `jobs..strategy.matrix` diff --git a/translations/ru-RU/content/admin/configuration/configuring-email-for-notifications.md b/translations/ru-RU/content/admin/configuration/configuring-email-for-notifications.md index 5ed5607bf3b5..03d990e4b93d 100644 --- a/translations/ru-RU/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/ru-RU/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ Your dedicated technical account manager in {% data variables.contact.github_support %} can configure email for notifications to be sent through your SMTP server. Make sure you include the following details in your support request. - Your SMTP server address +- Login information to authenticate to the server: username and password - The port your SMTP server uses to send email - The domain name that your SMTP server will send with a HELO response, if any - The type of encryption used by your SMTP server diff --git a/translations/ru-RU/content/admin/enterprise-support/about-github-enterprise-support.md b/translations/ru-RU/content/admin/enterprise-support/about-github-enterprise-support.md index eae7d38f0c10..e199c0603304 100644 --- a/translations/ru-RU/content/admin/enterprise-support/about-github-enterprise-support.md +++ b/translations/ru-RU/content/admin/enterprise-support/about-github-enterprise-support.md @@ -94,7 +94,7 @@ For urgent issues, we can help you in English 24 hours per day, 7 days per week, | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | New Year's Eve | December 31 | #### Holidays in Japan 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 a8d197c64847..df7623bd37a6 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 @@ -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. -| U.S. holiday | Date observed in 2018 | +| U.S. holiday | Date observed | | --------------------------- | --------------------------- | | New Year's Day | January 1 | | Martin Luther King, Jr. Day | Third Monday in January | @@ -57,7 +57,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in | Day after Thanksgiving | Fourth Friday in November | | Christmas Eve | December 24 | | Christmas Day | December 25 | -| Day after Christmas | December 26 | +| Day after Christmas | December 28 | | New Year's Eve | December 31 | ### Installing {% data variables.product.prodname_advanced_security %} updates 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 26731d2fac88..4c37b9eed58f 100644 --- a/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md +++ b/translations/ru-RU/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ An enterprise account allows you to manage multiple organizations{% if enterpris - Security {% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication) - Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} 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 9e71ad1abb18..f169cc5abb4b 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 @@ -51,6 +51,7 @@ GitHub Desktop keyboard shortcuts on macOS | ⌘2 | Show your commit history | | ⌘B | Show all your branches | | ⌘G | Go to the commit summary field | +| ⌘Enter | Commit changes when summary or description field is active | | space | Select or deselect all highlighted files | | ⇧⌘N | Create a new branch | | ⇧⌘R | Rename the current branch | @@ -104,6 +105,7 @@ GitHub Desktop keyboard shortcuts on Windows | Ctrl2 | Show your commit history | | CtrlB | Show all your branches | | CtrlG | Go to the commit summary field | +| CtrlEnter | Commit changes when summary or description field is active | | space | Select or deselect all highlighted files | | CtrlShiftN | Create a new branch | | CtrlShiftR | Rename the current branch | 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 9fcdadc68714..2ac221d7dcb9 100644 --- a/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/ru-RU/content/developers/apps/authorizing-oauth-apps.md @@ -265,7 +265,9 @@ The optional `redirect_uri` parameter can also be used for localhost URLs. If th For the `http://localhost/path` callback URL, you can use this `redirect_uri`: - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### Creating multiple tokens for OAuth Apps 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 c2ec9ed7685f..36e5a4271745 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 @@ -49,39 +49,39 @@ The complete list of available query parameters, permissions, and events is list 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](/rest/reference/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](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | -| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`. | +| [`checks`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | Grants access to the [Checks API](/rest/reference/checks). Can be one of: `none`, `read`, or `write`. | +| `content_references` | Grants access to the "[Create a content attachment](/rest/reference/apps#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`.{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | Grants access to the [Emails API](/rest/reference/users#emails). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`followers`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | Grants access to the [Followers API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/users#keys). 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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/orgs#update-an-organization)" endpoint and the [Organization Interaction Restrictions API](/rest/reference/interactions#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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/repos#hooks). 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](/rest/reference/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](/rest/reference/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](/rest/reference/projects). Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} | [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Grants access to the [Secret scanning API](/rest/reference/secret-scanning). Can be one of: `none`, `read`, or `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} | [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | Grants access to the [Code scanning API](/rest/reference/code-scanning/). Can be one of: `none`, `read`, or `write`.{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/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`. | +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | Grants access to the [Contents API](/rest/reference/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](/rest/reference/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](/rest/reference/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](/rest/reference/teams#discussions) and the [Team Discussion Comments API](/rest/reference/teams#discussion-comments). Can be one of: `none`, `read`, or `write`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `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`.{% endif %} +| `наблюдение` | 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 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 2699b681e6a1..237d0f86bb7e 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 @@ -85,7 +85,7 @@ Unlike OAuth apps, GitHub Apps have targeted permissions that allow them to requ | GitHub Apps | OAuth Apps | | ----------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they needs to receive events from. | +| By default, GitHub Apps have a single webhook that receives the events they are configured to receive for every repository they have access to. | OAuth Apps request the webhook scope to create a repository webhook for each repository they need to receive events from. | | GitHub Apps receive certain organization-level events with the organization member's permission. | OAuth Apps request the organization webhook scope to create an organization webhook for each organization they need to receive organization-level events from. | ### Git access 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 5257e05decbc..c8b96a6040c5 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 @@ -67,7 +67,7 @@ If the user accepts your request, GitHub redirects back to your site with a temp {% endnote %} -Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." +Exchange this `code` for an access token. {% if currentVersion == "free-pro-team@latest" %} 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](/developers/apps/refreshing-user-to-server-access-tokens)." 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 %} 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 caf739366085..bccc484a16f3 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 @@ -7,13 +7,11 @@ versions: free-pro-team: '*' --- -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} -{% endif %} ### Suspending a GitHub App diff --git a/translations/ru-RU/content/developers/apps/using-content-attachments.md b/translations/ru-RU/content/developers/apps/using-content-attachments.md index c78b7725e93b..605a1b1bb758 100644 --- a/translations/ru-RU/content/developers/apps/using-content-attachments.md +++ b/translations/ru-RU/content/developers/apps/using-content-attachments.md @@ -166,7 +166,7 @@ To create a Probot App, follow these steps: } ``` -4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to [localhost:3000](http://localhost:3000), and click the **Register GitHub App** button: +4. [Run the GitHub App locally](https://probot.github.io/docs/development/#running-the-app-locally). Navigate to `http://localhost:3000`, and click the **Register GitHub App** button: ![Register a Probot GitHub App](/assets/images/github-apps/github_apps_probot-registration.png) diff --git a/translations/ru-RU/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/ru-RU/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index 9252c41ece19..342754e94dfb 100644 --- a/translations/ru-RU/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/ru-RU/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -4,6 +4,5 @@ intro: 'You can list free and paid tools for developers to use in {% data variab mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/ru-RU/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/ru-RU/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index aa9d924b4990..8e765778101b 100644 --- a/translations/ru-RU/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/ru-RU/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -48,7 +48,7 @@ Customers can start a free trial for any paid plan on a Marketplace listing that Free trials have a fixed length of 14 days. Customers are notified 4 days before the end of their trial period (on day 11 of the free trial) that their plan will be upgraded. At the end of a free trial, customers will be auto-enrolled into the plan they are trialing if they do not cancel. -For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)." +For more information, see: "[Handling new purchases and free trials](/developers/github-marketplace/handling-new-purchases-and-free-trials/)." {% note %} diff --git a/translations/ru-RU/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/ru-RU/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index 3c8a760f5854..0264e77e2ec2 100644 --- a/translations/ru-RU/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/ru-RU/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -13,8 +13,14 @@ versions: -After your {% data variables.product.prodname_marketplace %} listing is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the onboarding process. +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -Once your revenue reaches a minimum of $500 U.S. Dollars for the month, you'll receive an electronic payment from {% data variables.product.product_name %} for 75% of the sales price. +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/ru-RU/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/ru-RU/content/developers/github-marketplace/requirements-for-listing-an-app.md index 2ae24c334eef..aed7c5d235d1 100644 --- a/translations/ru-RU/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/ru-RU/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -53,7 +53,7 @@ In addition to the requirements for all apps above, each app that you offer as a - {% data variables.product.prodname_github_app %}s should have a minimum of 100 installations. - {% data variables.product.prodname_oauth_app %}s should have a minimum of 200 users. - All paid apps must handle {% data variables.product.prodname_marketplace %} purchase events for new purchases, upgrades, downgrades, cancellations, and free trials. For more information, see "[Billing requirements for paid apps](#billing-requirements-for-paid-apps)" below. -- Publishing organizations must have a verified domain and must enable two-factor authentication. 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.") +- Publishing organizations must have a verified domain and must enable two-factor authentication. 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)." When you are ready to publish the app on {% data variables.product.prodname_marketplace %} you must request verification for the listing. diff --git a/translations/ru-RU/content/developers/overview/index.md b/translations/ru-RU/content/developers/overview/index.md index a17fbce46f2c..10e25d7dce73 100644 --- a/translations/ru-RU/content/developers/overview/index.md +++ b/translations/ru-RU/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 8fecf2688086..4018fe085dba 100644 --- a/translations/ru-RU/content/developers/overview/managing-deploy-keys.md +++ b/translations/ru-RU/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ If you don't want to use SSH keys, you can use [HTTPS with OAuth tokens][git-aut * Users don't have to change their local SSH settings. * Multiple tokens (one for each user) are not needed; one token per server is enough. * A token can be revoked at any time, turning it essentially into a one-use password. +{% if enterpriseServerVersions contains currentVersion %} * Generating new tokens can be easily scripted using [the OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization). +{% endif %} ##### Cons diff --git a/translations/ru-RU/content/developers/overview/viewing-deployment-history.md b/translations/ru-RU/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..bd0b394f48d5 --- /dev/null +++ b/translations/ru-RU/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: Viewing deployment history +intro: View current and previous deployments for your repository. +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +You can deliver deployments through {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %} and environments or with {% endif %}the REST API and third party apps. {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}For more information about {% data variables.product.prodname_actions %}, see "[{% data variables.product.prodname_actions %}](/actions)." {% endif %}For more information about deployments with the REST API, see "[Repositories](/rest/reference/repos#deployments)." + +To view current and past deployments, click **Environments** on the home page of your repository. ![Environments](/assets/images/environments-sidebar.png) + +The deployments page displays the last active deployment of each environment for your repository. If the deployment includes an environment URL, a "View deployment" button that links to the URL is shown next to the deployment. + +The activity log shows the deployment history for your environments. By default, only the most recent deployment for an environment has an `Active` status; all previously active deployments have an `Inactive` status. For more information on automatic inactivation of deployments, see "[Inactive deployments](/rest/reference/repos#inactive-deployments)." + +You can also use the REST API to get information about deployments. For more information, see "[Repositories](/rest/reference/repos#deployments)." 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 16c6a75b212f..8033e879d009 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 @@ -91,7 +91,7 @@ The base reference branch of the pull request changed. |:------------------------- |:----------------:|:-------------------:| |
    • Pull requests
    | **X** | | - ### Event object properties +#### Event object properties {% data reusables.issue-events.issue-event-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 558685831253..600e65ad1cfe 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 @@ -71,7 +71,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) 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 76ba712dae1f..b1a87ecbce39 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 @@ -430,7 +430,7 @@ When someone revokes their authorization of a {% data variables.product.prodname {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **Note:** {% data reusables.pre-release-program.suspend-installation-beta %} For more information, see "[Suspending a {% data variables.product.prodname_github_app %} installation](/apps/managing-github-apps/suspending-a-github-app-installation/)." @@ -715,7 +715,7 @@ The webhook this event is configured on was deleted. This event will only listen ### пакет -Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/rest/reference/orgs#blocking)" REST API. For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. +Activity related to {% data variables.product.prodname_registry %}. {% data reusables.webhooks.action_type_desc %} For more information, see "[Managing packages with {% data variables.product.prodname_registry %}](/github/managing-packages-with-github-packages)" to learn more about {% data variables.product.prodname_registry %}. #### Availability @@ -1125,9 +1125,11 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory Activity related to a security advisory. A security advisory provides information about security-related vulnerabilities in software on GitHub. The security advisory dataset also powers the GitHub security alerts, see "[About security alerts for vulnerable dependencies](/articles/about-security-alerts-for-vulnerable-dependencies/)." +{% endif %} #### Availability diff --git a/translations/ru-RU/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/ru-RU/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index f936e901cd9a..186988568e55 100644 --- a/translations/ru-RU/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/ru-RU/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -28,4 +28,4 @@ To create and access the feedback pull request, you must enable the feedback pul ### Дополнительная литература -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/ru-RU/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/ru-RU/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index eb64ed7324bb..528b85d164bf 100644 --- a/translations/ru-RU/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/ru-RU/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -18,7 +18,7 @@ To be eligible for the {% data variables.product.prodname_student_pack %}, you m - Have a [{% data variables.product.prodname_dotcom %} user account](/articles/signing-up-for-a-new-github-account) - Be at least 13 years old -Documents that prove your current student status include a picture of your school ID, class schedule, transcript, and affiliation or enrollment verification letter. +Documents that prove your current student status include a picture of your school ID with current enrollment date, class schedule, transcript, and affiliation or enrollment verification letter. During your tenure as a student, you may be prompted to periodically re-verify your current academic status. diff --git a/translations/ru-RU/content/github/administering-a-repository/about-protected-branches.md b/translations/ru-RU/content/github/administering-a-repository/about-protected-branches.md index 6af43716a00b..b6eec6faa9e3 100644 --- a/translations/ru-RU/content/github/administering-a-repository/about-protected-branches.md +++ b/translations/ru-RU/content/github/administering-a-repository/about-protected-branches.md @@ -11,12 +11,16 @@ versions: github-ae: '*' --- +### About protected branches + {% data reusables.pull_requests.about-protected-branches %} You can choose to enforce restrictions on how a pull request is merged into your repository. Repository owners and people with admin permissions for a repository can enforce certain workflows or requirements, before a collaborator can merge a branch in your repository by creating protected branch rules. {% data reusables.repositories.branch-rules-example %} For more information, see "[Configuring protected branches](/articles/configuring-protected-branches/)." +{% data reusables.pull_requests.you-can-auto-merge %} + ### Prioritization of protected branch rules If a repository has multiple protected branch rules that affect the same branches, the rules that include a specific branch name have the highest priority. If there is more than one protected branch rule that references the same specific branch name, then the branch rule created first will have higher priority. diff --git a/translations/ru-RU/content/github/administering-a-repository/configuring-pull-request-merges.md b/translations/ru-RU/content/github/administering-a-repository/configuring-pull-request-merges.md index 6a34fe2d0d6a..f42c9d2a9a30 100644 --- a/translations/ru-RU/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/ru-RU/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: Configuring pull request merges -intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history by enabling, disabling, or enforcing standard merge commits, squashed commits, or rebased commits on all pull requests in your repository.' +intro: 'You can configure pull request merges on {% data variables.product.product_location %} to match your workflow and preferences for managing Git history.' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 c3d2b35b549a..1f27602bae77 100644 --- a/translations/ru-RU/content/github/administering-a-repository/index.md +++ b/translations/ru-RU/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/ru-RU/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/ru-RU/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..e19203c0666a --- /dev/null +++ b/translations/ru-RU/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Managing auto-merge for pull requests in your repository +intro: "You can allow or disallow auto-merge for pull requests in your repository." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Under "Merge button", select or deselect **Allow auto-merge**. ![Checkbox to allow or disallow auto-merge](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file diff --git a/translations/ru-RU/content/github/administering-a-repository/setting-repository-visibility.md b/translations/ru-RU/content/github/administering-a-repository/setting-repository-visibility.md index 2a526a1b1270..08c5381597c7 100644 --- a/translations/ru-RU/content/github/administering-a-repository/setting-repository-visibility.md +++ b/translations/ru-RU/content/github/administering-a-repository/setting-repository-visibility.md @@ -24,7 +24,7 @@ We recommend reviewing the following caveats before you change the visibility of * 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. {% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %}The visibility of any forks will also change to private.{% elsif currentVersion == "github-ae@latest" %}If the internal repository has any forks, the visibility of the forks is already private.{% 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)"{% 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 %}{% endif %} * Any published {% data variables.product.prodname_pages %} site will be automatically unpublished.{% if currentVersion == "free-pro-team@latest" %} If you added a custom domain to the {% data variables.product.prodname_pages %} site, you should remove or update your DNS records before making the repository private, to avoid the risk of a domain takeover. For more information, see "[Managing a custom domain for your {% data variables.product.prodname_pages %} site](/articles/managing-a-custom-domain-for-your-github-pages-site)."{% endif %}{% if currentVersion == "free-pro-team@latest" %} -* {% 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 enterpriseServerVersions contains currentVersion %} +* {% data variables.product.prodname_dotcom %} will no longer include 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 enterpriseServerVersions contains currentVersion %} * 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 %} {% if currentVersion == "free-pro-team@latest" or currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.19" %} 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 f3d893dfa8aa..ee598ebab5df 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 @@ -38,7 +38,7 @@ When an {% data variables.product.prodname_oauth_app %} wants to identify you by *Scopes* are named groups of permissions that an {% data variables.product.prodname_oauth_app %} can request to access both public and non-public data. -When you want to use an {% data variables.product.prodname_oauth_app %} that integrates with {% data variables.product.product_name %}, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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)." +When you want to use an {% data variables.product.prodname_oauth_app %} that integrates with {% data variables.product.product_name %}, that app lets you know what type of access to your data will be required. If you grant access to the app, then the app will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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 %} 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 bfaf3ac73ed1..92789d6ecf6a 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 @@ -32,7 +32,7 @@ Applications can have *read* or *write* access to your {% data variables.product *Scopes* are named groups of permissions that an application can request to access both public and non-public data. -When you want to use a third-party application that integrates with {% data variables.product.product_name %}, that application lets you know what type of access to your data will be required. If you grant access to the application, then the application will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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)." +When you want to use a third-party application that integrates with {% data variables.product.product_name %}, that application lets you know what type of access to your data will be required. If you grant access to the application, then the application will be able to perform actions on your behalf, such as reading or modifying data. For example, if you want to use an app that requests `user:email` scope, the app will have read-only access to your private email addresses. 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 %} diff --git a/translations/ru-RU/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md b/translations/ru-RU/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md index 2a2c82754bf5..379980e4e7e1 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md +++ b/translations/ru-RU/content/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md @@ -127,7 +127,7 @@ Before adding a new SSH key to the ssh-agent to manage your keys, you should hav 1. Ensure the ssh-agent is running. You can use the "Auto-launching the ssh-agent" instructions in "[Working with SSH key passphrases](/articles/working-with-ssh-key-passphrases)", or start it manually: ```shell # start the ssh-agent in the background - $ eval $(ssh-agent -s) + $ eval `ssh-agent -s` > Agent pid 59566 ``` diff --git a/translations/ru-RU/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/ru-RU/content/github/authenticating-to-github/testing-your-ssh-connection.md index 12b3e26732f7..14137184345d 100644 --- a/translations/ru-RU/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/ru-RU/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -31,7 +31,7 @@ When you test your connection, you'll need to authenticate this action using you > Are you sure you want to continue connecting (yes/no)? ``` -3. Verify that the fingerprint in the message you see matches one of the messages in step 2, then type `yes`: +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Hi username! You've successfully authenticated, but GitHub does not > provide shell access. diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..378da8df6d57 --- /dev/null +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: Automatically merging a pull request +intro: 'You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### About auto-merge + +If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks. + +Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)." + +You can provide feedback about auto-merge by [contacting us](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback). + +### Enabling auto-merge + +People with write permissions to a repository can enable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to auto-merge. +1. Optionally, to choose a merge method, select the **Enable auto-merge** drop-down menu, then click a merge method. For more information, see "[About pull request merges](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)." !["Enable auto-merge" drop-down menu](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. Click **Enable auto-merge**. ![Button to enable auto-merge](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. If you chose the merge or squash and merge methods, type a commit message and description and choose the email address you want to author the merge commit. ![Fields to enter commit message and description and choose commit author email](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. Click **Confirm auto-merge**. ![Button to confirm auto-merge](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### Disabling auto-merge + +People with write permissions to a repository and pull request authors can disable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to disable auto-merge for. +1. In the merge box, click **Disable auto-merge**. ![Button to disable auto-merge](/assets/images/help/pull_requests/disable-auto-merge-button.png) diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md index ddfe6b795d8c..7b648d986052 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork.md @@ -3,7 +3,7 @@ title: Creating a pull request from a fork intro: You can create a pull request to propose changes you've made to a fork of an upstream repository. redirect_from: - /articles/creating-a-pull-request-from-a-fork -permissions: Anyone with write access to a repository can create a pull request from user-owned fork. +permissions: Anyone with write access to a repository can create a pull request from a user-owned fork. versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/index.md index ae4915c00270..1e666ca019af 100644 --- a/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/ru-RU/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 0320810e560a..2bf18ecfac07 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 @@ -14,6 +14,8 @@ versions: In a pull request, you propose that changes you've made on a head branch should be merged into a base branch. {% data reusables.pull_requests.about-protected-branches %} However, there may be restrictions on when you can merge a pull request into a specific branch. For example, you may only be able to merge a pull request into the default branch if required status checks are passing. For more information, see "[About protected branches](/github/administering-a-repository/about-protected-branches)." +{% data reusables.pull_requests.you-can-auto-merge %} + If the pull request has merge conflicts, or if you'd like to test the changes before merging, you can [check out the pull request locally](/articles/checking-out-pull-requests-locally) and merge it using the command line. You can't merge a draft pull request. For more information about draft pull requests, see "[About pull requests](/articles/about-pull-requests#draft-pull-requests)." 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 84f7b31d9f95..75ca96266658 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 @@ -294,7 +294,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Accessing private repositories -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)." +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 `ghost/foo`, `ghost/bar`, and `ghost/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. 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 index 1a1c57500250..39f1264f5e8c 100644 --- 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 @@ -54,7 +54,7 @@ On Windows, the `codeql-runner-win.exe` file usually requires no change to permi 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 +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux chmod +x codeql-runner-linux ``` @@ -129,7 +129,7 @@ This example is similar to the previous example, however this time the repositor > ... > 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 " + Please export these variables to future processes so that CodeQL can monitor the build, for example by running " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` diff --git a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md index 4cb5408b6384..66278fee4464 100644 --- a/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md +++ b/translations/ru-RU/content/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions.md @@ -11,7 +11,7 @@ To help you understand your subscriptions and decide whether to unsubscribe, see {% note %} -**Note:** Instead of unsubscribing, you have the option to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% 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 %} +**Note:** Instead of unsubscribing, you have the option to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% if currentVersion == "free-pro-team@latest" %}If you're experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 7d40c84e9d50..850e89fb1cdc 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 @@ -33,7 +33,7 @@ You can also watch and unwatch releases in a repository. For more information, s {% note %} -**Note:** You can also choose to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% 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 %} +**Note:** You can also choose to ignore a repository. If you ignore a repository, you won't receive any notifications. We don't recommend ignoring repositories as you won't be notified if you're @mentioned. {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} diff --git a/translations/ru-RU/content/github/searching-for-information-on-github/searching-code.md b/translations/ru-RU/content/github/searching-for-information-on-github/searching-code.md index 288cc76d9139..beaa5333d113 100644 --- a/translations/ru-RU/content/github/searching-for-information-on-github/searching-code.md +++ b/translations/ru-RU/content/github/searching-for-information-on-github/searching-code.md @@ -27,7 +27,8 @@ Due to the complexity of searching code, there are some restrictions on how sear - Only the _default branch_ is indexed for code search.{% if currentVersion == "free-pro-team@latest" %} - Only files smaller than 384 KB are searchable.{% else %}* Only files smaller than 5 MB are searchable. - Only the first 500 KB of each file is searchable.{% endif %} -- Only repositories with fewer than 500,000 files are searchable. +- Only repositories with fewer than 500,000 files are searchable.{% if currentVersion == "free-pro-team@latest" %} +- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} - Except with [`filename`](#search-by-filename) searches, you must always include at least one search term when searching source code. For example, searching for [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) is not valid, while [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) is. - At most, search results can show two fragments from the same file, but there may be more results within the file. - You can't use the following wildcard characters as part of your search query: . , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. The search will simply ignore these symbols. 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 a71187af6e02..45c69b63f110 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 @@ -39,6 +39,7 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late | 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** | | | +| Restrict email notifications to verified domains (see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-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** | | 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 48439b250731..96c038aaae11 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 @@ -60,7 +60,8 @@ In addition to managing organization-level settings, organization owners have ad | [Report abusive or spammy content](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} | Apply labels | | **X** | **X** | **X** | **X** | | Create, edit, delete labels | | | **X** | **X** | **X** | -| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** | +| Close, reopen, and assign all issues and pull requests | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Enable and disable auto-merge on a pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | 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** | diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md index 1390c58840de..6e0924546a21 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain.md @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -When restricted email notifications are enabled in an organization, members can only receive email notifications about organization activity at an email address associated with the organization's verified domain. For more information, see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)." +### About email restrictions + +When restricted email notifications are enabled in an organization, members can only use an email address associated with the organization's verified domains to receive email notifications about organization activity. For more information, see "[Verifying your organization's domain](/articles/verifying-your-organization-s-domain)." Outside collaborators are not subject to restrictions on email notifications for verified domains. For more information on outside collaborators, see "[Permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)." +If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +### Restricting email notifications to an approved domain + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. Under "Enforcement preferences", select **Restrict email notifications to domain email**. ![Checkbox to restrict email notifications to verified domain emails](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. Click **Save**. diff --git a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index 9bef1adc2503..335556dcc858 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### About domain verification + To verify domains on {% data variables.product.product_name %}, you must have owner permissions in the organization. For more information, see "[Permission levels for an organization](/articles/permission-levels-for-an-organization)." You will also need access to modify domain records with your domain hosting service. After verifying ownership of your organization's domains, a "Verified" badge will display on the organization's profile. If your organization is on {% data variables.product.prodname_ghe_cloud %} and has agreed to the Corporate Terms of Service, organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. For more information, see "[About your organization's profile page](/articles/about-your-organization-s-profile/)" and "[Upgrading to the Corporate Terms of Service](/articles/upgrading-to-the-corporate-terms-of-service)." -To display a "Verified" badge, the website and email information shown on your organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. - -{% note %} - -**Note:** If the email address and website shown on your organization's profile use variants of the same domain, you must verify both variants. For example, if your organization's profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. +If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." -{% endnote %} +{% data reusables.organizations.verified-domains-details %} On {% data variables.product.prodname_ghe_cloud %}, after verifying ownership of your organization's domain, you can restrict email notifications for the organization to that domain. For more information, see "[Restricting email notifications to an approved domain](/articles/restricting-email-notifications-to-an-approved-domain)." +### Verifying your organization's domain + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. Click **Add a domain**. ![Add a domain button](/assets/images/help/organizations/add-a-domain-button.png) -6. In the domain field, type the domain you'd like to verify, then click **Add domain**. ![Add a domain field](/assets/images/help/organizations/add-domain-field.png) -7. Follow the instructions under **Add a DNS TXT record** to create a DNS TXT record with your domain hosting service. It may take up to 72 hours for your DNS configuration to change. Once your DNS configuration has changed, continue to the next step. ![Instructions to create a DNS txt record](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **Tip:** You can confirm your DNS configuration has changed by running the `dig` command on the command line. In the example command, replace `ORGANIZATION` with the name of your organization, and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ORGANIZATION` with the name of your organization and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - 8. After confirming your TXT record is added to your DNS, navigate to the Verified domains tab in your organization's settings. You can follow steps one through four above to locate the Verified domains tab. ![Verified domains settings page with pending domain](/assets/images/help/organizations/pending-domain-verification.png) -9. Next to the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Continue verifying domain button](/assets/images/help/organizations/continue-verifying-domain.png) -10. Click **Verify domain**. ![Verify domain button](/assets/images/help/organizations/verify-domain-final-button.png) +{% data reusables.organizations.continue-verifying-domain %} 11. Optionally, once the "Verified" badge is visible on your organization's profile page, you can delete the TXT entry from the DNS record at your domain hosting service. ![Verified badge](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/index.md index 54e9cb224115..6d144e7ecc7d 100644 --- a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..e02bb0e7c057 --- /dev/null +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restricting email notifications for your enterprise account to approved domains +intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can restrict email notifications for an enterprise account. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About email restrictions for your enterprise account + +When you restrict email notifications to verified domains, enterprise members can only use an email address associated with a verified domain to receive email notifications about activity in organizations owned by your enterprise account. The domains can be inherited from the enterprise account or configured for the specific organization. For more information about email restrictions for organizations, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +If email restrictions are enabled for an enterprise account, organization owners cannot disable email restrictions for any organization owned by the enterprise account. If changes occur that result in an organization having no verified domains, either inherited from an enterprise account that owns the organization or for the specific organization, email restrictions will be disabled for the organization. + +### Restricting email notifications for your enterprise account + +Before you can restrict email notifications for your enterprise account, you must verify at least one domain for the enterprise account. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. Click **Save**. diff --git a/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..54f209077175 --- /dev/null +++ b/translations/ru-RU/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verifying your enterprise account's domain +intro: 'You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can verify an enterprise account's domain. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About domain verification + +You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. For more information, see "[Verifying your organization's domain](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)." + +After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. {% data reusables.organizations.verified-domains-details %} + +Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. + +After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "[Restricting email notifications for your enterprise account to approved domains](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)." + +Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +### Verifying your enterprise account's domain + +To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. Click **Add a domain**. ![Add a domain button](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ENTERPRISE-ACCOUNT` with the name of your enterprise account, and `example.com` with the domain you'd like to verify. You should see your new TXT record listed in the command output. + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. ![Verified badge](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 010c18a45076..53e3c3a3d6be 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 @@ -46,7 +46,8 @@ The repository owner has full control of the repository. In addition to the acti | Define code owners for the repository | "[About code owners](/github/creating-cloning-and-archiving-repositories/about-code-owners)" | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Create security advisories | "[About {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| Действие | More information | -|:----------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Fork the repository | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | "[Creating and editing milestones for issues and pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | "[Creating a pull request from a fork](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | -| Submit a review on a pull request that affects the mergeability of the pull request | "[Reviewing proposed changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | -| Create and edit a wiki for the repository | "[About wikis](/github/building-a-strong-community/about-wikis)" | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| Действие | More information | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Fork the repository | "[About forks](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | "[Creating and editing milestones for issues and pull requests](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | "[Creating a pull request from a fork](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | +| Submit a review on a pull request that affects the mergeability of the pull request | "[Reviewing proposed changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | +| Create and edit a wiki for the repository | "[About wikis](/github/building-a-strong-community/about-wikis)" | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| Remove themselves as collaborators on the repository | "[Removing yourself from a collaborator's repository](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | +| Remove themselves as collaborators on the repository | "[Removing yourself from a collaborator's repository](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | ### Дополнительная литература diff --git a/translations/ru-RU/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md b/translations/ru-RU/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md index 52a69a7135ca..70d4eb12aa38 100644 --- a/translations/ru-RU/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md +++ b/translations/ru-RU/content/github/site-policy/github-insights-and-data-protection-for-your-organization.md @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} analyzes your {% data var product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- For more information about the terms that govern {% data variables.product.prodname_insights %}, see your {% data variables.product.prodname_ghe_one %} subscription agreement. diff --git a/translations/ru-RU/content/github/site-policy/github-marketplace-developer-agreement.md b/translations/ru-RU/content/github/site-policy/github-marketplace-developer-agreement.md index 3843400e3436..194f8f263f26 100644 --- a/translations/ru-RU/content/github/site-policy/github-marketplace-developer-agreement.md +++ b/translations/ru-RU/content/github/site-policy/github-marketplace-developer-agreement.md @@ -8,7 +8,7 @@ versions: **THESE TERMS AND CONDITIONS (THE "AGREEMENT") GOVERN YOUR PARTICIPATION IN GITHUB’S MARKETPLACE PROGRAM. BY ENROLLING TO PARTICIPATE IN THE MARKETPLACE PROGRAM OR BY CLICKING “I ACCEPT” BELOW, YOU ARE CONFIRMING THAT YOU UNDERSTAND THIS AGREEMENT, AND THAT YOU ACCEPT ALL OF ITS TERMS AND CONDITIONS. IF YOU ARE ENTERING INTO THIS AGREEMENT ON BEHALF OF A COMPANY OR OTHER LEGAL ENTITY, YOU REPRESENT THAT YOU HAVE THE LEGAL AUTHORITY TO BIND THE ENTITY TO THIS AGREEMENT, IN WHICH CASE “YOU” WILL MEAN THE ENTITY YOU REPRESENT.** -Effective Date: July 21, 2020 +Effective Date: January 1, 2021 ### 1. DEFINITIONS @@ -143,7 +143,7 @@ In the event that your Listing is involuntarily removed because it is defective, **6.1** GitHub will be the merchant of record for Developer Products purchased by End Users via Marketplace. -**6.2** Prices for Marketplace Listings of Developer Applications will be set in US Dollars (USD). Developer has complete control over setting pricing for each Listing, and once set, such pricing cannot be changed. You may retire a pricing plan for an existing Listing and add a new pricing plan for such Listing, provided that such new pricing plan shall not negatively impact existing End Users. The prices you set for Developer Products will determine the amount of payment you will receive. GitHub will remit 75% of the sale price in USD without reduction for Taxes except for any withholding taxes that are required under applicable law. The remaining 25% of the sales price will be allotted to and retained by GitHub. At the end of each month and upon reaching a minimum value of $500 USD, GitHub will remit your share of payments. +**6.2** Prices for Marketplace Listings of Developer Applications will be set in US Dollars (USD). Developer has complete control over setting pricing for each Listing, and once set, such pricing cannot be changed. You may retire a pricing plan for an existing Listing and add a new pricing plan for such Listing, provided that such new pricing plan shall not negatively impact existing End Users. The prices you set for Developer Products will determine the amount of payment you will receive. GitHub will remit 95% of the sale price in USD without reduction for Taxes except for any withholding taxes that are required under applicable law. The remaining 5% of the sales price will be allotted to and retained by GitHub. At the end of each month and upon reaching a minimum value of $500 USD, GitHub will remit your share of payments. **6.3** Refund Requirements. You will be responsible for specifying the terms and conditions regarding refunds to your End Users. In no event shall GitHub be responsible for providing any support for refunds, nor shall GitHub be liable for payment of any refund. @@ -169,7 +169,7 @@ UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY (WHETHER IN CONTRACT, TORT, NEG **10.3** GitHub may terminate this Agreement at any time if (a) you have breached any provision of this Agreement or (b) GitHub is required to do so by law. -**10.4** Effects of Termination by Developer. Upon receiving forty-five (45) days’ advanced written notice of termination from Developer, Developer will be disabled from taking on new customers via Marketplace. Any outstanding fees shall be remitted upon termination and removal of the Developer Product from Marketplace. If termination is initiated as a result of a GitHub modication to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. +**10.4** Effects of Termination by Developer. Upon receiving forty-five (45) days’ advanced written notice of termination from Developer, Developer will be disabled from taking on new customers via Marketplace. Any outstanding fees shall be remitted upon termination and removal of the Developer Product from Marketplace. If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** The obligations in Sections 2, 3, 4, 5, 8, 9 and 12-18 will survive any expiration or termination of this Agreement. 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 e94a3e5eb40c..59d15bff981d 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 @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -Effective date: November 16, 2020 +Effective date: December 19, 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. @@ -26,24 +26,24 @@ Of course, the short version and the Summary below don't tell you everything, so ### Summary -| Section | What can you find there? | -| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| [What information GitHub collects](#what-information-github-collects) | GitHub collects information directly from you for your registration, payment, transactions, and user profile. We also automatically collect from you your usage information, cookies and similar technologies, and device information, subject, where necessary, to your consent. GitHub may also collect User Personal Information from third parties. We only collect the minimum amount of personal information necessary from you, unless you choose to provide more. | -| [What information GitHub does _not_ collect](#what-information-github-does-not-collect) | We don’t knowingly collect information from children under 13, and we don’t collect [Sensitive Personal Information](https://gdpr-info.eu/art-9-gdpr/). | -| [How GitHub uses your information](#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. We also describe the legal basis upon which we process your information, where legally required. | -| [How we share the information we collect](#how-we-share-the-information-we-collect) | We may share your information with third parties under one of the following circumstances: with your consent, with our service providers, for security purposes, to comply with our legal obligations, or when there is a change of control or sale of corporate entities or business units. We do not sell your personal information and we do not host advertising on GitHub. You can see a list of the service providers that access your information. | -| [Other important information](#other-important-information) | We provide additional information specific to repository contents, public information, and Organizations on GitHub. | -| [Additional services](#additional-services) | We provide information about additional service offerings, including third-party applications, GitHub Pages, and GitHub applications. | -| [How you can access and control the information we collect](#how-you-can-access-and-control-the-information-we-collect) | We provide ways for you to access, alter, or delete your personal information. | -| [Our use of cookies and tracking](#our-use-of-cookies-and-tracking) | We use cookies for the overall functionality of our Website, and we use a small number of tracking and analytics services on a few parts of our site. We offer a page that makes this very transparent. Please see this section for more information. | -| [How GitHub secures your information](#how-github-secures-your-information) | We take all measures reasonably necessary to protect the confidentiality, integrity, and availability of your personal information on GitHub and to protect the resilience of our servers. | -| [GitHub's global privacy practices](#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](#how-we-communicate-with-you) | We communicate with you by email. You can control the way we contact you in your account settings, or by contacting us. | -| [Resolving complaints](#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](#changes-to-our-privacy-statement) | We notify you of material changes to this Privacy Statement 30 days before any such changes become effective. You may also track changes in our Site Policy repository. | -| [Лицензия](#license) | This Privacy Statement is licensed under the [Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/). | -| [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. | +| Section | What can you find there? | +| ----------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| [What information GitHub collects](#what-information-github-collects) | GitHub collects information directly from you for your registration, payment, transactions, and user profile. We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. GitHub may also collect User Personal Information from third parties. We only collect the minimum amount of personal information necessary from you, unless you choose to provide more. | +| [What information GitHub does _not_ collect](#what-information-github-does-not-collect) | We don’t knowingly collect information from children under 13, and we don’t collect [Sensitive Personal Information](https://gdpr-info.eu/art-9-gdpr/). | +| [How GitHub uses your information](#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. We also describe the legal basis upon which we process your information, where legally required. | +| [How we share the information we collect](#how-we-share-the-information-we-collect) | We may share your information with third parties under one of the following circumstances: with your consent, with our service providers, for security purposes, to comply with our legal obligations, or when there is a change of control or sale of corporate entities or business units. We do not sell your personal information and we do not host advertising on GitHub. You can see a list of the service providers that access your information. | +| [Other important information](#other-important-information) | We provide additional information specific to repository contents, public information, and Organizations on GitHub. | +| [Additional services](#additional-services) | We provide information about additional service offerings, including third-party applications, GitHub Pages, and GitHub applications. | +| [How you can access and control the information we collect](#how-you-can-access-and-control-the-information-we-collect) | We provide ways for you to access, alter, or delete your personal information. | +| [Our use of cookies and tracking](#our-use-of-cookies-and-tracking) | We only use strictly necessary cookies to provide, secure and improve our service. We offer a page that makes this very transparent. Please see this section for more information. | +| [How GitHub secures your information](#how-github-secures-your-information) | We take all measures reasonably necessary to protect the confidentiality, integrity, and availability of your personal information on GitHub and to protect the resilience of our servers. | +| [GitHub's global privacy practices](#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](#how-we-communicate-with-you) | We communicate with you by email. You can control the way we contact you in your account settings, or by contacting us. | +| [Resolving complaints](#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](#changes-to-our-privacy-statement) | We notify you of material changes to this Privacy Statement 30 days before any such changes become effective. You may also track changes in our Site Policy repository. | +| [Лицензия](#license) | This Privacy Statement is licensed under the [Creative Commons Zero license](https://creativecommons.org/publicdomain/zero/1.0/). | +| [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 @@ -74,8 +74,8 @@ If you have a paid Account with us, sell an application listed on [GitHub Market ##### Usage information If you're accessing our Service or Website, we automatically collect the same basic information that most services collect, subject, where necessary, to your consent. This includes information about how you use the Service, such as the pages you view, the referring site, your IP address and session information, and the date and time of each request. This is information we collect from every visitor to the Website, whether they have an Account or not. This information may include User Personal information. -##### Cookies and similar technologies information -As further described below, and subject, where applicable, to your consent, we automatically collect information from cookies and similar technologies (such as cookie ID and settings) to keep you logged in, to remember your preferences, and to identify you and your device. +##### Cookies +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### Device information We may collect certain information about your device, such as its IP address, browser or client application information, language preference, operating system and application version, device type and ID, and device model and manufacturer. This information may include User Personal information. @@ -235,15 +235,17 @@ That said, the email address you have supplied [via your Git commit settings](/g #### Cookies -GitHub uses cookies and similar technologies (e.g., HTML5 localStorage) 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 (hereafter collectively "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. +GitHub only uses strictly necessary cookies. Cookies are small text files that websites often store on computer hard drives or mobile devices of visitors. -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 use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### Tracking and analytics +By using our service, 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 our service. -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. +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). -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. +#### DNT + +"[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://privacybadger.org/). ### How GitHub secures your information 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 47eab52828d7..23e97cf6a38c 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,9 +10,9 @@ versions: free-pro-team: '*' --- -Effective date: **October 2, 2020** +Effective date: **December 30, 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). +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), and how we use [cookies](#cookies-on-github). ### GitHub Subprocessors @@ -29,14 +29,13 @@ When we share your information with third party subprocessors, such as our vendo | Eloqua | Marketing campaign automation | United States | United States | | Google Apps | Internal company infrastructure | United States | United States | | Google Analytics | Analytics and performance | United States | United States | -| LinkedIn Navigator | Marketing data enrichment service | United States | United States | +| LinkedIn Navigator | 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 | | Mailgun | Transactional mail services provider | United States | United States | | Microsoft | Microsoft Services | United States | United States | | Monday.com | Team collaboration and project management platform | United States | Israel | | Nexmo | SMS notification provider | United States | United States | -| Oracle | Corporate financial system | United States | United States | | Salesforce.com | Customer relations management | United States | United States | | Sendgrid | Transactional mail services provider | United States | United States | | Sentry.io | Application monitoring provider | United States | United States | @@ -49,49 +48,35 @@ When we bring on a new subprocessor who handles our Users' Personal Information, ### Cookies on GitHub -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. +GitHub uses 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 | +| 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 | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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 for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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 us to customize timestamps to your time zone. | сессия | +| GitHub | `user_session` | This cookie is used to log you in. | two weeks | _*_ 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 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. +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, 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. diff --git a/translations/ru-RU/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md b/translations/ru-RU/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md index 57ba08fe00a8..8f50e7c5d406 100644 --- a/translations/ru-RU/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md +++ b/translations/ru-RU/content/github/site-policy/guidelines-for-legal-requests-of-user-data.md @@ -163,8 +163,6 @@ c/o Corporation Service Company Sacramento, CA 95833-3505 ``` -You may also send a courtesy copy to legal@support.github.com. - Please make your requests as specific and narrow as possible, including the following information: - Full information about authority issuing the request for information 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 d38bb7fe2f18..ef8b7130fca1 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 @@ -39,12 +39,6 @@ If vulnerabilities have been detected in the repository, these are shown at the 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_alerts %}. -{% note %} - -**Note:** {% data variables.product.prodname_ghe_server %} does not populate the **Dependents** view. - -{% endnote %} - ![График зависимостей](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ Any direct and indirect dependencies that are specified in the repository's mani {% if enterpriseServerVersions contains currentVersion 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. - -{% endnote %} - ![График зависимостей](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,6 +81,24 @@ You can also enable or disable the dependency graph for all repositories owned b 4. Read the message about granting {% data variables.product.product_name %} read-only access to the repository data to enable the dependency graph, then next to "Dependency Graph", click **Enable**. !["Enable" button for the dependency graph](/assets/images/help/repository/dependency-graph-enable-button.png) You can disable the dependency graph at any time by clicking **Disable** next to "Dependency Graph" on the Security & analysis tab. + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} ### Troubleshooting the dependency graph 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 a69af846c4b0..2ca852866d0d 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,8 +40,9 @@ 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` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% 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 @@ -72,6 +73,8 @@ To set up an apex domain, such as `example.com`, you must configure a _CNAME_ fi 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. To confirm that your DNS record configured correctly, use the `dig` command, replacing _EXAMPLE.COM_ with your apex domain. Confirm that the results match the IP addresses for {% data variables.product.prodname_pages %} above. ```shell diff --git a/translations/ru-RU/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/ru-RU/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index cf13090436ee..132048eabb99 100644 --- a/translations/ru-RU/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/ru-RU/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -39,11 +39,7 @@ Make sure your site does not: - Use more than one `www` subdomain. For example, both `www.example.com` and `www.anotherexample.com`. - Use both an apex domain and custom subdomain. For example, both `example.com` and `docs.example.com`. -{% warning %} - -**Warning:** We strongly recommend not using wildcard DNS records, such as `*.example.com`. A wildcard DNS record will allow anyone to host a {% data variables.product.prodname_pages %} site at one of your subdomains. - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} For a list of supported custom domains, see "[About custom domains and {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages/#supported-custom-domains)." diff --git a/translations/ru-RU/content/graphql/overview/resource-limitations.md b/translations/ru-RU/content/graphql/overview/resource-limitations.md index d0714a5d93c8..e7e574bb2f5f 100644 --- a/translations/ru-RU/content/graphql/overview/resource-limitations.md +++ b/translations/ru-RU/content/graphql/overview/resource-limitations.md @@ -117,7 +117,7 @@ These two examples show how to calculate the total nodes in a call. = 22,060 total nodes -### Rate limit +## Rate limit The GraphQL API v4 limit is different from the REST API v3's [rate limits](/rest/overview/resources-in-the-rest-api#rate-limiting). @@ -130,12 +130,6 @@ To accurately represent the server cost of a query, the GraphQL API v4 calculate The GraphQL API v4 rate limit is **5,000 points per hour**. -{% if currentVersion == "free-pro-team@latest" %} - -For {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s that belong to a {% data variables.product.prodname_ghe_cloud %} account, requests to resources owned by the same {% data variables.product.prodname_ghe_cloud %} account have an increased limit of 15,000 points per hour. - -{% endif %} - Note that 5,000 points per hour is not the same as 5,000 calls per hour: the GraphQL API v4 and REST API v3 use different rate limits. {% note %} diff --git a/translations/ru-RU/content/graphql/reference/enums.md b/translations/ru-RU/content/graphql/reference/enums.md index f87cc2e4ccd3..50ff25548cab 100644 --- a/translations/ru-RU/content/graphql/reference/enums.md +++ b/translations/ru-RU/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: Enums redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/input-objects.md b/translations/ru-RU/content/graphql/reference/input-objects.md index 423c6511c8b7..ad927ff2bbd6 100644 --- a/translations/ru-RU/content/graphql/reference/input-objects.md +++ b/translations/ru-RU/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: Input objects redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/interfaces.md b/translations/ru-RU/content/graphql/reference/interfaces.md index bfc411d7967c..492e7b535c62 100644 --- a/translations/ru-RU/content/graphql/reference/interfaces.md +++ b/translations/ru-RU/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: Interfaces redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/mutations.md b/translations/ru-RU/content/graphql/reference/mutations.md index e42955c3d30c..387dcd51ac14 100644 --- a/translations/ru-RU/content/graphql/reference/mutations.md +++ b/translations/ru-RU/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: Mutations redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/objects.md b/translations/ru-RU/content/graphql/reference/objects.md index 345786d5e1fc..7872b01baa65 100644 --- a/translations/ru-RU/content/graphql/reference/objects.md +++ b/translations/ru-RU/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: Objects redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/queries.md b/translations/ru-RU/content/graphql/reference/queries.md index a2cc6af7b152..48b714cd4b40 100644 --- a/translations/ru-RU/content/graphql/reference/queries.md +++ b/translations/ru-RU/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: Queries miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/scalars.md b/translations/ru-RU/content/graphql/reference/scalars.md index 338b4f42c7ee..2863a61f0de0 100644 --- a/translations/ru-RU/content/graphql/reference/scalars.md +++ b/translations/ru-RU/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: Scalars redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/graphql/reference/unions.md b/translations/ru-RU/content/graphql/reference/unions.md index 5a87c63fc0a6..2c9b6a786244 100644 --- a/translations/ru-RU/content/graphql/reference/unions.md +++ b/translations/ru-RU/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: Unions redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index c24e22c540fe..f77d29bec8e4 100644 --- a/translations/ru-RU/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/ru-RU/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ You can choose which contributors are included in metrics and create teams of co ### Дополнительная литература - "[Metrics available with {% data variables.product.prodname_insights %}](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" \ No newline at end of file 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 60502e4eff9b..2a9ef548cff5 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 @@ -99,4 +99,4 @@ To configure {% data variables.product.prodname_insights %} to connect to {% dat ### Дополнительная литература - "[Managing repositories](/insights/installing-and-configuring-github-insights/managing-repositories)" -- "[{% data variables.product.prodname_insights %} and data protection for your organization](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- "{% data variables.product.prodname_insights %} and data protection for your organization" diff --git a/translations/ru-RU/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/ru-RU/content/packages/guides/configuring-npm-for-use-with-github-packages.md index 838e7835cbf4..e986d3d16cdd 100644 --- a/translations/ru-RU/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/ru-RU/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: {% data reusables.package_registry.admins-can-configure-package-types %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### Limits for published npm versions + +If you publish over 1,000 npm package versions to {% data variables.product.prodname_registry %}, you may see performance issues and timeouts occur during usage. + +To reduce the number of versions you have published for your npm package, consider deleting package versions. For more information, see "[Deleting a package](/packages/manage-packages/deleting-a-package)." + +In the future, {% data variables.product.company_short %} will enforce a hard limit on publishing more than 1,000 versions of an npm package. When we start enforcing the 1,000 versions limit for each npm package hosted on {% data variables.product.prodname_registry %}, we will offer more guidance on how to manage your package versions. + +{% endif %} + ### Authenticating to {% data variables.product.prodname_registry %} {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/ru-RU/content/packages/guides/deleting-a-container-image.md b/translations/ru-RU/content/packages/guides/deleting-a-container-image.md index 33451deeaa34..e3e6c5254f83 100644 --- a/translations/ru-RU/content/packages/guides/deleting-a-container-image.md +++ b/translations/ru-RU/content/packages/guides/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 %}.' +intro: 'You can delete a specific version or all versions of a private or public container image on {% data variables.product.prodname_dotcom %}.' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ When deleting public packages, be aware that you may break projects that depend ### Deleting a version of a user-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image, you can use these steps. To delete an entire package, see "[Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-a-user-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-user-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### Deleting a version of an organization-owned container image on {% data variables.product.prodname_dotcom %} +To only delete specific versions of a container image that you have admin , you can use these steps. To delete an entire package, see "[Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %}](#deleting-all-versions-of-an-organization-owned-container-image-on-github)." + {% data reusables.package_registry.package-settings-from-org-level %} 5. On the left, click **Manage versions**. -5. To the right of the version you want to delete, click **Delete**. ![Delete package button](/assets/images/help/package-registry/delete-package-button.png) -6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-package-deletion.png) +6. Optionally, to ensure you're seeing all of your package versions, use the "Type" drop down menu and select **All**. ![Package version type drop down menu showing option to list all versions](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. To the right of the version you want to delete, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} and select **Delete version**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-version.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this version**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### Deleting all versions of a user-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-user-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package version button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package version deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### Deleting all versions of an organization-owned container image on {% data variables.product.prodname_dotcom %} + +{% data reusables.package_registry.package-settings-from-org-level %} +5. On the left, click **Options**. !["Options" menu option](/assets/images/help/package-registry/options-for-container-settings.png) +6. Under "Danger zone", click **Delete this package**. ![Delete package button](/assets/images/help/package-registry/delete-container-package-button.png) +6. To confirm deletion, type the package name and click **I understand the consequences, delete this package**. ![Confirm package deletion button](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/ru-RU/content/packages/index.md b/translations/ru-RU/content/packages/index.md index c40765a9dc5d..1defcebba01f 100644 --- a/translations/ru-RU/content/packages/index.md +++ b/translations/ru-RU/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: + - + title: ghcr.io container names redirect to the container page + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: Filter for tagged and untagged containers + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ - title: Packages container support is an opt-in beta date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: Organization admins access to containers - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: Packages now respects IP allow list settings - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/ru-RU/content/rest/overview/libraries.md b/translations/ru-RU/content/rest/overview/libraries.md index c44db06aa8ed..6f14bb96cf5d 100644 --- a/translations/ru-RU/content/rest/overview/libraries.md +++ b/translations/ru-RU/content/rest/overview/libraries.md @@ -7,6 +7,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
    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 c01a946b0036..5a1540afd366 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 @@ -41,8 +41,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -214,7 +215,7 @@ All error objects have resource and field properties so that your client can tel | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------- | | `missing` | A resource does not exist. | | `missing_field` | A required field on a resource has not been set. | -| `invalid` | The formatting of a field is invalid. Review the documentation for the for more specific information. | +| `invalid` | The formatting of a field is invalid. Review the documentation for more specific information. | | `already_exists` | Another resource has the same value as this field. This can happen in resources that must have some unique key (such as label names). | | `unprocessable` | The inputs provided were invalid. | @@ -235,14 +236,14 @@ Other redirection status codes may be used in accordance with the HTTP 1.1 spec. Where possible, API v3 strives to use appropriate HTTP verbs for each action. -| Verb | Description | -| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `HEAD` | Can be issued against any resource to get just the HTTP header info. | -| `GET` | Used for retrieving resources. | -| `POST` | Used for creating resources. | -| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A PATCH request may accept one or more of the attributes to update the resource. PATCH is a relatively new and uncommon HTTP verb, so resource endpoints also accept `POST` requests. | -| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | -| `DELETE` | Used for deleting resources. | +| Verb | Description | +| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `HEAD` | Can be issued against any resource to get just the HTTP header info. | +| `GET` | Used for retrieving resources. | +| `POST` | Used for creating resources. | +| `PATCH` | Used for updating resources with partial JSON data. For instance, an Issue resource has `title` and `body` attributes. A `PATCH` request may accept one or more of the attributes to update the resource. | +| `PUT` | Used for replacing resources or collections. For `PUT` requests with no `body` attribute, be sure to set the `Content-Length` header to zero. | +| `DELETE` | Used for deleting resources. | ### Hypermedia diff --git a/translations/ru-RU/content/rest/reference/enterprise-admin.md b/translations/ru-RU/content/rest/reference/enterprise-admin.md index 9325448ec87d..f96f91796ecb 100644 --- a/translations/ru-RU/content/rest/reference/enterprise-admin.md +++ b/translations/ru-RU/content/rest/reference/enterprise-admin.md @@ -40,7 +40,7 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### Authentication -Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** (which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} OAuth tokens must have the `site_admin` [OAuth scope](/developers/apps/scopes-for-oauth-apps#available-scopes) when used with Enterprise-specific endpoints.{% endif %} +Your {% data variables.product.product_name %} installation's API endpoints accept [the same authentication methods](/rest/overview/resources-in-the-rest-api#authentication) as the GitHub.com API. You can authenticate yourself with **[OAuth tokens](/apps/building-integrations/setting-up-and-registering-oauth-apps/)** {% if enterpriseServerVersions contains currentVersion %}(which can be created using the [Authorizations API](/rest/reference/oauth-authorizations#create-a-new-authorization)) {% endif %}or **[basic authentication](/rest/overview/resources-in-the-rest-api#basic-authentication)**. {% if enterpriseServerVersions contains currentVersion %} 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 administration API endpoints are only accessible to authenticated {% data variables.product.product_name %} site administrators{% if enterpriseServerVersions contains currentVersion %}, except for the [Management Console](#management-console) API, which requires the [Management Console password](/enterprise/admin/articles/accessing-the-management-console/){% endif %}. 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 787917734ecd..5c0aec4d8bcd 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 @@ -135,12 +135,12 @@ _Поиск_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _Assignees_ _События_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _Labels_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) diff --git a/translations/ru-RU/data/release-notes/2-20/23.yml b/translations/ru-RU/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..bde9f73982f7 --- /dev/null +++ b/translations/ru-RU/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ru-RU/data/release-notes/2-21/14.yml b/translations/ru-RU/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..97d5bac00ab3 --- /dev/null +++ b/translations/ru-RU/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/ru-RU/data/release-notes/2-22/6.yml b/translations/ru-RU/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..971924052fb5 --- /dev/null +++ b/translations/ru-RU/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/ru-RU/data/reusables/actions/environments-beta.md b/translations/ru-RU/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/ru-RU/data/reusables/actions/forked-secrets.md b/translations/ru-RU/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..600bc85a9587 --- /dev/null +++ b/translations/ru-RU/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +With the exception of `GITHUB_TOKEN`, secrets are not passed to the runner when a workflow is triggered from a forked repository. 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 b36b0b6cb7da..a217ad81ee02 100644 --- a/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md +++ b/translations/ru-RU/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn` (v1 only) (specify `npm`) +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`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 %} to monitor your dependency manifest file for new versions, use `package-ecosystem: "pip"` in your *dependabot.yml* file. diff --git a/translations/ru-RU/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/ru-RU/data/reusables/developer-site/pull_request_forked_repos_link.md index fe27ee792430..144420eb2f7e 100644 --- a/translations/ru-RU/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/ru-RU/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -10,4 +10,4 @@ When you create a pull request from a forked repository to the base repository, Workflows don't run on forked repositories by default. You must enable GitHub Actions in the **Actions** tab of the forked repository. -The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. For more information, see "[Authenticating with the GITHUB_TOKEN](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)." +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. 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/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/ru-RU/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/ru-RU/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/ru-RU/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/ru-RU/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/gated-features/actions-shared.md b/translations/ru-RU/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..57b1ab7a7d9f --- /dev/null +++ b/translations/ru-RU/data/reusables/gated-features/actions-shared.md @@ -0,0 +1 @@ +{% data variables.product.prodname_actions %} 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 %}, and {% 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. diff --git a/translations/ru-RU/data/reusables/gated-features/actions.md b/translations/ru-RU/data/reusables/gated-features/actions.md index 5d2317297b3b..bafbe8fae92d 100644 --- a/translations/ru-RU/data/reusables/gated-features/actions.md +++ b/translations/ru-RU/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{% data variables.product.prodname_actions %} 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 %}, and {% 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ru-RU/data/reusables/gated-features/auto-merge.md b/translations/ru-RU/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/ru-RU/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/gated-features/environments.md b/translations/ru-RU/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/ru-RU/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/ru-RU/data/reusables/github-actions/permissions-statement-environment.md b/translations/ru-RU/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/ru-RU/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/ru-RU/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/ru-RU/data/reusables/github-actions/sidebar-environment.md b/translations/ru-RU/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/ru-RU/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. diff --git a/translations/ru-RU/data/reusables/notifications/outbound_email_tip.md b/translations/ru-RU/data/reusables/notifications/outbound_email_tip.md index 1cd91b0775f1..ccc963059312 100644 --- a/translations/ru-RU/data/reusables/notifications/outbound_email_tip.md +++ b/translations/ru-RU/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. For more information, contact your site administrator. {% endnote %} - {% endif %} diff --git a/translations/ru-RU/data/reusables/organizations/add-dns-txt-record.md b/translations/ru-RU/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..d079bac20fe0 --- /dev/null +++ b/translations/ru-RU/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. Follow the instructions under **Add a DNS TXT record** to create a DNS TXT record with your domain hosting service. ![Instructions to create a DNS txt record](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/organizations/add-domain.md b/translations/ru-RU/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..0d28d2b11f74 --- /dev/null +++ b/translations/ru-RU/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. In the domain field, type the domain you'd like to verify, then click **Add domain**. ![Add a domain field](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/organizations/continue-verifying-domain.md b/translations/ru-RU/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..0f9978775267 --- /dev/null +++ b/translations/ru-RU/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![Continue verifying domain button](/assets/images/help/organizations/continue-verifying-domain.png) +10. Click **Verify domain**. ![Verify domain button](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/organizations/restrict-email-notifications.md b/translations/ru-RU/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..a662e4a74bd7 --- /dev/null +++ b/translations/ru-RU/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. Under "Enforcement preferences", select **Restrict email notifications to domain email**. ![Checkbox to restrict email notifications to verified domain emails](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/organizations/verified-domains-details.md b/translations/ru-RU/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..da065f8dd0b7 --- /dev/null +++ b/translations/ru-RU/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. If the website and email address shown on your organization's profile are hosted on different domains, you must verify both domains. If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/pages/wildcard-dns-warning.md b/translations/ru-RU/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..468c509c00a5 --- /dev/null +++ b/translations/ru-RU/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**Warning:** We strongly recommend not using wildcard DNS records, such as `*.example.com`. A wildcard DNS record will allow anyone to host a {% data variables.product.prodname_pages %} site at one of your subdomains. + +{% endwarning %} 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 e02fdea38195..2bab45542fcc 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -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 %} +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)." diff --git a/translations/ru-RU/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/ru-RU/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/ru-RU/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/ru-RU/data/reusables/pull_requests/you-can-auto-merge.md b/translations/ru-RU/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..410aec2a8ee8 --- /dev/null +++ b/translations/ru-RU/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." +{% endif %} \ No newline at end of file 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 01b69c31000e..4a6165a10ce3 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 @@ -176,7 +176,7 @@ git tag -a -m "My first action release" v1 git push --follow-tags ``` -Checking in your `node_modules` directory can cause problems. As an alternative, you can use a tool called [`@vercel/ncc`](https://github.com/vercel/ncc) to compile your code and modules into one file used for distribution. +检入 `node_modules` 目录可能会导致问题。 作为替代方法，您可以使用名为 [`@vercel/ncc`](https://github.com/vercel/ncc) 的工具将您的代码和模块编译到一个用于分发的文件中。 1. 通过在您的终端运行此命令来安装 `vercel/ncc`。 `npm i -g @vercel/ncc` 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 ce68767feb3d..c1a89a776ac3 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 @@ -254,10 +254,12 @@ runs: -##### `runs.steps.run` +##### `runs.steps[*].run` **必要** 您想要运行的命令。 这可以是内联的，也可以是操作仓库中的脚本： +{% raw %} + ```yaml runs: @@ -268,6 +270,8 @@ runs: ``` +{% endraw %} + 或者，您也可以使用 `$GITHUB_ACTION_PATH`： @@ -285,31 +289,31 @@ runs: -##### `runs.steps.shell` +##### `runs.steps[*].shell` **必要** 您想要在其中运行命令的 shell。 您可以使用[这里](/actions/reference/workflow-syntax-for-github-actions#using-a-specific-shell)列出的任何 shell。 -##### `runs.steps.name` +##### `runs.steps[*].name` **可选** 组合运行步骤的名称。 -##### `runs.steps.id` +##### `runs.steps[*].id` **可选** 步骤的唯一标识符。 您可以使用 `id` 引用上下文中的步骤。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 -##### `runs.steps.env` +##### `runs.steps[*].env` **可选** 设置环境变量的 `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 %}。 -##### `runs.steps.working-directory` +##### `runs.steps[*].working-directory` **可选** 指定命令在其中运行的工作目录。 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 index 76e8027a87f5..26de7a86f35c 100644 --- a/translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md +++ b/translations/zh-CN/content/actions/guides/building-and-testing-nodejs.md @@ -193,9 +193,9 @@ steps: {% data reusables.github-actions.setup-node-intro %} -要验证您的私有注册表，需要将 npm 身份验证令牌在仓库设置中存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 +要验证您的私有注册表，需要将 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` 环境变量。 +在下面的示例中，密码 `NPM_TOKEN` 用于存储 npm 身份验证令牌。 `setup-node` 操作配置 *.npmrc* 文件从 `NODE_AUTH_TOKEN` 环境变量读取 npm 身份验证令牌。 使用 `setup-node` 操作创建 *.npmrc* 文件时，必须使用包含 npm 身份验证令牌的密码设置 `NODE_AUTH_TOKEN` 环境变量。 在安装依赖项之前，使用 `setup-node` 操作创建 *.npmrc* 文件。 该操作有两个输入参数。 `node-version` 参数设置 Node.js 版本，`registry-url` 参数设置默认注册表。 如果包注册表使用作用域，您必须使用 `scope` 参数。 更多信息请参阅 [`npm-scope`](https://docs.npmjs.com/misc/scope)。 diff --git a/translations/zh-CN/content/actions/guides/building-and-testing-powershell.md b/translations/zh-CN/content/actions/guides/building-and-testing-powershell.md index 0af814dd338d..e5b28ca34c16 100644 --- a/translations/zh-CN/content/actions/guides/building-and-testing-powershell.md +++ b/translations/zh-CN/content/actions/guides/building-and-testing-powershell.md @@ -214,7 +214,7 @@ jobs: ### 发布到 PowerShell Gallery -您可以配置工作流程在 CI 测试通过时将 PowerShell 模块发布到 PowerShell Gallery。 您可以使用仓库机密来存储发布软件包所需的任何令牌或凭据。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 +您可以配置工作流程在 CI 测试通过时将 PowerShell 模块发布到 PowerShell Gallery。 您可以使用机密来存储发布软件包所需的任何令牌或凭据。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 下面的示例创建软件包并使用 `Publish-Module` 将其发布到PowerShell Gallery： 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 index c78fb903fff5..37ae706004bf 100644 --- a/translations/zh-CN/content/actions/guides/building-and-testing-python.md +++ b/translations/zh-CN/content/actions/guides/building-and-testing-python.md @@ -460,7 +460,7 @@ jobs: 您可以配置工作流程在 CI 测试通过时将 Python 包发布到您想要的任何包注册表。 -您可以使用仓库密码存储发布软件包所需的访问令牌或凭据。 下面的示例使用 `twine` 和 `dist` 创建包并发布到 PyPI。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 +您可以使用密码存储发布软件包所需的访问令牌或凭据。 下面的示例使用 `twine` 和 `dist` 创建包并发布到 PyPI。 更多信息请参阅“[创建和使用加密密码](/github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 {% raw %} diff --git a/translations/zh-CN/content/actions/guides/deploying-to-amazon-elastic-container-service.md b/translations/zh-CN/content/actions/guides/deploying-to-amazon-elastic-container-service.md new file mode 100644 index 000000000000..5a2ccfd00df5 --- /dev/null +++ b/translations/zh-CN/content/actions/guides/deploying-to-amazon-elastic-container-service.md @@ -0,0 +1,148 @@ +--- +title: 部署到 Amazon Elastic Container Service +intro: 您可以部署到 Amazon Elastic Container Service (ECS)，作为持续部署 (CD) 工作流程的一部分。 +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_actions %} 构建容器化应用程序，将其推送到 [Amazon Elastic Container Registry (ECR)](https://aws.amazon.com/ecr/)，以及将其部署到 [Amazon Elastic Container Service (ECS)](https://aws.amazon.com/ecs/)。 + +在 {% data variables.product.company_short %} 仓库的每个新版本上，{% data variables.product.prodname_actions %} 工作流程将生成新的容器映像并将其推送到 Amazon ECR，然后将新的任务定义部署到 Amazon ECS。 + +### 基本要求 + +在创建 {% data variables.product.prodname_actions %} 工作流程之前，首先需要对 Amazon ECR 和 ECS 完成以下设置步骤： + +1. 创建 Amazon ECR 仓库以存储映像。 + + 例如，使用 [AWS CLI](https://aws.amazon.com/cli/)： + + {% raw %}```bash{:copy} + aws ecr create-repository \ --repository-name MY_ECR_REPOSITORY \ --region MY_AWS_REGION + ```{% endraw %} + + Ensure that you use the same Amazon ECR repository name (represented here by `MY_ECR_REPOSITORY`) for the `ECR_REPOSITORY` variable in the workflow below. + + Ensure that you use the same AWS region value for the `AWS_REGION` (represented here by `MY_AWS_REGION`) variable in the workflow below. + +2. Create an Amazon ECS task definition, cluster, and service. + + For details, follow the [Getting started wizard on the Amazon ECS console](https://us-east-2.console.aws.amazon.com/ecs/home?region=us-east-2#/firstRun), or the [Getting started guide](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/getting-started-fargate.html) in the Amazon ECS documentation. + + Ensure that you note the names you set for the Amazon ECS service and cluster, and use them for the `ECS_SERVICE` and `ECS_CLUSTER` variables in the workflow below. + +3. Store your Amazon ECS task definition as a JSON file in your {% data variables.product.company_short %} repository. + + The format of the file should be the same as the output generated by: + + {% raw %}```bash{:copy} + aws ecs register-task-definition --generate-cli-skeleton + ```{% endraw %} + + Ensure that you set the `ECS_TASK_DEFINITION` variable in the workflow below as the path to the JSON file. + + Ensure that you set the `CONTAINER_NAME` variable in the workflow below as the container name in the `containerDefinitions` section of the task definition. + +4. Create {% data variables.product.prodname_actions %} secrets named `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` to store the values for your Amazon IAM access key. + + For more information on creating secrets for {% data variables.product.prodname_actions %}, see "[Encrypted secrets](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)." + + See the documentation for each action used below for the recommended IAM policies for the IAM user, and methods for handling the access key credentials. + +### Creating the workflow + +Once you've completed the prerequisites, you can proceed with creating the workflow. + +The following example workflow demonstrates how to build a container image and push it to Amazon ECR. It then updates the task definition with the new image ID, and deploys the task definition to Amazon ECS. + +Ensure that you provide your own values for all the variables in the `env` key of the workflow. + +{% raw %} +```yaml{:copy} +name: Deploy to Amazon ECS + +on: + release: + types: [ created ] + +env: + AWS_REGION: MY_AWS_REGION # set this to your preferred AWS region, e.g. us-west-1 + ECR_REPOSITORY: MY_ECR_REPOSITORY # set this to your Amazon ECR repository name + ECS_SERVICE: MY_ECS_SERVICE # set this to your Amazon ECS service name + ECS_CLUSTER: MY_ECS_CLUSTER # set this to your Amazon ECS cluster name + ECS_TASK_DEFINITION: MY_ECS_TASK_DEFINITION # set this to the path to your Amazon ECS task definition + # file, e.g. .aws/task-definition.json + CONTAINER_NAME: MY_CONTAINER_NAME # set this to the name of the container in the + # containerDefinitions section of your task definition + +defaults: + run: + shell: bash + +jobs: + deploy: + name: Deploy + runs-on: ubuntu-latest + + steps: + - name: Checkout + uses: actions/checkout@v2 + + - name: Configure AWS credentials + uses: aws-actions/configure-aws-credentials@v1 + with: + aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }} + aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} + aws-region: $AWS_REGION + + - name: Login to Amazon ECR + id: login-ecr + uses: aws-actions/amazon-ecr-login@v1 + + - name: Build, tag, and push image to Amazon ECR + id: build-image + env: + ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry }} + IMAGE_TAG: ${{ github.sha }} + run: | + # Build a docker container and + # push it to ECR so that it can + # be deployed to ECS. + docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . + docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG + echo "image=$ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG" >> $GITHUB_ENV + + - name: Fill in the new image ID in the Amazon ECS task definition + id: task-def + uses: aws-actions/amazon-ecs-render-task-definition@v1 + with: + task-definition: $ECS_TASK_DEFINITION + container-name: $CONTAINER_NAME + image: ${{ steps.build-image.outputs.image }} + + - name: Deploy Amazon ECS task definition + uses: aws-actions/amazon-ecs-deploy-task-definition@v1 + with: + task-definition: ${{ steps.task-def.outputs.task-definition }} + service: $ECS_SERVICE + cluster: $ECS_CLUSTER + wait-for-service-stability: true +``` +{% endraw %} + +### 其他资源 + +有关这些示例中使用的服务的详细信息，请参阅以下文档： + +* Amazon AWS 文档中的“[IAM 中的安全最佳实践](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)”。 +* 正式 AWS“[配置 AWS 凭据](https://github.com/aws-actions/configure-aws-credentials)”操作。 +* 正式 AWS [Amazon ECR“登录”](https://github.com/aws-actions/amazon-ecr-login)操作。 +* 正式 AWS [Amazon ECS“渲染任务定义”](https://github.com/aws-actions/amazon-ecs-render-task-definition)操作。 +* 正式 AWS [Amazon ECS“部署任务定义”](https://github.com/aws-actions/amazon-ecs-deploy-task-definition)操作。 diff --git a/translations/zh-CN/content/actions/guides/deploying-to-azure-app-service.md b/translations/zh-CN/content/actions/guides/deploying-to-azure-app-service.md new file mode 100644 index 000000000000..49de2609eaee --- /dev/null +++ b/translations/zh-CN/content/actions/guides/deploying-to-azure-app-service.md @@ -0,0 +1,115 @@ +--- +title: 部署到 Azure App Service +intro: 您可以部署到 Azure App Service，作为持续部署 (CD) 工作流程的一部分。 +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_actions %} 生成、测试并部署应用程序到 [Azure App Service](https://azure.microsoft.com/en-us/services/app-service/)。 + +Azure App Service 可以用几种语言运行 web 应用程序，但本指南演示的是部署现有的 Node.js 项目。 + +### 基本要求 + +在创建 {% data variables.product.prodname_actions %} 工作流程之前，首先需要完成以下设置步骤： + +1. 创建 Azure App Service 计划。 + + 例如，可以使用 Azure CLI 创建新的应用服务计划： + + ```bash{:copy} + az appservice plan create \ + --resource-group MY_RESOURCE_GROUP \ + --name MY_APP_SERVICE_PLAN \ + --is-linux + ``` + + 在上述命令中，将 `MY_ResourcesURCE_GROUP` 替换为您原有的 Azure 资源组，`MY_APP_SERVICE_PLAN` 替换为应用服务计划的新名称。 + + 请查看 Azure 文档以了解更多有关使用 [Azure CLI](https://docs.microsoft.com/en-us/cli/azure/) 的信息： + + * 有关身份验证，请参阅“[使用 Azure CLI 登录](https://docs.microsoft.com/en-us/cli/azure/authenticate-azure-cli)”。 + * 如果需要创建新的资源组，请参阅“[az 组](https://docs.microsoft.com/en-us/cli/azure/group?view=azure-cli-latest#az_group_create)”。 + +2. 创建 Web 应用。 + + 例如，可以使用 Azure CLI 创建具有节点运行时的 Azure App Service Web 应用： + + ```bash{:copy} + az webapp create \ + --name MY_WEBAPP_NAME \ + --plan MY_APP_SERVICE_PLAN \ + --resource-group MY_RESOURCE_GROUP \ + --runtime "node|10.14" + ``` + + 在上面的命令中，将参数替换为您自己的值，其中 `MY_WEBAPP_NAME` 是 Web 应用的新名称。 + +3. 配置 Azure 发布配置文件并创建 `AZURE_WEBAPP_PUBLISH_PROFILE` 机密。 + + 使用发布配置文件生成 Azure 部署凭据。 更多信息请参阅 Azure 文档中的“[生成部署凭据](https://docs.microsoft.com/en-us/azure/app-service/deploy-github-actions?tabs=applevel#generate-deployment-credentials)”。 + + 在 {% data variables.product.prodname_dotcom %} 仓库中，创建一个名为 `AZURE_WEBAPP_PUBLISH_PROFILE` 的机密，其中包含发布配置文件的内容。 有关创建机密的更多信息，请参阅“[加密密码](/actions/reference/encrypted-secrets#creating-encrypted-secrets-for-a-repository)”。 + +### 创建工作流程 + +完成先决条件后，可以继续创建工作流程。 + +下面的示例工作流程演示如何生成、测试 Node.js 项目并将其部署到 Azure App Service。 + +确保在工作流程 `env` 中将 `AZURE_WEBAPP_NAME` 密钥设置为您创建的 web 应用程序名称。 + +{% raw %} +```yaml{:copy} +on: + release: + types: [created] + +env: + AZURE_WEBAPP_NAME: MY_WEBAPP_NAME # set this to your application's name + AZURE_WEBAPP_PACKAGE_PATH: '.' # set this to the path to your web app project, defaults to the repository root + NODE_VERSION: '10.x' # set this to the node version to use + +jobs: + build-and-deploy: + name: Build and Deploy + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v2 + + - name: Use Node.js ${{ env.NODE_VERSION }} + uses: actions/setup-node@v1 + with: + node-version: ${{ env.NODE_VERSION }} + + - name: npm install, build, and test + run: | + # Build and test the project, then + # deploy to Azure Web App. + npm install + npm run build --if-present + npm run test --if-present + + - name: 'Deploy to Azure WebApp' + uses: azure/webapps-deploy@v2 + with: + app-name: ${{ env.AZURE_WEBAPP_NAME }} + publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }} + package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }} +``` +{% endraw %} + +### 其他资源 + +以下资源也可能有用： + +* 有关原始入门工作流程，请参阅 {% data variables.product.prodname_actions %} `starter-workflows` 仓库中的 [`azure.yml`](https://github.com/actions/starter-workflows/blob/master/ci/azure.yml)。 +* 用于部署 Web 应用的操作是正式的 Azure [`Azure/webapps-deploy`](https://github.com/Azure/webapps-deploy) 操作。 +* Azure web 应用文档中的“[在 Azure 中创建 Node.js web 应用](https://docs.microsoft.com/en-us/azure/app-service/quickstart-nodejs)”快速入门说明如何通过 [Azure App Service 扩展](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azureappservice)使用 VS Code。 diff --git a/translations/zh-CN/content/actions/guides/deploying-to-google-kubernetes-engine.md b/translations/zh-CN/content/actions/guides/deploying-to-google-kubernetes-engine.md new file mode 100644 index 000000000000..f19271724188 --- /dev/null +++ b/translations/zh-CN/content/actions/guides/deploying-to-google-kubernetes-engine.md @@ -0,0 +1,177 @@ +--- +title: 部署到 Google Kubernetes Engine +intro: 您可以部署到 Google Kubernetes Engine 引擎，作为持续部署 (CD) 工作流程的一部分。 +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_actions %} 构建容器化应用程序，将其推送到 Google Container Registry (GCR)，以及将其部署到 Google Kubernetes Engine (GKE)。 + +GKE 是 Google Cloud 的托管 Kubernetes 群集服务，可以在云中或您自己的数据中心中托管您的容器化工作负载。 更多信息请参阅 [Google Kubernetes Engine](https://cloud.google.com/kubernetes-engine)。 + +### 基本要求 + +在继续创建工作流程之前，您需要完成 Kubernetes 项目的以下步骤。 本指南假定项目的根目录已有 `Dockerfile` 和 Kubernetes 部署配置文件。 例如，请参阅 [google-github-](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/gke)。 + +#### 创建 GKE 群集 + +要创建 GKE 群集，首先需要使用 `gcloud` CLI 进行身份验证 。 有关此步骤的更多信息，请参阅以下文章： +- [`gcloud 身份验证登录`](https://cloud.google.com/sdk/gcloud/reference/auth/login) +- [`gcloud` CLI](https://cloud.google.com/sdk/gcloud/reference) +- [`gcloud` CLI 和 Cloud SDK](https://cloud.google.com/sdk/gcloud#the_gcloud_cli_and_cloud_sdk) + +例如： + +{% raw %} +```bash{:copy} +$ gcloud container clusters create $GKE_CLUSTER \ + --project=$GKE_PROJECT \ + --zone=$GKE_ZONE +``` +{% endraw %} + +#### 启用 API + +启用 Kubernetes Engine 和 Container Registry API。 例如： + +{% raw %} +```bash{:copy} +$ gcloud services enable \ + containerregistry.googleapis.com \ + container.googleapis.com +``` +{% endraw %} + +#### 配置服务帐户并存储其凭据 + +此程序显示如何为您的 GKE 集成创建服务帐户。 它说明了如何创建帐户、向其添加角色、检索其密钥，以及将它们存储为名为 `GKE_SA_KEY`、以 base64 编码的[加密仓库机密](/actions/reference/encrypted-secrets)。 + +1. 创建新服务帐户： + {% raw %} + ``` + $ gcloud iam service-accounts create $SA_NAME + ``` + {% endraw %} +1. 检索您刚刚创建的服务帐户的电子邮件地址： + {% raw %} + ``` + $ gcloud iam service-accounts list + ``` + {% endraw %} +1. 向服务帐户添加角色。 注意：应用限制更严格的角色以满足您的要求。 + {% raw %} + ``` + $ gcloud projects add-iam-policy-binding $GKE_PROJECT \ + --member=serviceAccount:$SA_EMAIL \ + --role=roles/container.admin \ + --role=roles/storage.admin + ``` + {% endraw %} +1. 下载服务帐户的 JSON 密钥文件： + {% raw %} + ``` + $ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL + ``` + {% endraw %} +1. 将项目 ID 存储为名为 `GKE_PROJECT` 的机密： + {% raw %} + ``` + $ export GKE_SA_KEY=$(cat key.json | base64) + ``` + {% endraw %} + +#### （可选）配置 kustomize +Kustomize 是用于管理 YAML 规范的可选工具。 在创建 _kustomization_ 文件之后， 下面的工作流可用于将结果中的图像和管道字段动态设置为 `kubectl`。 更多信息请参阅 [kustomize 的用法](https://github.com/kubernetes-sigs/kustomize#usage)。 + +### 创建工作流程 + +完成先决条件后，可以继续创建工作流程。 + +下面的示例工作流程演示如何生成容器映像并推送到 GCR。 然后，它使用 Kubernetes 工具（如 `kubectl` 和 `kustomize`）将映像拉入群集部署。 + +{% raw %} +```yaml{:copy} +name: Build and Deploy to GKE + +on: + release: + types: [created] + +env: + PROJECT_ID: ${{ secrets.GKE_PROJECT }} + GKE_CLUSTER: cluster-1 # Add your cluster name here. + GKE_ZONE: us-central1-c # Add your cluster zone here. + DEPLOYMENT_NAME: gke-test # Add your deployment name here. + IMAGE: static-site + +jobs: + setup-build-publish-deploy: + name: Setup, Build, Publish, and Deploy + runs-on: ubuntu-latest + steps: + + - name: Checkout + uses: actions/checkout@v2 + + # Setup gcloud CLI + - uses: google-github-actions/setup-gcloud@v0.2.0 + with: + service_account_key: ${{ secrets.GKE_SA_KEY }} + project_id: ${{ secrets.GKE_PROJECT }} + + # Configure docker to use the gcloud command-line tool as a credential helper + - run: |- + gcloud --quiet auth configure-docker + + # Get the GKE credentials so we can deploy to the cluster + - uses: google-github-actions/get-gke-credentials@v0.2.1 + with: + cluster_name: ${{ env.GKE_CLUSTER }} + location: ${{ env.GKE_ZONE }} + credentials: ${{ secrets.GKE_SA_KEY }} + + # Build the Docker image + - name: Build + run: |- + docker build \ + --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \ + --build-arg GITHUB_SHA="$GITHUB_SHA" \ + --build-arg GITHUB_REF="$GITHUB_REF" \ + . + + # Push the Docker image to Google Container Registry + - name: Publish + run: |- + docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" + + # Set up kustomize + - name: Set up Kustomize + run: |- + curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64 + chmod u+x ./kustomize + + # Deploy the Docker image to the GKE cluster + - name: Deploy + run: |- + ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA + ./kustomize build . | kubectl apply -f - + kubectl rollout status deployment/$DEPLOYMENT_NAME + kubectl get services -o wide +``` +{% endraw %} + +### 其他资源 + +有关这些示例中使用的工具的详细信息，请参阅以下文档： + +* 有关完整的入门工作流程，请参阅[“生成并部署到 GKE”工作流程](https://github.com/actions/starter-workflows/blob/master/ci/google.yml)。 +* 有关更多入门工作流程和随附代码，请参阅 Google 的 [{% data variables.product.prodname_actions %} 示例工作流程](https://github.com/google-github-actions/setup-gcloud/tree/master/example-workflows/)。 +* Kubernetes YAML 定制引擎：[Kustomize](https://kustomize.io/)。 +* Google Kubernetes Engine 文档中的“[部署容器化的 web 应用程序](https://cloud.google.com/kubernetes-engine/docs/tutorials/hello-app)”。 diff --git a/translations/zh-CN/content/actions/guides/index.md b/translations/zh-CN/content/actions/guides/index.md index f3da642ef2f2..35efe5e3857c 100644 --- a/translations/zh-CN/content/actions/guides/index.md +++ b/translations/zh-CN/content/actions/guides/index.md @@ -36,6 +36,14 @@ versions: {% link_in_list /building-and-testing-java-with-gradle %} {% link_in_list /building-and-testing-java-with-ant %} +### 创建自定义持续部署工作流程 + +您可以使用 {% data variables.product.prodname_actions %} 创建自定义连续部署 (CD) 工作流程，将项目部署到多个云合作伙伴生态系统。 + + {% link_in_list /deploying-to-amazon-elastic-container-service %} + {% link_in_list /deploying-to-azure-app-service %} + {% link_in_list /deploying-to-google-kubernetes-engine %} + ### 发布软件包 您可以自动发布软件包，作为持续交付 (CD) 工作流程的一部分。 软件包可以发布到任何软件包主机以及 {% data reusables.gated-features.packages %}。 diff --git a/translations/zh-CN/content/actions/guides/publishing-docker-images.md b/translations/zh-CN/content/actions/guides/publishing-docker-images.md index 0348244432e3..daf0b4c1fe2a 100644 --- a/translations/zh-CN/content/actions/guides/publishing-docker-images.md +++ b/translations/zh-CN/content/actions/guides/publishing-docker-images.md @@ -46,11 +46,11 @@ versions: 在下面的示例工作流程中，我们使用 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，您需要有一个 Docker Hub 帐户，并创建一个 Docker Hub 仓库。 更多信息请参阅 Docker 文档中的“[将 Docker 容器映像推送到 Docker Hub](https://docs.docker.com/docker-hub/repos/#pushing-a-docker-container-image-to-docker-hub)”。 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)”。 +* `username` 和 `password`：这是您的 Docker Hub 用户名和密码。 我们建议将 Docker Hub 用户名和密码存储为机密，使它们不会公开在工作流程文件中。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 * `repository`：`DOCKER-HUB-NAMESPACE/DOCKER-HUB-REPOSITORY` 格式的 Docker Hub 仓库。 {% raw %} diff --git a/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md b/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md index 2909e18a9ec2..6c3431e83e15 100644 --- a/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md +++ b/translations/zh-CN/content/actions/guides/publishing-nodejs-packages.md @@ -44,7 +44,7 @@ versions: 每次创建新版本时，都可以触发工作流程来发布包。 以下示例中的工作流程在类型为 `created` 的 `release` 事件触发时运行。 如果 CI 测试通过，工作流程将包发布到 npm 注册表。 -要根据工作流程中的 npm 注册表执行经过身份验证的操作，您需要在仓库设置中将 npm 身份验证令牌作存储为密码。 例如，创建名为 `NPM_TOKEN` 的密码。 更多信息请参阅“[创建和使用加密密码](/actions/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets)”。 +要根据工作流程中的 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`。 diff --git a/translations/zh-CN/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md b/translations/zh-CN/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md index ca4d6137513c..d4468bd9f008 100644 --- a/translations/zh-CN/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md +++ b/translations/zh-CN/content/actions/hosting-your-own-runners/configuring-the-self-hosted-runner-application-as-a-service.md @@ -6,6 +6,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} 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 0b2501b51626..f38fdfe8c54d 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 @@ -8,6 +8,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '>=2.22' +defaultPlatform: linux --- {% data reusables.actions.enterprise-beta %} diff --git a/translations/zh-CN/content/actions/index.md b/translations/zh-CN/content/actions/index.md index 4b717ea2e5d9..f35c7690d443 100644 --- a/translations/zh-CN/content/actions/index.md +++ b/translations/zh-CN/content/actions/index.md @@ -25,6 +25,10 @@ featuredLinks: - /actions/reference/workflow-commands-for-github-actions - /actions/reference/environment-variables changelog: + - + title: 工作流程可视化 + date: '2020-12-08' + href: https://github.blog/changelog/2020-12-08-github-actions-workflow-visualization/ - title: 11 月 16 日删除 set-env 和 add-path 命令 date: '2020-11-09' @@ -33,14 +37,6 @@ changelog: title: Ubuntu-latest 工作流程将使用 Ubuntu-20.04 date: '2020-10-29' href: https://github.blog/changelog/2020-10-29-github-actions-ubuntu-latest-workflows-will-use-ubuntu-20-04 - - - title: MacOS Big Sur 预览 - date: '2020-10-29' - href: https://github.blog/changelog/2020-10-29-github-actions-macos-big-sur-preview - - - title: 自托管运行器组访问权限更改 - date: '2020-10-16' - href: https://github.blog/changelog/2020-10-16-github-actions-self-hosted-runner-group-access-changes/ product_video: https://www.youtube-nocookie.com/embed/cP0I9w2coGU redirect_from: - /articles/automating-your-workflow-with-github-actions/ 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 index f25fdcce50d1..1aedb779c1bc 100644 --- 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 @@ -76,7 +76,7 @@ steps: #### 使用分支 -引用特定分支意味着操作将始终使用包括目标分支上的最新更新，但如果这些更新包括重大更改，则可能会造成问题。 此示例针对名为 `@main`的分支： +引用特定分支意味着操作将始终使用目标分支上的最新更新，但如果这些更新包括重大更改，则可能会造成问题。 此示例针对名为 `@main`的分支： ```yaml steps: 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 index dd8f37e740b9..7a92ef605510 100644 --- 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 @@ -1,7 +1,7 @@ --- title: 管理复杂的工作流程 shortTitle: 管理复杂的工作流程 -intro: '本指南演示如何使用 {% data variables.product.prodname_actions %} 的高级功能，包括机密管理、从属作业、缓存、构建矩阵和标签。' +intro: '本指南说明如何使用 {% data variables.product.prodname_actions %} 的高级功能，包括机密管理、相关作业、缓存、生成矩阵、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}环境{% endif %}和标签。' versions: free-pro-team: '*' enterprise-server: '>=2.22' @@ -148,6 +148,12 @@ jobs: 更多信息请参阅“[将标签与自托管运行器一起使用](/actions/hosting-your-own-runners/using-labels-with-self-hosted-runners)”。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### 使用环境 + +您可以使用保护规则和机密配置环境。 工作流程中的每个作业都可以引用单个环境。 在将引用环境的作业发送到运行器之前，必须通过为环境配置的任何保护规则。 更多信息请参阅“[环境](/actions/reference/environments)”。 +{% endif %} + ### 后续步骤 要继续了解 {% data variables.product.prodname_actions %}，请参阅“[与组织共享工作流程](/actions/learn-github-actions/sharing-workflows-with-your-organization)”。 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 index 07eb87c9f185..edc9443b15d5 100644 --- 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 @@ -57,7 +57,7 @@ Jenkins 使用指令来管理 _Declarative Pipelines_。 这些指令定义工 | 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) | +| [`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) | diff --git a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md index 16af094413a9..54b836cab86f 100644 --- a/translations/zh-CN/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md +++ b/translations/zh-CN/content/actions/learn-github-actions/migrating-from-travis-ci-to-github-actions.md @@ -175,7 +175,7 @@ Travis CI 和 {% data variables.product.prodname_actions %} 可以将自定义 #### 存储密码 -{% data variables.product.prodname_actions %} 允许您存储密码并在作业中引用它们。 {% data variables.product.prodname_actions %} 还包括允许您在仓库和组织级别限制对密码的访问的策略。 更多信息请参阅“[加密密码](/actions/reference/encrypted-secrets)”。 +{% data variables.product.prodname_actions %} 允许您存储密码并在作业中引用它们。 {% data variables.product.prodname_actions %} 组织可以限制哪些仓库能够访问组织机密。 {% if currentversion == "free-proteam@latest" or currentversion ver_gt "enterprise-server@3.0" %}环境保护规则可要求工作流程获得手动批准才能访问环境机密。 {% endif %}更多信息请参阅“[加密密码](/actions/reference/encrypted-secrets)”。 #### 在作业和工作流程之间共享文件 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 index 95391166007a..a3f10c7573ac 100644 --- 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 @@ -19,7 +19,7 @@ versions: ### 使用密码 -敏感值绝不能以明文存储在工作流程文件中，而应存储为密码。 [密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)可在组织或仓库级配置，可用于在 {% data variables.product.product_name %} 中存储敏感信息。 +敏感值绝不能以明文存储在工作流程文件中，而应存储为密码。 [密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)可在组织{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}、仓库或环境{% else %}或仓库{% endif %}级配置，可用于在 {% 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 %} 可对其进行解密，以便它能够被注入工作流程运行时。 @@ -38,6 +38,10 @@ versions: - **审核并轮换注册密码** - 定期查查已注册的密码，以确认它们仍是必需的。 删除不再需要的密码。 - 定期轮换密码，以减小泄露的密码有效的时间窗。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- **考虑要求对访问密码进行审查** + - 您可以使用所需的审查者来保护环境机密。 在审查者批准之前，工作流程作业无法访问环境机密。 有关在环境中存储机密或需要审查环境的更多信息，请参阅“[加密秘密](/actions/reference/encrypted-secrets)”和“[环境](/actions/reference/environments)”。 +{% endif %} ### 使用第三方操作 @@ -66,13 +70,13 @@ versions: ### 考虑跨仓库访问 -{% 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.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 密钥作为工作流程环境中的密码。 由于许多身份验证令牌类型不允许对特定资源进行细致的访问，因此使用错误的令牌类型存在很大风险，因为它可以授予比预期范围更广泛的访问。 +我们已经[制定 {% 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`** +1. **`GITHUB_TOKEN`** - 此令牌的范围有意设为调用工作流程的单个仓库，并且具有与仓库具有写入权限的用户的访问级别相同。 令牌在每个作业开始之前创建，在作业完成时过期。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 - 应尽可能使用 `GITHUB_TOKEN`。 2. **仓库部署密钥** 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 index 2016e0491824..1021cedba83b 100644 --- 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 @@ -13,6 +13,9 @@ versions: 这些额外的日志将通过在包含工作流程的仓库中设置密码来启用，因此将应用相同的权限要求： - {% data reusables.github-actions.permissions-statement-secrets-repository %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +- {% data reusables.github-actions.permissions-statement-secrets-environment %} +{% endif %} - {% data reusables.github-actions.permissions-statement-secrets-organization %} - {% data reusables.github-actions.permissions-statement-secrets-api %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/index.md b/translations/zh-CN/content/actions/managing-workflow-runs/index.md index 97885e3e6aeb..e57f4acd7e65 100644 --- a/translations/zh-CN/content/actions/managing-workflow-runs/index.md +++ b/translations/zh-CN/content/actions/managing-workflow-runs/index.md @@ -1,7 +1,7 @@ --- title: 管理工作流程运行 shortTitle: 管理工作流程运行 -intro: '您可以查看工作流程中每个步骤的状态和结果，取消待定的工作流程，查看可计费作业执行分钟数，调试并重新运行失败的工作流程，搜索并下载日志，以及下载构件。' +intro: '您可以查看工作流程中每个步骤的状态和结果、取消挂起的工作流、{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}查看部署、 {% endif %}查看计费作业执行分钟数、调试并重新运行失败的工作流、搜索并下载日志以及下载构件。' redirect_from: - /actions/configuring-and-managing-workflows/managing-a-workflow-run - /articles/viewing-your-repository-s-workflows @@ -24,6 +24,7 @@ versions: {% link_in_list /manually-running-a-workflow %} {% link_in_list /re-running-a-workflow %} {% link_in_list /canceling-a-workflow %} +{% link_in_list /reviewing-deployments %} {% link_in_list /disabling-and-enabling-a-workflow %} {% link_in_list /deleting-a-workflow-run %} {% link_in_list /viewing-job-execution-time %} diff --git a/translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md b/translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md new file mode 100644 index 000000000000..54dd1454cc90 --- /dev/null +++ b/translations/zh-CN/content/actions/managing-workflow-runs/reviewing-deployments.md @@ -0,0 +1,25 @@ +--- +title: 审查部署 +intro: 您可以批准或拒绝等待审查的作业。 +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### 关于工作流程中所需的审查 + +引用配置了所需审查者的环境的作业将等待审批后再开始。 当作业正在等待批准时，其状态为“等待”。 如果作业在 30 天内未获得批准，工作流程运行将自动取消。 + +有关环境和所需批准的信息，请参阅“[环境](/actions/reference/environments)”。 + +### 批准或拒绝作业 + +1. 导航到需要审核的工作流程运行。 有关导航到工作流程运行的更多信息，请参阅“[查看工作流程运行历史记录](/actions/managing-workflow-runs/viewing-workflow-run-history)”。 +2. 单击 **Review deployments（审查部署）**。 ![审查部署](/assets/images/actions-review-deployments.png) +3. 选择要审批或拒绝的作业环境。 （可选）留下评论。 ![批准部署](/assets/images/actions-approve-deployments.png) +4. 批准或拒绝： + - 要批准作业，请单击 **Approve and deploy（批准并部署）**。 一旦作业获得批准（并且任何其他环境保护规则已通过），作业将继续。 此时，作业可以访问存储在环境中的任何机密。 + - 要拒绝作业，请单击 **Reject（拒绝）**。 如果作业被拒绝，工作流程将失败。 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 index 9a7c91ea9dd8..a053b8e35cab 100644 --- a/translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md +++ b/translations/zh-CN/content/actions/reference/authentication-in-a-workflow.md @@ -14,8 +14,6 @@ versions: {% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -对仓库具有 `write` 权限的任何人都可以创建、读取和使用密码。 - ### 关于 `GITHUB_TOKEN` 密码 {% data variables.product.prodname_dotcom %} 会自动创建 `GITHUB_TOKEN` 密码以在工作流程中使用。 您可以使用 `GITHUB_TOKEN` 在工作流程运行中进行身份验证。 diff --git a/translations/zh-CN/content/actions/reference/encrypted-secrets.md b/translations/zh-CN/content/actions/reference/encrypted-secrets.md index 8de463d1c9f3..f7f502c99d00 100644 --- a/translations/zh-CN/content/actions/reference/encrypted-secrets.md +++ b/translations/zh-CN/content/actions/reference/encrypted-secrets.md @@ -1,6 +1,6 @@ --- -title: 加密机密 -intro: 加密密码允许您在仓库或组织中存储敏感信息。 +title: Encrypted secrets +intro: Encrypted secrets allow you to store sensitive information in your organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environments{% else %} or repository{% endif %}. product: '{% data reusables.gated-features.actions %}' redirect_from: - /github/automating-your-workflow-with-github-actions/creating-and-using-encrypted-secrets @@ -12,87 +12,115 @@ versions: --- {% data reusables.actions.enterprise-beta %} +{% data reusables.actions.environments-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -### 关于加密密码 +### About encrypted secrets -密码是在仓库或组织中创建的加密环境变量。 您创建的密码可用于 {% 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)对密码加密，并且在您于工作流程中使用它们之前一直保持加密状态。 +Secrets are encrypted environment variables that you create in an organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, repository, or repository environment{% else %} or repository{% endif %}. The secrets that 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 %} -#### 命名您的密码 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +For secrets stored at the environment level, you can enable required reviewers to control access to the secrets. A workflow job cannot access environment secrets until approval is granted by required approvers. +{% endif %} -以下规则适用于密码名称： +#### Naming your secrets -* 密码名称只能包含字母数字字符（`[a-z]`、`[A-Z]`、`[0-9]`）或下划线 (`_`)。 不允许空格。 -* 密码名称不能以 `GITHUB_` 前缀开头。 -* 密码名称不能以数字开头。 -* 密码名称在所创建的级别上必须是唯一的。 例如，在组织级别创建的密码必须在该级别具有唯一名称，而在仓库级别创建的密码必须在该仓库具有唯一名称。 如果组织级别密码的名称与仓库级别的密码相同，则仓库级别的密码优先。 +The following rules apply to secret names: -为帮助确保 {% data variables.product.prodname_dotcom %} 在日志中编写密码，请勿将结构化数据用作密码的值。 例如，避免创建包含 JSON 或编码 Git blob 的密码。 +* 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 are not case-sensitive. +* Secret names must be unique at the level they are created at. For example, {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}a secret created at the environment level must have a unique name in that environment, {% endif %}a secret created at the repository level must have a unique name in that repository, and a secret created at the organization level must have a unique name at that level. + + If a secret with the same name exists at multiple levels, the secret at the lower level takes precedence. For example, if an organization-level secret has the same name as a repository-level secret, then the repository-level secret takes precedence.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Similarly, if an organization, repository, and environment all have a secret with the same name, the environment-level secret takes precedence.{% endif %} -#### 访问您的密码 +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. -为使密码用于操作，必须将密码设置为工作流程文件中的输入或环境变量。 查看操作的自述文件以了解操作预期的输入和环境变量。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的工作流程语法](/articles/workflow-syntax-for-github-actions/#jobsjob_idstepsenv)”。 +#### Accessing your secrets -如果您拥有编辑文件的权限，便可在工作流程文件中使用和读取加密密码。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 上的访问权限](/github/getting-started-with-github/access-permissions-on-github)”。 +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 %} -**警告：**{% data variables.product.prodname_dotcom %} 自动将密码编写到日志，但您应避免有意将密码打印到日志。 +**Warning:** {% data variables.product.prodname_dotcom %} automatically redacts secrets printed to the log, but you should avoid printing secrets to the log intentionally. {% endwarning %} -您还可以使用 REST API 管理密码。 更多信息请参阅“[密码](/rest/reference/actions#secrets)”。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +Organization and repository secrets are read when a workflow run is queued, and environment secrets are read when a job referencing the environment starts. +{% endif %} + +You can also manage secrets using the REST API. For more information, see "[Secrets](/rest/reference/actions#secrets)." -#### 限制凭据权限 +#### Limiting credential permissions -生成凭据时，建议尽可能授予最低的权限。 例如，不使用个人凭据，而使用[部署密钥](/developers/overview/managing-deploy-keys#deploy-keys)或服务帐户。 请考虑授予只读权限（如果这是所需的全部权限）并尽可能限制访问。 生成个人访问令牌 (PAT) 时，选择所需的最小范围。 +When generating credentials, we recommend that you grant the minimum permissions possible. For example, instead of using personal credentials, use [deploy keys](/developers/overview/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. 单击 **Add a new secret（添加新机密）**。 -1. 在 **Name（名称）**输入框中键入密码的名称。 -1. 输入密码的值。 -1. 单击 **Add secret（添加密码）**。 +1. Click **New repository 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 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}has environment secrets or {% endif %}can access secrets from the parent organization, then those secrets are also listed on this page. + +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### Creating encrypted secrets for an environment -如果您的仓库可以从父级组织访问密码，则此页上也会列出这些密码。 +{% data reusables.github-actions.permissions-statement-secrets-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. Click on the environment that you want to add a secret to. +1. Under **Environment secrets**, click **Add secret**. +1. Type a name for your secret in the **Name** input box. +1. Enter the value for your secret. +1. Click **Add secret**. +{% endif %} -### 为组织创建加密密码 +### 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. 单击 **New secret（新建密码）**。 -1. 在 **Name（名称）**输入框中键入密码的名称。 -1. 输入密码的 **Value（值）**。 -1. 从 **Repository access（仓库访问权限）**下拉列表，选择访问策略。 -1. 单击 **Add secret（添加密码）**。 +1. Click **New organization 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. 密码列表包括任何已配置的权限和策略。 例如： ![密码列表](/assets/images/help/settings/actions-org-secrets-list.png) -1. 有关已为每个密码配置的权限的更多信息，请单击 **Update（更新）**。 +1. The list of secrets includes any configured permissions and policies. For example: +![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 -除了 `GITHUB_TOKEN` 以外，从复刻的仓库触发工作流程时密码不会传递给运行程序。 +{% data reusables.actions.forked-secrets %} -要提供以密码作为输入或环境变量的操作，可以使用 `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)”。 +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 @@ -105,11 +133,11 @@ steps: ``` {% endraw %} -尽可能避免使用命令行在进程之间传递密码。 命令行进程可能对其他用户可见（使用 `ps` 命令）或通过[安全审计事件](https://docs.microsoft.com/windows-server/identity/ad-ds/manage/component-updates/command-line-process-auditing)获取。 为帮助保护密码，请考虑使用环境变量 `STDIN` 或目标进程支持的其他机制。 +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/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. -如果必须在命令行中传递密码，则将它们包含在适当的引用规则中。 密码通常包含可能意外影响 shell 的特殊字符。 要转义这些特殊字符，请引用环境变量。 例如： +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. For example: -#### 使用 Bash 的示例 +#### Example using Bash {% raw %} ```yaml @@ -122,7 +150,7 @@ steps: ``` {% endraw %} -#### 使用 PowerShell 的示例 +#### Example using PowerShell {% raw %} ```yaml @@ -135,7 +163,7 @@ steps: ``` {% endraw %} -#### 使用 Cmd.exe 的示例 +#### Example using Cmd.exe {% raw %} ```yaml @@ -148,44 +176,44 @@ steps: ``` {% endraw %} -### 密码的限制 +### Limits for secrets -您的工作流程最多可以有 100 个密码。 密码环境变量的名称在仓库中必须是唯一的。 +You can store up to 1,000 secrets per organization{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}, 100 secrets per repository, and 100 secrets per environment{% else %} and 100 secrets per repository{% endif %}. A workflow may use up to 100 organization secrets and 100 repository secrets.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} Additionally, a job referencing an environment may use up to 100 environment secrets.{% endif %} -密码大小限于 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)”。 +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 %} -**警告**：请注意，您的密码在操作运行时不会印出。 使用此解决方法时，{% data variables.product.prodname_dotcom %} 不会编写日志中印出的密码。 +**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. 从终端运行以下命令，以使用 `gpg` 和 AES256 密码算法对 `my_secret.json` 文件加密。 +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. 将会提示您输入密码短语。 请记住该密码短语，因为需要在使用该密码短语作为值的 {% data variables.product.prodname_dotcom %} 上创建新密码。 +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. 创建包含密码短语的新密码。 例如，使用名称 `LARGE_SECRET_PASSPHRASE` 创建新密码，并将密码的值设为上一步所选的密码短语。 +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. 将加密的文件复制到仓库并提交。 在本例中，加密的文件是 `my_secret.json.gpg`。 +1. Copy your encrypted file into your repository and commit it. In this example, the encrypted file is `my_secret.json.gpg`. -1. 创建 shell 脚本对密码解密。 将此文件另存为 `decrypt_secret.sh`。 +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. 确保 shell 脚本在检入仓库之前可执行。 +1. Ensure your shell script is executable before checking it in to your repository. ``` shell $ chmod +x decrypt_secret.sh @@ -194,7 +222,7 @@ steps: $ git push ``` -1. 从工作流程使用 `step` 调用 shell 脚本并对密码解密。 要在工作流程运行的环境中创建仓库的副本，需要使用 [`actions/checkout`](https://github.com/actions/checkout) 操作。 使用与仓库根目录相关的 `run` 命令引用 shell 脚本。 +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 diff --git a/translations/zh-CN/content/actions/reference/environment-variables.md b/translations/zh-CN/content/actions/reference/environment-variables.md index 0c9b07e42976..cf69ee11e737 100644 --- a/translations/zh-CN/content/actions/reference/environment-variables.md +++ b/translations/zh-CN/content/actions/reference/environment-variables.md @@ -18,7 +18,7 @@ versions: {% 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)”。 +要设置自定义环境变量，您需要在工作流程文件中指定变量。 您可以使用 [`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: @@ -51,8 +51,8 @@ steps: | `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` | 触发工作流程的分支或标记参考。 例如 `refs/heads/feature-branch-1`。 如果分支或标记都不适用于事件类型，则变量不会存在。 | -| `GITHUB_HEAD_REF` | 仅为复刻的仓库设置。 头部仓库的分支。 | -| `GITHUB_BASE_REF` | 仅为复刻的仓库设置。 基础仓库的分支。 | +| `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`。 | diff --git a/translations/zh-CN/content/actions/reference/environments.md b/translations/zh-CN/content/actions/reference/environments.md new file mode 100644 index 000000000000..6897ac269275 --- /dev/null +++ b/translations/zh-CN/content/actions/reference/environments.md @@ -0,0 +1,69 @@ +--- +title: 环境 +intro: 您可以使用保护规则和机密配置环境。 工作流程作业可以引用环境来使用环境的保护规则和机密。 +product: '{% data reusables.gated-features.environments %}' +versions: + free-pro-team: '*' + enterprise-server: '>=3.1' +--- + +{% data reusables.actions.environments-beta %} + +### 关于环境 + +您可以使用保护规则和机密配置环境。 当工作流程引用环境时，作业在环境的所有保护规则通过之前不会开始。 在所有环境保护规则通过之前，作业也不能访问在环境中定义的机密。 + +{% if currentVersion == "free-pro-team@latest" %} +环境保护规则和环境机密只能在公共仓库中使用。 如果您将仓库从公开转换为私密，任何配置的保护规则或环境机密将被忽略， 并且您将无法配置任何环境。 如果将仓库转换回公共，您将有权访问以前配置的任何保护规则和环境机密。 +{% endif %} + +#### 环境保护规则 + +环境保护规则要求通过特定的条件，然后引用环境的作业才能继续。 您可以使用环境保护规则要求手动批准或延迟作业。 + +##### 需要的审查者 + +使用所需的审查者要求特定人员或团队批准引用环境的工作流程作业。 您最多可以列出六个用户或团队作为审查者。 审查者必须至少具有对仓库的读取访问权限。 只有一个必需的审查者需要批准该作业才能继续。 + +有关与必需审查者一起审查引用环境的作业的详细信息，请参阅“[审查部署](/actions/managing-workflow-runs/reviewing-deployments)”。 + +##### 等待计时器 + +在最初触发作业后，使用等待计时器将作业延迟特定时间。 时间（分钟）必须是 0 至 43,200（30天）之间的整数。 + +#### 环境机密 + +存储在环境中的机密仅可用于引用环境的工作流程作业。 如果环境需要批准，作业在所需的审查者批准之前不能访问环境机密。 有关机密的更多信息，请参阅“[加密密码](/actions/reference/encrypted-secrets)”。 + +### 创建环境 + +{% data reusables.github-actions.permissions-statement-environment %} + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. 单击 **New environment（新环境）**。 +1. 为环境输入一个名称, 然后单击 **Configure environment（配置环境）**。 环境名称不区分大小写。 环境名称不能超过 255 个字符，且必须在仓库中唯一。 +1. 配置任何环境保护规则或环境机密。 + +运行引用不存在的环境的工作流程将使用引用的名称创建环境。 新创建的环境将不配置任何保护规则或机密。 可在仓库中编辑工作流程的任何人都可以通过工作流程文件创建环境，但只有仓库管理员才能配置环境。 + +### 引用环境 + +工作流程中的每个作业都可以引用单个环境。 在将引用环境的作业发送到运行器之前，必须通过为环境配置的任何保护规则。 将作业发送到运行器时，作业可以访问环境的机密。 + +有关工作流程中引用环境的语法的更多信息，请参阅“[GitHub Actions 的工作流程语法](/actions/reference/workflow-syntax-for-github-actions#jobsjob_idenvironment)”。 有关与必需审查者一起审查引用环境的作业的详细信息，请参阅“[审查部署](/actions/managing-workflow-runs/reviewing-deployments)”。 + +当工作流程引用环境时，环境将显示在仓库的部署中。 有关查看当前和以前的部署的详细信息，请参阅“[查看部署历史记录](/developers/overview/viewing-deployment-history)”。 + +### 删除环境 + +{% data reusables.github-actions.permissions-statement-environment %} + +删除环境将删除与环境关联的所有机密和保护规则。 由于已删除环境的保护规则而正在等待的任何作业将自动失败。 + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.github-actions.sidebar-environment %} +1. 在要删除的环境旁边，单击 {% octicon "trashcan" aria-label="The trashcan icon" %}。 +2. 单击 **I understand, delete this environment（我了解，删除此环境）**。 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 4c6f90dc67c3..a63197d176ac 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 @@ -309,9 +309,9 @@ on: {% data reusables.github-actions.branch-requirement %} -| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | -| --------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | ------------ | -| [`issue_comment`](/rest/reference/activity#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | 默认分支上的最新提交 | 默认分支 | +| Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | +| -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------ | ------------ | +| [`issue_comment`](/developers/webhooks-and-events/webhook-events-and-payloads#issue_comment) | - `created`
    - `edited`
    - `deleted`
    | 默认分支上的最新提交 | 默认分支 | {% data reusables.developer-site.limit_workflow_to_activity_types %} @@ -576,7 +576,13 @@ on: #### `pull_request_target` -此事件类似于 `pull_request`，只不过它在拉取请求的基础仓库的上下文中运行，而不是在合并提交中运行。 这意味着您可以更安全地将您的密码提供给由拉取请求触发的工作流程，因为只有在基础仓库的提交中定义的工作流程才会运行。 例如，此事件允许您根据事件有效负载的内容创建工作流程来标识和评论拉取请求。 +此事件在拉取请求基础的上下文中运行，而不是像 `pull_request` 事件一样在合并提交中运行。 这样可以防止从拉取请求的头部执行不安全的工作流程代码，以免更改您的仓库或窃取您在工作流程中使用的任何机密。 此事件允许您根据事件有效负载的内容创建工作流程来标识和评论拉取请求，等等。 + +{% warning %} + +**警告：** `pull_request_target` 事件被授予读/写仓库令牌，可以访问机密，即使从复刻触发时。 虽然工作流程在拉取请求的基础上下文中运行，但您应该确保不在此事件中检出、生成或运行来自拉取请求的不受信任代码。 此外，任何缓存共享与基本分支相同的范围，并且为了帮助防止缓存中毒，如果缓存内容可能已更改，则不应保存缓存。 + +{% endwarning %} | Web 挂钩事件有效负载 | 活动类型 | `GITHUB_SHA` | `GITHUB_REF` | | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------------ | @@ -725,4 +731,4 @@ on: {% data reusables.github-actions.actions-do-not-trigger-workflows %} 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 -如果要从工作流程运行触发工作流程，您可以使用个人访问令牌触发事件。 您需要创建个人访问令牌并将其存储为密码。 为了最大限度地降低 {% data variables.product.prodname_actions %} 使用成本，请确保不要创建递归或意外的工作流程。 更多信息请参阅“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 +如果要从工作流程运行触发工作流程，您可以使用个人访问令牌触发事件。 您需要创建个人访问令牌并将其存储为密码。 为了最大限度地降低 {% data variables.product.prodname_actions %} 使用成本，请确保不要创建递归或意外的工作流程。 有关存储个人访问令牌的更多信息，请参阅“[创建和存储加密密码](/actions/configuring-and-managing-workflows/creating-and-storing-encrypted-secrets)”。 diff --git a/translations/zh-CN/content/actions/reference/index.md b/translations/zh-CN/content/actions/reference/index.md index e4ff8519bfcf..564d49f9de66 100644 --- a/translations/zh-CN/content/actions/reference/index.md +++ b/translations/zh-CN/content/actions/reference/index.md @@ -27,11 +27,19 @@ versions: ### 身份验证和密码 -{% data variables.product.prodname_dotcom %} 提供一个令牌，可用于代表 {% data variables.product.prodname_actions %} 进行身份验证。 您还可以将敏感信息作为密码存储在组织或仓库中。 {% data variables.product.prodname_dotcom %} 对所有密码加密。 +{% data variables.product.prodname_dotcom %} 提供一个令牌，可用于代表 {% data variables.product.prodname_actions %} 进行身份验证。 您还可以将敏感信息存储在您的组织{% if currentversion == "free-proteam@latest" or currentversion ver_gt "enterprise-server@3. %}、仓库或者环境{% else %} 或仓库{% endif %} 中。 {% data variables.product.prodname_dotcom %} 对所有密码加密。 {% link_in_list /authentication-in-a-workflow %} {% link_in_list /encrypted-secrets %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### 环境 + +工作流程作业可以引用具有保护规则或环境特定机密的环境。 + +{% link_in_list /environments %} +{% endif %} + ### {% data variables.product.prodname_dotcom %} 托管的运行器 GitHub 提供托管的虚拟机器来运行工作流程。 虚拟机包含一个环境，其中包含供 GitHub Actions 使用的工具、软件包和环境变量。 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 6b0d12202c6a..d01e75b9ff13 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 @@ -305,11 +305,13 @@ steps: `echo "{path}" >> $GITHUB_PATH` -为当前作业中的所有后续操作将目录添加到系统 `PATH` 变量之前。 当前运行的操作无法访问新路径变量。 +Prepends a directory to the system `PATH` variable and makes it available to all subsequent actions in the current job; the currently running action cannot access the updated path variable. To see the currently defined paths for your job, you can use `echo "$PATH"` in a step or an action. #### 示例 +This example demonstrates how to add the user `$HOME/.local/bin` directory to `PATH`: + ``` bash -echo "/path/to/dir" >> $GITHUB_PATH +echo "$HOME/.local/bin" >> $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 23eb826a1ad0..455168e9fdd4 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 @@ -187,7 +187,7 @@ on: ### `env` -环境变量的 `map` 可用于工作流程中的所有作业和步骤。 您还可以设置仅适用于作业或步骤的环境变量。 更多信息请参阅 [`jobs..env`](#jobsjob_idenv) and [`jobs..steps.env`](#jobsjob_idstepsenv)。 +环境变量的 `map` 可用于工作流程中的所有作业和步骤。 您还可以设置仅适用于作业或步骤的环境变量。 更多信息请参阅 [`jobs..env`](#jobsjob_idenv) and [`jobs..steps[*].env`](#jobsjob_idstepsenv)。 {% data reusables.repositories.actions-env-var-note %} @@ -223,7 +223,7 @@ defaults: 工作流程运行包括一项或多项作业。 作业默认是并行运行。 要按顺序运行作业，您可以使用 `needs` 关键词在其他作业上定义依赖项。 -每个作业在 `runs-on` 指定的环境中运行。 +每个作业在 `runs-on` 指定的运行器环境中运行。 在工作流程的使用限制之内可运行无限数量的作业。 更多信息请参阅“[使用限制和计费](/actions/reference/usage-limits-billing-and-administration)”（对于 {% data variables.product.prodname_dotcom %} 托管的运行器）和“[关于自托管运行器](/actions/hosting-your-own-runners/about-self-hosted-runners/#usage-limits)”（对于自托管运行器使用限制）。 @@ -249,9 +249,9 @@ jobs: ### `jobs..needs` -识别在此作业运行之前必须成功完成的任何作业。 它可以是一个字符串，也可以是字符串数组。 If a job fails, all jobs that need it are skipped unless the jobs use a conditional expression that causes the job to continue. +识别在此作业运行之前必须成功完成的任何作业。 它可以是一个字符串，也可以是字符串数组。 如果某个作业失败，则所有需要它的作业都会被跳过，除非这些作业使用让该作业继续的条件表达式。 -#### Example requiring dependent jobs to be successful +#### 要求相关作业成功的示例 ```yaml jobs: @@ -270,7 +270,7 @@ jobs: 2. `job2` 3. `job3` -#### Example not requiring dependent jobs to be successful +#### 不要求相关作业成功的示例 ```yaml jobs: @@ -282,7 +282,7 @@ jobs: needs: [job1, job2] ``` -In this example, `job3` uses the `always()` conditional expression so that it always runs after `job1` and `job2` have completed, regardless of whether they were successful. For more information, see "[Context and expression syntax](/actions/reference/context-and-expression-syntax-for-github-actions#job-status-check-functions)." +在此示例中，`job3` 使用 `always()` 条件表达式，因此它始终在 `job1` 和 `job2` 完成后运行，不管它们是否成功。 更多信息请参阅“[ 上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions#job-status-check-functions)”。 ### `jobs..runs-on` @@ -320,6 +320,39 @@ 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)”。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +### `jobs..environment` + +作业引用的环境。 在将引用环境的作业发送到运行器之前，必须通过所有环境保护规则。 更多信息请参阅“[环境](/actions/reference/environments)”。 + +您可以将环境仅作为环境 `name`，或作为具有 `name` 和 `url` 的环境变量。 URL 映射到部署 API 中的 `environment_url`。 有关部署 API 的更多信息，请参阅“[部署](/rest/reference/repos#deployments)”。 + +##### 使用单一环境名称的示例 + +```yaml +environment: staging_environment +``` + +##### 使用环境名称和 URL 的示例 + +```yaml +environment: + name: production_environment + url: https://github.com +``` + +URL 可以是表达式，并且可以使用除 `secrets` 上下文以外的任何上下文。 有关表达式的更多信息，请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 + +#### 示例 +{% raw %} +```yaml +environment: + name: production_environment + url: ${{ steps.step_name.outputs.url_output }} +``` +{% endraw %} +{% endif %} + ### `jobs..outputs` 作业的输出 `map`。 作业输出可用于所有依赖此作业的下游作业。 有关定义作业依赖项的更多信息，请参阅 [`jobs..needs`](#jobsjob_idneeds)。 @@ -354,7 +387,7 @@ jobs: ### `jobs..env` -环境变量的 `map` 可用于作业中的所有步骤。 您也可以设置整个工作流程或单个步骤的环境变量。 更多信息请参阅 [`env`](#env) 和 [`jobs..steps.env`](#jobsjob_idstepsenv)。 +环境变量的 `map` 可用于作业中的所有步骤。 您也可以设置整个工作流程或单个步骤的环境变量。 更多信息请参阅 [`env`](#env) 和 [`jobs..steps[*].env`](#jobsjob_idstepsenv)。 {% data reusables.repositories.actions-env-var-note %} @@ -429,11 +462,11 @@ jobs: ``` {% endraw %} -### `jobs..steps.id` +### `jobs..steps[*].id` 步骤的唯一标识符。 您可以使用 `id` 引用上下文中的步骤。 更多信息请参阅“[{% data variables.product.prodname_actions %} 的上下文和表达式语法](/actions/reference/context-and-expression-syntax-for-github-actions)”。 -### `jobs..steps.if` +### `jobs..steps[*].if` 您可以使用 `if` 条件阻止步骤在条件得到满足之前运行。 您可以使用任何支持上下文和表达式来创建条件。 @@ -463,11 +496,11 @@ steps: uses: actions/heroku@1.0.0 ``` -### `jobs..steps.name` +### `jobs..steps[*].name` 步骤显示在 {% data variables.product.prodname_dotcom %} 上的名称。 -### `jobs..steps.uses` +### `jobs..steps[*].uses` 选择要作为作业中步骤的一部分运行的操作。 操作是一种可重复使用的代码单位。 您可以使用工作流程所在仓库中、公共仓库中或[发布 Docker 容器映像](https://hub.docker.com/)中定义的操作。 @@ -570,7 +603,7 @@ jobs: uses: docker://gcr.io/cloud-builders/gradle ``` -### `jobs..steps.run` +### `jobs..steps[*].run` 使用操作系统 shell 运行命令行程序。 如果不提供 `name`，步骤名称将默认为 `run` 命令中指定的文本。 @@ -675,7 +708,7 @@ steps: - 除了编写脚本来检查每个错误代码并相应地响应之外，似乎没有办法完全选择快速失败行为。 由于我们默认不能实际提供该行为，因此您需要将此行为写入脚本。 - `cmd.exe` 在退出时带有其执行的最后一个程序的错误等级，并且会将错误代码返回到运行程序。 此行为在内部与上一个 `sh` 和 `pwsh` 默认行为一致，是 `cmd.exe` 的默认值，所以此行为保持不变。 -### `jobs..steps.with` +### `jobs..steps[*].with` 输入参数的 `map` 由操作定义。 每个输入参数都是一个键/值对。 输入参数被设置为环境变量。 该变量的前缀为 `INPUT_`，并转换为大写。 @@ -695,7 +728,7 @@ jobs: last_name: Octocat ``` -### `jobs..steps.with.args` +### `jobs..steps[*].with.args` `string` 定义 Docker 容器的输入。 {% data variables.product.prodname_dotcom %} 在容器启动时将 `args` 传递到容器的 `ENTRYPOINT`。 此参数不支持 `array of strings`。 @@ -718,7 +751,7 @@ steps: 1. 使用默认值，允许不指定任何 `args` 即可使用操作。 1. 如果操作显示 `--help` 标记或类似项，请将其用作默认值，以便操作自行记录。 -### `jobs..steps.with.entrypoint` +### `jobs..steps[*].with.entrypoint` 覆盖 `Dockerfile` 中的 Docker `ENTRYPOINT`，或在未指定时设置它。 与包含 shell 和 exec 表单的 Docker `ENTRYPOINT` 指令不同，`entrypoint` 关键词只接受定义要运行的可执行文件的单个字符串。 @@ -734,7 +767,7 @@ steps: `entrypoint` 关键词旨在用于 Docker 容器操作，但您也可以将其用于未定义任何输入的 JavaScript 操作。 -### `jobs..steps.env` +### `jobs..steps[*].env` 设置供步骤用于运行器环境的环境变量。 您也可以设置整个工作流程或某个作业的环境变量。 更多信息请参阅 [`env`](#env) 和 [`jobs..env`](#jobsjob_idenv)。 @@ -755,11 +788,11 @@ steps: ``` {% endraw %} -### `jobs..steps.continue-on-error` +### `jobs..steps[*].continue-on-error` 防止步骤失败时作业也会失败。 设置为 `true` 以允许在此步骤失败时作业能够通过。 -### `jobs..steps.timeout-minutes` +### `jobs..steps[*].timeout-minutes` 终止进程之前运行该步骤的最大分钟数。 @@ -769,7 +802,7 @@ steps: ### `jobs..strategy` -策略创建作业的构建矩阵。 您可以定义要在其中运行每项作业的环境的不同变种。 +策略创建作业的构建矩阵。 您可以定义要在其中运行每项作业的不同变种。 ### `jobs..strategy.matrix` diff --git a/translations/zh-CN/content/admin/configuration/configuring-email-for-notifications.md b/translations/zh-CN/content/admin/configuration/configuring-email-for-notifications.md index a05f1d19331d..b0e987cc3328 100644 --- a/translations/zh-CN/content/admin/configuration/configuring-email-for-notifications.md +++ b/translations/zh-CN/content/admin/configuration/configuring-email-for-notifications.md @@ -19,6 +19,7 @@ versions: {% data variables.contact.github_support %} 中的技术客户经理可以配置通过 SMTP 服务器发送电子邮件通知。 确保在支持请求中包含以下详细信息。 - 您的 SMTP服务器地址 +- 用于验证服务器的登录信息：用户名和密码 - SMTP 服务器用于发送电子邮件的端口 - SMTP 服务器将随 HELO 响应发送的域名（如果有） - SMTP 服务器使用的加密类型 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 b953de819526..9d761de2d9ea 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 @@ -94,7 +94,7 @@ versions: | 感恩节后的第一天 | 11 月的第四个星期五 | | 平安夜 | 12 月 24 日 | | 圣诞节 | 12 月 25 日 | -| 圣诞节后的第一天 | 12 月 26 日 | +| 圣诞节后的第一天 | 12 月 28 日 | | 新年除夕 | 12 月 31 日 | #### 日本节假日 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 a2729952b0c4..6fb3d7b40157 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 @@ -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) 天（不包括周末和美国全国性假日）对软件提供标准技术支持，不收取额外费用。 -| 美国 美国节假日 | 2018 年的庆祝日 | +| 美国 美国节假日 | 观察日期 | | ----------- | ----------- | | 元旦 | 1 月 1 日 | | 马丁·路德·金纪念 日 | 1 月的第三个星期一 | @@ -57,7 +57,7 @@ We offer support for {% data variables.product.prodname_advanced_security %} in | 感恩节后的第一天 | 11 月的第四个星期五 | | 平安夜 | 12 月 24 日 | | 圣诞节 | 12 月 25 日 | -| 圣诞节后的第一天 | 12 月 26 日 | +| 圣诞节后的第一天 | 12 月 28 日 | | 新年除夕 | 12 月 31 日 | ### 安装 {% data variables.product.prodname_advanced_security %} 更新 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 26731d2fac88..4c37b9eed58f 100644 --- a/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md +++ b/translations/zh-CN/content/admin/overview/about-enterprise-accounts.md @@ -18,7 +18,11 @@ An enterprise account allows you to manage multiple organizations{% if enterpris - Security {% if enterpriseServerVersions contains currentVersion %}(single sign-on, two factor authentication) - Requests {% if enterpriseServerVersions contains currentVersion %}and support bundle sharing {% endif %}with {% data variables.contact.enterprise_support %}{% endif %} -{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about managing your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." +{% if enterpriseServerVersions contains currentVersion %}{% data reusables.enterprise-accounts.enterprise-accounts-billing %} For more information about the management of your {% data variables.product.prodname_ghe_cloud %} subscription, see "[Viewing the subscription and usage for your enterprise account](/articles/viewing-the-subscription-and-usage-for-your-enterprise-account)." {% endif %}For more information about managing your {% data variables.product.product_name %} billing settings, see "[Managing billing for your enterprise](/admin/overview/managing-billing-for-your-enterprise)." + +For more information about the management of users, organizations, data, and policies for {% data variables.product.product_location %}, see "[Managing users, organizations, and repositories](/admin/user-management)" and "[Setting policies for your enterprise](/admin/policies)." + +For more information about the management of enterprise accounts using the GraphQL API, see "[Enterprise accounts](/graphql/guides/managing-enterprise-accounts)." {% if enterpriseServerVersions contains currentVersion %} 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 79dc22a1285d..9fdd2ad42010 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 @@ -51,6 +51,7 @@ MacOS 上的 GitHub Desktop 快捷键 | ⌘2 | 显示提交历史记录 | | ⌘B | 显示所有分支 | | ⌘G | 转到提交摘要字段 | +| ⌘Enter | 当摘要或描述字段处于活动状态时提交更改 | | space | 选择或取消选择所有突出显示的文件 | | ⇧⌘N | 创建新分支 | | ⇧⌘R | 重命名当前分支 | @@ -104,6 +105,7 @@ Windows 上的 GitHub Desktop 键盘快捷键 | Ctrl2 | 显示提交历史记录 | | CtrlB | 显示所有分支 | | CtrlG | 转到提交摘要字段 | +| CtrlEnter | 当摘要或描述字段处于活动状态时提交更改 | | space | 选择或取消选择所有突出显示的文件 | | CtrlShiftN | 创建新分支 | | CtrlShiftR | 重命名当前分支 | 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 3bef2eeeed9d..edc5993b548b 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 @@ -28,7 +28,7 @@ versions: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} {% data reusables.user-settings.modify_github_app %} -5. In "Private keys", click **Generate a private key**. ![生成私钥](/assets/images/github-apps/github_apps_generate_private_keys.png) +5. 在“Private keys（私钥）”中，单击 **Generate a private key（生成私钥）**。 ![生成私钥](/assets/images/github-apps/github_apps_generate_private_keys.png) 6. 您将看到一个以 PEM 格式下载至您的计算机的私钥。 确保将此文件存储下来，因为 GitHub 仅存储密钥的公共部分。 {% note %} 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 062db9e5221d..28b15cd20073 100644 --- a/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md +++ b/translations/zh-CN/content/developers/apps/authorizing-oauth-apps.md @@ -265,7 +265,9 @@ curl -H "Authorization: token OAUTH-TOKEN" {% data variables.product.api_url_pre 对于 `http://localhost/path` 回调 URL，您可以使用此 `redirect_uri`： - http://localhost:1234/path +``` +http://localhost:1234/path +``` ### 为 OAuth 应用程序创建多个令牌 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 b940dbe7d165..b2a4591235be 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 @@ -49,39 +49,39 @@ versions: 您可以在查询字符串中选择权限：使用下表中的权限名称作为查询参数名称，使用权限类型作为查询值。 例如，要在用户界面中为 `contents` 选择 `Read & write` 权限，您的查询字符串将包括 `&contents=write`。 要在用户界面中为 `blocking` 选择 `Read-only` 权限，您的查询字符串将包括 `&blocking=read`。 要在用户界面中为 `checks` 选择 `no-access` ，您的查询字符串将包括 `checks` 权限。 -| 权限 | 描述 | -| -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 权限 | 描述 | +| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [`管理`](/rest/reference/permissions-required-for-github-apps/#permission-on-administration) | 对用于组织和仓库管理的各种端点授予访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% if currentVersion == "free-pro-team@latest" %} | [`blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-blocking) | 授予对[阻止用户 API](/rest/reference/users#blocking) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} -| [`检查`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | 授予对[检查 API](/rest/reference/checks) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| `content_references` | 授予对“[创建内容附件](/rest/reference/apps#create-a-content-attachment)”端点的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`内容`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | 对用于修改仓库内容的各种端点授予访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`检查`](/rest/reference/permissions-required-for-github-apps/#permission-on-checks) | 授予对[检查 API](/rest/reference/checks) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| `content_references` | 授予对“[创建内容附件](/rest/reference/apps#create-a-content-attachment)”端点的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`内容`](/rest/reference/permissions-required-for-github-apps/#permission-on-contents) | 对用于修改仓库内容的各种端点授予访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | | [`部署`](/rest/reference/permissions-required-for-github-apps/#permission-on-deployments) | 授予对[部署 API](/rest/reference/repos#deployments) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% if currentVersion == "free-pro-team@latest" or enterpriseServerVersions contains currentVersion %} | [`emails`](/rest/reference/permissions-required-for-github-apps/#permission-on-emails) | 授予对[电子邮件 API](/rest/reference/users#emails) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} -| [`关注者`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | 授予对[关注者 API](/rest/reference/users#followers) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | 授予对[GPG 密钥 API](/rest/reference/users#gpg-keys) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | 授予对[议题 API](/rest/reference/issues) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`键`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | 授予对[公钥 API](/rest/reference/users#keys) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`关注者`](/rest/reference/permissions-required-for-github-apps/#permission-on-followers) | 授予对[关注者 API](/rest/reference/users#followers) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`gpg_keys`](/rest/reference/permissions-required-for-github-apps/#permission-on-gpg-keys) | 授予对[GPG 密钥 API](/rest/reference/users#gpg-keys) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`issues`](/rest/reference/permissions-required-for-github-apps/#permission-on-issues) | 授予对[议题 API](/rest/reference/issues) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`键`](/rest/reference/permissions-required-for-github-apps/#permission-on-keys) | 授予对[公钥 API](/rest/reference/users#keys) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | | [`members`](/rest/reference/permissions-required-for-github-apps/#permission-on-members) | 授予管理组织成员的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% if currentVersion == "free-pro-team@latest" %} -| [`元数据`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | 授予对不泄漏敏感数据的只读端点的访问权限。 可以是 `read` 或 `none`。 设置任何权限时，默认值为 `read`；没有为 {% data variables.product.prodname_github_app %} 指定任何权限时，默认值为 `none`。 | +| [`元数据`](/rest/reference/permissions-required-for-github-apps/#metadata-permissions) | 授予对不泄漏敏感数据的只读端点的访问权限。 可以是 `read` 或 `none`。 设置任何权限时，默认值为 `read`；没有为 {% data variables.product.prodname_github_app %} 指定任何权限时，默认值为 `none`。 | | [`organization_administration`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-administration) | 授予对“[更新组织](/rest/reference/orgs#update-an-organization)”端点和[组织交互限制 API](/rest/reference/interactions#set-interaction-restrictions-for-an-organization) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} -| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | 授予对[组织 web 挂钩 API](/rest/reference/orgs#webhooks/) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| `organization_plan` | 授予使用“[获取组织](/rest/reference/orgs#get-an-organization)”端点获取有关组织计划的信息的权限。 可以是以下项之一：`none` 或 `read`。 | +| [`organization_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-hooks) | 授予对[组织 web 挂钩 API](/rest/reference/orgs#webhooks/) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| `organization_plan` | 授予使用“[获取组织](/rest/reference/orgs#get-an-organization)”端点获取有关组织计划的信息的权限。 可以是以下项之一：`none` 或 `read`。 | | [`organization_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | 授予对[项目 API](/rest/reference/projects) 的访问权限。 可以是以下项之一：`none`、`read`、`write` 或 `admin`。{% if currentVersion == "free-pro-team@latest" %} | [`organization_user_blocking`](/rest/reference/permissions-required-for-github-apps/#permission-on-organization-projects) | 授予对[阻止组织用户 API](/rest/reference/orgs#blocking) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} -| [`页面`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | 授予对[页面 API](/rest/reference/repos#pages) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| `plan` | 授予使用“[获取用户](/rest/reference/users#get-a-user)”端点获取有关用户 GitHub 计划的信息的权限。 可以是以下项之一：`none` 或 `read`。 | -| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | 授予对各种拉取请求端点的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | 授予对[仓库 web 挂钩 API](/rest/reference/repos#hooks) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | 授予对[项目 API](/rest/reference/projects) 的访问权限。 Can be one of: `none`, `read`, `write`, or `admin`.{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} -| [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | Grants access to the [Secret scanning API](/rest/reference/secret-scanning). Can be one of: `none`, `read`, or `write`.{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} -| [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | Grants access to the [Code scanning API](/rest/reference/code-scanning/). 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} -| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | 授予对[内容 API](/rest/reference/repos#contents) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`标星`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | 授予对[标星 API](/rest/reference/activity#starring) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | 授予对[状态 API](/rest/reference/repos#statuses) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | 授予对[团队讨论 API](/rest/reference/teams#discussions) 和[团队讨论注释 API](/rest/reference/teams#discussion-comments) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | -| `vulnerability_alerts` | 授予接收仓库漏洞依赖项安全警报的权限。 更多信息请参阅“[关于漏洞依赖项安全警报](/articles/about-security-alerts-for-vulnerable-dependencies)”。 可以是以下项之一：`none` 或 `read`。 | -| `关注` | 授予列出和更改用户订阅的仓库的权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`页面`](/rest/reference/permissions-required-for-github-apps/#permission-on-pages) | 授予对[页面 API](/rest/reference/repos#pages) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| `plan` | 授予使用“[获取用户](/rest/reference/users#get-a-user)”端点获取有关用户 GitHub 计划的信息的权限。 可以是以下项之一：`none` 或 `read`。 | +| [`pull_requests`](/rest/reference/permissions-required-for-github-apps/#permission-on-pull-requests) | 授予对各种拉取请求端点的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`repository_hooks`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-hooks) | 授予对[仓库 web 挂钩 API](/rest/reference/repos#hooks) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`repository_projects`](/rest/reference/permissions-required-for-github-apps/#permission-on-repository-projects) | 授予对[项目 API](/rest/reference/projects) 的访问权限。 可以是以下项之一：`none`、`read`、`write` 或 `admin`。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} +| [`secret_scanning_alerts`](/rest/reference/permissions-required-for-github-apps/#permission-on-secret-scanning-alerts) | 授予对[密钥扫描 API](/rest/reference/secret-scanning) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} +| [`security_events`](/rest/reference/permissions-required-for-github-apps/#permission-on-security-events) | 授予对[代码扫描 API](/rest/reference/code-scanning/) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% endif %} +| [`single_file`](/rest/reference/permissions-required-for-github-apps/#permission-on-single-file) | 授予对[内容 API](/rest/reference/repos#contents) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`标星`](/rest/reference/permissions-required-for-github-apps/#permission-on-starring) | 授予对[标星 API](/rest/reference/activity#starring) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`statuses`](/rest/reference/permissions-required-for-github-apps/#permission-on-statuses) | 授予对[状态 API](/rest/reference/repos#statuses) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。 | +| [`team_discussions`](/rest/reference/permissions-required-for-github-apps/#permission-on-team-discussions) | 授予对[团队讨论 API](/rest/reference/teams#discussions) 和[团队讨论注释 API](/rest/reference/teams#discussion-comments) 的访问权限。 可以是以下项之一：`none`、`read` 或 `write`。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} +| `vulnerability_alerts` | 授予接收仓库漏洞依赖项安全警报的权限。 更多信息请参阅“[关于漏洞依赖项安全警报](/articles/about-security-alerts-for-vulnerable-dependencies)”。 可以是以下项之一：`none` 或 `read`。{% endif %} +| `关注` | 授予列出和更改用户订阅的仓库的权限。 可以是以下项之一：`none`、`read` 或 `write`。 | ### {% data variables.product.prodname_github_app %} web 挂钩事件 diff --git a/translations/zh-CN/content/developers/apps/deleting-a-github-app.md b/translations/zh-CN/content/developers/apps/deleting-a-github-app.md index e845399f1422..c344cc0aff77 100644 --- a/translations/zh-CN/content/developers/apps/deleting-a-github-app.md +++ b/translations/zh-CN/content/developers/apps/deleting-a-github-app.md @@ -1,5 +1,5 @@ --- -title: Deleting a GitHub App +title: 删除 GitHub 应用程序 intro: '{% data reusables.shortdesc.deleting_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/deleting-a-github-app/ @@ -13,8 +13,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -4. Select the GitHub App you want to delete. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. 选择要删除的 GitHub 应用程序。 ![应用程序选择](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} -6. Click **Delete GitHub App**. ![Button to delete a GitHub App](/assets/images/github-apps/github_apps_delete.png) -7. Type the name of the GitHub App to confirm you want to delete it. ![Field to confirm the name of the GitHub App you want to delete](/assets/images/github-apps/github_apps_delete_integration_name.png) -8. Click **I understand the consequences, delete this GitHub App**. ![Button to confirm the deletion of your GitHub App](/assets/images/github-apps/github_apps_confirm_deletion.png) +6. 单击 **Delete GitHub App（删除 GitHub 应用程序）**。 ![删除 GitHub 应用程序的按钮](/assets/images/github-apps/github_apps_delete.png) +7. 输入 GitHub 应用程序的名称以确认您要删除它。 ![确认要删除的 GitHub 应用程序名称的字段](/assets/images/github-apps/github_apps_delete_integration_name.png) +8. 单击 **I understand the consequences, delete this GitHub App（我了解后果，删除此 GitHub 应用程序）**。 ![确认删除 GitHub 应用程序的按钮](/assets/images/github-apps/github_apps_confirm_deletion.png) diff --git a/translations/zh-CN/content/developers/apps/deleting-an-oauth-app.md b/translations/zh-CN/content/developers/apps/deleting-an-oauth-app.md index a31cc0177634..6bb255ba749a 100644 --- a/translations/zh-CN/content/developers/apps/deleting-an-oauth-app.md +++ b/translations/zh-CN/content/developers/apps/deleting-an-oauth-app.md @@ -1,5 +1,5 @@ --- -title: Deleting an OAuth App +title: 删除 OAuth 应用程序 intro: '{% data reusables.shortdesc.deleting_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/deleting-an-oauth-app/ @@ -13,6 +13,6 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} -4. Select the {% data variables.product.prodname_oauth_app %} you want to modify. ![App selection](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) -5. Click **Delete application**. ![Button to delete the application](/assets/images/oauth-apps/oauth_apps_delete_application.png) -6. Click **Delete this OAuth Application**. ![Button to confirm the deletion](/assets/images/oauth-apps/oauth_apps_delete_confirm.png) +4. 选择要修改的 {% data variables.product.prodname_oauth_app %} 。 ![应用程序选择](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) +5. 单击 **Delete application（删除应用程序）**。 ![删除应用程序的按钮](/assets/images/oauth-apps/oauth_apps_delete_application.png) +6. 单击 **Delete this OAuth Application（删除此 OAuth 应用程序）**。 ![确认删除的按钮](/assets/images/oauth-apps/oauth_apps_delete_confirm.png) 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 73b755d9a01e..c2b3a9e9c89d 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 @@ -1,5 +1,5 @@ --- -title: Editing a GitHub App's permissions +title: 编辑 GitHub 应用程序的权限 intro: '{% data reusables.shortdesc.editing_permissions_for_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/editing-a-github-app-s-permissions/ @@ -12,16 +12,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. +**注：**在帐户或组织的所有者批准更改之前，更新的权限不会对安装设施生效。 您可以使用 [InstallationEvent web 挂钩](/webhooks/event-payloads/#installation)了解用户何时接受应用程序的新权限。 [用户级权限](/apps/building-github-apps/identifying-and-authorizing-users-for-github-apps/#user-level-permissions)是一个例外，它不需要帐户所有者批准权限更改。 {% 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. 单击 **Save changes（保存更改）**。 ![Button to save permissions changes](/assets/images/github-apps/github_apps_save_changes.png) +4. 选择要更改其权限的 GitHub 应用程序。 ![应用程序选择](/assets/images/github-apps/github_apps_select-app.png) +5. 在左侧栏中，单击 **Permissions & webhooks（权限和 web 挂钩）**。 ![权限和 web 挂钩](/assets/images/github-apps/github_apps_permissions_and_webhooks.png) +6. 修改要更改的权限。 对于每种类型的权限，从下拉列表中选择“Read-only（只读）”、“Read & write（读写）”或“No access（无访问权限）”。 ![GitHub 应用程序的权限选择](/assets/images/github-apps/github_apps_permissions_post2dot13.png) +7. 在“Subscribe to events（订阅事件）”中，选择应用程序要订阅的任何事件。 ![GitHub 应用程序订阅事件的权限选择](/assets/images/github-apps/github_apps_permissions_subscribe_to_events.png) +8. （可选）在“Add a note to users（向用户添加注释）”中，添加注释，告诉用户为什么要更改 GitHub 应用程序请求的权限。 ![用于向用户添加注释以解释 GitHub 应用程序权限更改原因的输入框](/assets/images/github-apps/github_apps_permissions_note_to_users.png) +9. 单击 **Save changes（保存更改）**。 ![保存权限更改的按钮](/assets/images/github-apps/github_apps_save_changes.png) diff --git a/translations/zh-CN/content/developers/apps/getting-started-with-apps.md b/translations/zh-CN/content/developers/apps/getting-started-with-apps.md index d6bc3d7a0f13..941e12c74351 100644 --- a/translations/zh-CN/content/developers/apps/getting-started-with-apps.md +++ b/translations/zh-CN/content/developers/apps/getting-started-with-apps.md @@ -1,6 +1,6 @@ --- -title: Getting started with apps -intro: Learn about building apps and setting up your development environment. +title: 应用程序使用入门 +intro: 了解如何构建应用程序和设置开发环境。 mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/developers/apps/guides.md b/translations/zh-CN/content/developers/apps/guides.md index 670620138efa..32e2d576fb39 100644 --- a/translations/zh-CN/content/developers/apps/guides.md +++ b/translations/zh-CN/content/developers/apps/guides.md @@ -1,6 +1,6 @@ --- title: 指南 -intro: 'Learn about using the {% data variables.product.prodname_dotcom %} API with your app, continuous integration, and how to build with apps.' +intro: '了解如何将 {% data variables.product.prodname_dotcom %} API 用于应用程序、持续集成以及如何使用应用程序进行构建。' mapTopic: true redirect_from: - /apps/quickstart-guides 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 4d11be938d6e..ae8667bbce1f 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 @@ -67,7 +67,7 @@ versions: {% endnote %} -将此 `code` 交换为访问令牌。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} 启用过期令牌后，访问令牌将在 8 小时后过期，刷新令牌将在 6 个月后过期。 每次刷新令牌时都会得到一个新的刷新令牌。 更多信息请参阅“[刷新用户到服务器访问令牌](/developers/apps/refreshing-user-to-server-access-tokens)”。 +将此 `code` 交换为访问令牌。 {% if currentversion == "free proteam@latest" %} 启用令牌有效期时，访问令牌在 8 小时后过期，刷新令牌在 6 个月后过期。 每次刷新令牌时都会得到一个新的刷新令牌。 更多信息请参阅“[刷新用户到服务器访问令牌](/developers/apps/refreshing-user-to-server-access-tokens)”。 过期用户令牌当前是用户到服务器令牌过期测试版的一部分，可能会更改。 要选择使用用户到服务器令牌过期测试版功能，请参阅“[激活应用程序的测试版功能](/developers/apps/activating-beta-features-for-apps)”。{% endif %} diff --git a/translations/zh-CN/content/developers/apps/index.md b/translations/zh-CN/content/developers/apps/index.md index 4859c26353ec..5f29987ba134 100644 --- a/translations/zh-CN/content/developers/apps/index.md +++ b/translations/zh-CN/content/developers/apps/index.md @@ -1,6 +1,6 @@ --- title: 应用 -intro: You can automate and streamline your workflow by building your own apps. +intro: 您可以通过构建自己的应用程序来自动化和简化工作流程。 redirect_from: - /early-access/integrations/ - /early-access/integrations/authentication/ diff --git a/translations/zh-CN/content/developers/apps/making-a-github-app-public-or-private.md b/translations/zh-CN/content/developers/apps/making-a-github-app-public-or-private.md index bf01890758e9..3b1ada2270fd 100644 --- a/translations/zh-CN/content/developers/apps/making-a-github-app-public-or-private.md +++ b/translations/zh-CN/content/developers/apps/making-a-github-app-public-or-private.md @@ -1,5 +1,5 @@ --- -title: Making a GitHub App public or private +title: 将 GitHub 应用程序设为公共或私有 intro: '{% data reusables.shortdesc.making-a-github-app-public-or-private %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-github-apps/about-installation-options-for-github-apps/ @@ -13,24 +13,24 @@ versions: github-ae: '*' --- -For authentication information, see "[Authenticating with GitHub Apps](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)." +有关身份验证信息，请参阅“[使用 GitHub 应用程序进行身份验证](/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-an-installation)”。 -### Public installation flow +### 公共安装流程 -Public installation flows have a landing page where users begin the installation flow. This link is provided in the "Public link" field when setting up your GitHub App. For more information, see "[Installing GitHub Apps](/apps/installing-github-apps/)." +公共安装流程有一个供用户开始安装流程的登录页面。 设置您的 GitHub 应用程序时，在“Public link（公共链接）”字段中提供此链接。 更多信息请参阅“[安装 GitHub 应用程序](/apps/installing-github-apps/)”。 -### Private installation flow +### 私有安装流程 -Private installation flows allow only the owner of a GitHub App to install it. Limited information about the GitHub App will still exist on a public page, but the **Install** button will only be available to organization administrators or the user account if the GitHub App is owned by an individual account. Private, or internal, GitHub Apps can only be installed on the user or organization account of the owner. +私有安装流程只允许 GitHub 应用程序的所有者安装它。 有关 GitHub 应用程序的有限信息仍将存在于公共页面，但 **Install（安装）**按钮仅对组织管理员或用户帐户（如果 GitHub 应用程序由个人帐户所有）可用。 私有或内部 GitHub 应用程序只能安装在所有者的用户或组织帐户上。 -### Changing who can install your GitHub App +### 更改 GitHub 应用程序的安装权限 -To change who can install the GitHub App: +要更改 GitHub 应用程序的安装权限： {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} -3. Select the GitHub App whose installation option you want to change. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +3. 选择要更改其安装权限选项的 GitHub 应用程序。 ![应用程序选择](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} -5. Depending on the installation option of your GitHub App, click either **Make public** or **Make internal**. ![Button to change the installation option of your GitHub App](/assets/images/github-apps/github_apps_make_public.png) -6. Depending on the installation option of your GitHub App, click either **Yes, make this GitHub App public** or **Yes, make this GitHub App internal**. ![Button to confirm the change of your installation option](/assets/images/github-apps/github_apps_confirm_installation_option.png) +5. 根据 GitHub 应用程序的安装选项，单击 **Make public（设为公共）**或 **Make internal（设为内部）**。 ![更改 GitHub 应用程序安装选项的按钮](/assets/images/github-apps/github_apps_make_public.png) +6. 根据 GitHub 应用程序的安装选项，单击 **Yes, make this GitHub App public（是，将此 GitHub 应用程序设为公共）**或 **Yes, make this GitHub App internal（是，将此 GitHub 应用程序设为内部）**。 ![确认更改安装选项的按钮](/assets/images/github-apps/github_apps_confirm_installation_option.png) diff --git a/translations/zh-CN/content/developers/apps/managing-github-apps.md b/translations/zh-CN/content/developers/apps/managing-github-apps.md index fb3b9c3934b7..f259894e41e6 100644 --- a/translations/zh-CN/content/developers/apps/managing-github-apps.md +++ b/translations/zh-CN/content/developers/apps/managing-github-apps.md @@ -1,6 +1,6 @@ --- -title: Managing GitHub Apps -intro: 'After you create and register a GitHub App, you can make modifications to the app, change permissions, transfer ownership, and delete the app.' +title: 管理 GitHub 应用程序 +intro: '创建并注册 GitHub 应用程序后，您可以修改应用程序、更改权限、转让所有权和删除应用程序。' mapTopic: true redirect_from: - /apps/building-integrations/managing-github-apps/ diff --git a/translations/zh-CN/content/developers/apps/managing-oauth-apps.md b/translations/zh-CN/content/developers/apps/managing-oauth-apps.md index e1bf769dedc6..53d6365438d8 100644 --- a/translations/zh-CN/content/developers/apps/managing-oauth-apps.md +++ b/translations/zh-CN/content/developers/apps/managing-oauth-apps.md @@ -1,6 +1,6 @@ --- -title: Managing OAuth Apps -intro: 'After you create and register an OAuth App, you can make modifications to the app, change permissions, transfer ownership, and delete the app.' +title: 管理 OAuth 应用程序 +intro: '创建并注册 OAuth 应用程序后，您可以修改应用程序、更改权限、转让所有权和删除应用程序。' mapTopic: true redirect_from: - /apps/building-integrations/managing-oauth-apps/ diff --git a/translations/zh-CN/content/developers/apps/modifying-a-github-app.md b/translations/zh-CN/content/developers/apps/modifying-a-github-app.md index 856b4b8f4c37..f4a666e8d373 100644 --- a/translations/zh-CN/content/developers/apps/modifying-a-github-app.md +++ b/translations/zh-CN/content/developers/apps/modifying-a-github-app.md @@ -1,5 +1,5 @@ --- -title: Modifying a GitHub App +title: 修改 GitHub 应用程序 intro: '{% data reusables.shortdesc.modifying_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/modifying-a-github-app/ @@ -14,5 +14,5 @@ versions: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.github_apps %} {% data reusables.user-settings.modify_github_app %} -5. In "Basic information", modify the GitHub App information that you'd like to change. ![Basic information section for your GitHub App](/assets/images/github-apps/github_apps_basic_information.png) -6. 单击 **Save changes（保存更改）**。 ![Button to save changes for your GitHub App](/assets/images/github-apps/github_apps_save_changes.png) +5. 在“Basic information（基本信息）”中，修改您要更改的 GitHub 应用程序信息。 ![GitHub 应用程序的基本信息部分](/assets/images/github-apps/github_apps_basic_information.png) +6. 单击 **Save changes（保存更改）**。 ![保存 GitHub 应用程序更改的按钮](/assets/images/github-apps/github_apps_save_changes.png) 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 5463c5f9956a..a459d91c3069 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 @@ -1,5 +1,5 @@ --- -title: Modifying an OAuth App +title: 修改 OAuth 应用程序 intro: '{% data reusables.shortdesc.modifying_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/modifying-an-oauth-app/ @@ -14,6 +14,6 @@ versions: {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} {% data reusables.user-settings.modify_oauth_app %} -1. Modify the -{% data variables.product.prodname_oauth_app %} information that you'd like to change. +1. 修改 +要更改的 {% data variables.product.prodname_oauth_app %} 信息。 {% data reusables.user-settings.update_oauth_app %} diff --git a/translations/zh-CN/content/developers/apps/setting-permissions-for-github-apps.md b/translations/zh-CN/content/developers/apps/setting-permissions-for-github-apps.md index ae0b72796dea..bbf5ed8a33a4 100644 --- a/translations/zh-CN/content/developers/apps/setting-permissions-for-github-apps.md +++ b/translations/zh-CN/content/developers/apps/setting-permissions-for-github-apps.md @@ -1,5 +1,5 @@ --- -title: Setting permissions for GitHub Apps +title: 设置 GitHub 应用程序的权限 intro: '{% data reusables.shortdesc.permissions_github_apps %}' redirect_from: - /apps/building-integrations/setting-up-and-registering-github-apps/about-permissions-for-github-apps/ @@ -11,10 +11,10 @@ versions: github-ae: '*' --- -When you create a GitHub App, you can select the permissions it needs to access end user data. Permissions can also be added and removed. For more information, see "[Editing a GitHub App's permissions](/apps/managing-github-apps/editing-a-github-app-s-permissions/)." +创建 GitHub 应用程序时，您可以选择访问最终用户数据所需的权限。 还可以添加和删除权限。 更多信息请参阅“[编辑 GitHub 应用程序的权限](/apps/managing-github-apps/editing-a-github-app-s-permissions/)”。 ### 元数据权限 -By default, GitHub Apps have `Read-only` access to metadata endpoints. Metadata is a collection of read-only endpoints that provide general information about resources that the authorized installation can access. +默认情况下，GitHub 应用程序对元数据端点具有 `Read-only` 权限。 元数据是只读终结点的集合，提供有关授权安装设施可访问资源的一般信息。 -{% data reusables.apps.metadata-permissions %} For a list of metadata endpoints, see "[Metadata permissions](/rest/reference/permissions-required-for-github-apps#metadata-permissions)." +{% data reusables.apps.metadata-permissions %} 有关元数据端点的列表，请参阅“[元数据权限](/rest/reference/permissions-required-for-github-apps#metadata-permissions)”。 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 a5f289705b52..325b1a04fa68 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 @@ -1,5 +1,5 @@ --- -title: Suspending a GitHub App installation +title: 挂起 GitHub 应用程序安装 intro: '{% data reusables.shortdesc.suspending_a_github_app %}' redirect_from: - /apps/managing-github-apps/suspending-a-github-app-installation @@ -7,25 +7,23 @@ versions: free-pro-team: '*' --- -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} {% note %} **注：**{% data reusables.pre-release-program.suspend-installation-beta %} {% endnote %} -{% endif %} -### Suspending a GitHub App +### 挂起 GitHub 应用程序 -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). +拥有和维护 GitHub 应用程序的集成者（也称为 GitHub 应用程序所有者）可以使用具有 JWT 的 REST API 端点来挂起或取消挂起 GitHub 应用程序安装设施。 更多信息请参阅“[GitHub 应用程序 REST API](/rest/reference/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/)”。 +安装 GitHub 应用程序的人（也称为安装设施所有者）只能通过其应用程序的安装设置来挂起或取消挂起 GitHub 应用程序。 安装设施所有者不能使用 API 来挂起或取消挂起其应用程序安装设施。 在用户可以挂起 GitHub 应用程序安装设施之前，GitHub 应用程序所有者必须选择加入测试版。 更多信息请参阅“[挂起 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. 选择 -{% data variables.product.prodname_github_app %} you want to suspend. -![App selection](/assets/images/github-apps/github_apps_select-app.png) +要挂起的 {% data variables.product.prodname_github_app %}。 +![应用程序选择](/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) +6. 在安装设施的挂起设置旁边，单击 **Suspend（挂起）**或 **Unsuspend（取消挂起）**。 ![挂起 GitHub 应用程序](/assets/images/github-apps/suspend-a-github-app.png) diff --git a/translations/zh-CN/content/developers/apps/transferring-ownership-of-a-github-app.md b/translations/zh-CN/content/developers/apps/transferring-ownership-of-a-github-app.md index ea865da97cb9..74cb49782c54 100644 --- a/translations/zh-CN/content/developers/apps/transferring-ownership-of-a-github-app.md +++ b/translations/zh-CN/content/developers/apps/transferring-ownership-of-a-github-app.md @@ -1,5 +1,5 @@ --- -title: Transferring ownership of a GitHub App +title: 转让 GitHub 应用程序的所有权 intro: '{% data reusables.shortdesc.transferring_ownership_of_github_apps %}' redirect_from: - /apps/building-integrations/managing-github-apps/transferring-ownership-of-a-github-app/ @@ -13,9 +13,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 ownership you want to transfer. ![App selection](/assets/images/github-apps/github_apps_select-app.png) +4. 选择要转让其所有权的 GitHub 应用程序。 ![应用程序选择](/assets/images/github-apps/github_apps_select-app.png) {% data reusables.user-settings.github_apps_advanced %} -6. Click **Transfer ownership**. ![Button to transfer ownership](/assets/images/github-apps/github_apps_transfer_ownership.png) -7. Type the name of the GitHub App you want to transfer. ![Field to enter the name of the app to transfer](/assets/images/github-apps/github_apps_transfer_app_name.png) -8. Type the name of the user or organization you want to transfer the GitHub App to. ![Field to enter the user or org to transfer to](/assets/images/github-apps/github_apps_transfer_new_owner.png) -9. Click **Transfer this GitHub App**. ![Button to confirm the transfer of a GitHub App](/assets/images/github-apps/github_apps_transfer_integration.png) +6. 单击 **Transfer ownership（转让所有权）**。 ![转让所有权的按钮](/assets/images/github-apps/github_apps_transfer_ownership.png) +7. 输入要转让的 GitHub 应用程序的名称。 ![输入要转让的应用程序名称的字段](/assets/images/github-apps/github_apps_transfer_app_name.png) +8. 输入要将 GitHub 应用程序转让到的用户或组织的名称。 ![输入要转让到的用户或组织的字段](/assets/images/github-apps/github_apps_transfer_new_owner.png) +9. 单击 **Transfer this GitHub App（转让此 GitHub 应用程序）**。 ![确认转让 GitHub 应用程序的按钮](/assets/images/github-apps/github_apps_transfer_integration.png) diff --git a/translations/zh-CN/content/developers/apps/transferring-ownership-of-an-oauth-app.md b/translations/zh-CN/content/developers/apps/transferring-ownership-of-an-oauth-app.md index 4f1cdbe51286..c82c7df4e816 100644 --- a/translations/zh-CN/content/developers/apps/transferring-ownership-of-an-oauth-app.md +++ b/translations/zh-CN/content/developers/apps/transferring-ownership-of-an-oauth-app.md @@ -1,5 +1,5 @@ --- -title: Transferring ownership of an OAuth App +title: 转让 OAuth 应用程序的所有权 intro: '{% data reusables.shortdesc.transferring_ownership_of_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/transferring-ownership-of-an-oauth-app/ @@ -13,8 +13,8 @@ versions: {% data reusables.user-settings.access_settings %} {% data reusables.user-settings.developer_settings %} {% data reusables.user-settings.oauth_apps %} -4. Select the {% data variables.product.prodname_oauth_app %} you want to modify. ![App selection](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) -5. Click **Transfer ownership**. ![Button to transfer ownership](/assets/images/oauth-apps/oauth_apps_transfer_ownership.png) -6. Type the name of the {% data variables.product.prodname_oauth_app %} you want to transfer. ![Field to enter the name of the app to transfer](/assets/images/oauth-apps/oauth_apps_transfer_oauth_name.png) -7. Type the name of the user or organization you want to transfer the {% data variables.product.prodname_oauth_app %} to. ![Field to enter the user or org to transfer to](/assets/images/oauth-apps/oauth_apps_transfer_new_owner.png) -8. Click **Transfer this application**. ![Button to transfer the application](/assets/images/oauth-apps/oauth_apps_transfer_application.png) +4. 选择要修改的 {% data variables.product.prodname_oauth_app %} 。 ![应用程序选择](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) +5. 单击 **Transfer ownership（转让所有权）**。 ![转让所有权的按钮](/assets/images/oauth-apps/oauth_apps_transfer_ownership.png) +6. 输入要转让的 {% data variables.product.prodname_oauth_app %} 的名称。 ![输入要转让的应用程序名称的字段](/assets/images/oauth-apps/oauth_apps_transfer_oauth_name.png) +7. 输入要将 {% data variables.product.prodname_oauth_app %} 转让到的用户或组织的名称。 ![输入要转让到的用户或组织的字段](/assets/images/oauth-apps/oauth_apps_transfer_new_owner.png) +8. 单击 **Transfer this application（转让此应用程序）**。 ![转让应用程序的按钮](/assets/images/oauth-apps/oauth_apps_transfer_application.png) diff --git a/translations/zh-CN/content/developers/apps/troubleshooting-authorization-request-errors.md b/translations/zh-CN/content/developers/apps/troubleshooting-authorization-request-errors.md index ff6624c958c7..abf92904e064 100644 --- a/translations/zh-CN/content/developers/apps/troubleshooting-authorization-request-errors.md +++ b/translations/zh-CN/content/developers/apps/troubleshooting-authorization-request-errors.md @@ -1,5 +1,5 @@ --- -title: Troubleshooting authorization request errors +title: 排查授权请求错误 intro: '{% data reusables.shortdesc.troubleshooting_authorization_request_errors_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/troubleshooting-authorization-request-errors/ @@ -10,35 +10,35 @@ versions: github-ae: '*' --- -### Application suspended +### 应用程序已挂起 -If the OAuth App you set up has been suspended (due to reported abuse, spam, or a mis-use of the API), GitHub will redirect to the registered callback URL using the following parameters to summarize the error: +如果您设置的 OAuth 应用程序已挂起（由于报告的滥用、垃圾邮件或 API 使用不当），GitHub 将使用以下参数重定向到注册的回调 URL 以总结错误： http://your-application.com/callback?error=application_suspended &error_description=Your+application+has+been+suspended.+Contact+support@github.com. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23application-suspended &state=xyz -To solve issues with suspended applications, please contact {% data variables.contact.contact_support %}. +要解决已挂起应用程序的问题，请联系 {% data variables.contact.contact_support %}。 -### Redirect URI mismatch +### 重定向 URI 不匹配 -If you provide a `redirect_uri` that doesn't match what you've registered with your application, GitHub will redirect to the registered callback URL with the following parameters summarizing the error: +如果您提供的 `redirect_uri` 与您在应用程序中注册的 URL 不匹配，GitHub 将使用以下参数重定向到注册的回调 URL 以总结错误： http://your-application.com/callback?error=redirect_uri_mismatch &error_description=The+redirect_uri+MUST+match+the+registered+callback+URL+for+this+application. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23redirect-uri-mismatch &state=xyz -To correct this error, either provide a `redirect_uri` that matches what you registered or leave out this parameter to use the default one registered with your application. +要更正此错误，请提供一个与您注册的 URL 匹配的 `redirect_uri`，或者忽略此参数以使用在应用程序中注册的默认 URL。 -#### Access denied +#### 访问被拒绝 -If the user rejects access to your application, GitHub will redirect to the registered callback URL with the following parameters summarizing the error: +如果用户拒绝访问您的应用程序，GitHub 将使用以下参数重定向到注册的回调 URL 以总结错误： http://your-application.com/callback?error=access_denied &error_description=The+user+has+denied+your+application+access. &error_uri=/apps/building-integrations/setting-up-and-registering-oauth-apps/troubleshooting-authorization-request-errors/%23access-denied &state=xyz -There's nothing you can do here as users are free to choose not to use your application. More often than not, users will just close the window or press back in their browser, so it is likely that you'll never see this error. +在这方面您无能为力，因为用户可以自由选择不使用您的应用程序。 通常，用户只是关闭窗口或在浏览器中按返回按钮，所以您可能永远不会看到此错误。 diff --git a/translations/zh-CN/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md b/translations/zh-CN/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md index c38a7f4ca121..9a89341aff89 100644 --- a/translations/zh-CN/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md +++ b/translations/zh-CN/content/developers/apps/troubleshooting-oauth-app-access-token-request-errors.md @@ -1,5 +1,5 @@ --- -title: Troubleshooting OAuth App access token request errors +title: 排查 OAuth 应用程序访问令牌请求错误 intro: '{% data reusables.shortdesc.troubleshooting_access_token_reques_errors_oauth_apps %}' redirect_from: - /apps/building-integrations/managing-oauth-apps/troubleshooting-oauth-app-access-token-request-errors/ @@ -12,13 +12,13 @@ versions: {% note %} -**Note:** These examples only show JSON responses. +**注：**这些示例仅显示 JSON 响应。 {% endnote %} -### Incorrect client credentials +### 客户端凭据不正确 -If the client\_id and or client\_secret you pass are incorrect you will receive this error response. +如果您传递的 client\_id 和/或 client\_secret 不正确，您将收到此错误响应。 ```json { @@ -28,11 +28,11 @@ If the client\_id and or client\_secret you pass are incorrect you will receive } ``` -To solve this error, make sure you have the correct credentials for your {% data variables.product.prodname_oauth_app %}. Double check the `client_id` and `client_secret` to make sure they are correct and being passed correctly to {% data variables.product.product_name %}. +要解决此错误，请确保您拥有 {% data variables.product.prodname_oauth_app %} 的正确凭据。 仔细检查 `client_id` 和 `client_secret` 以确保它们正确无误并且正确地传递到 {% data variables.product.product_name %}。 -### Redirect URI mismatch +### 重定向 URI 不匹配 -If you provide a `redirect_uri` that doesn't match what you've registered with your {% data variables.product.prodname_oauth_app %}, you'll receive this error message: +如果您提供的 `redirect_uri` 与您在 {% data variables.product.prodname_oauth_app %} 中注册的 URL 不匹配，您将收到此错误消息： ```json { @@ -42,9 +42,9 @@ If you provide a `redirect_uri` that doesn't match what you've registered with y } ``` -To correct this error, either provide a `redirect_uri` that matches what you registered or leave out this parameter to use the default one registered with your application. +要更正此错误，请提供一个与您注册的 URL 匹配的 `redirect_uri`，或者忽略此参数以使用在应用程序中注册的默认 URL。 -### Bad verification code +### 验证码错误 ```json { @@ -55,7 +55,7 @@ To correct this error, either provide a `redirect_uri` that matches what you reg } ``` -If the verification code you pass is incorrect, expired, or doesn't match what you received in the first request for authorization you will receive this error. +如果您传递的验证码不正确、已过期或与您在第一次授权请求中收到的验证码不匹配，您将收到此错误。 ```json { @@ -65,4 +65,4 @@ If the verification code you pass is incorrect, expired, or doesn't match what y } ``` -To solve this error, start the [OAuth authorization process again](/apps/building-oauth-apps/authorizing-oauth-apps/) and get a new code. +要解决此错误，请再次启动 [OAuth 授权流程](/apps/building-oauth-apps/authorizing-oauth-apps/)并获取新代码。 diff --git a/translations/zh-CN/content/developers/apps/using-content-attachments.md b/translations/zh-CN/content/developers/apps/using-content-attachments.md index d7582d7d8653..4e88ff4b01f9 100644 --- a/translations/zh-CN/content/developers/apps/using-content-attachments.md +++ b/translations/zh-CN/content/developers/apps/using-content-attachments.md @@ -166,7 +166,7 @@ curl -X "POST" "https://api.github.com/graphql" \ } ``` -4. [在本地运行 GitHub 应用程序](https://probot.github.io/docs/development/#running-the-app-locally)。 导航到 [localhost:3000](http://localhost:3000)， 然后单击 **Register GitHub App（注册 GitHub 应用程序）**按钮： +4. [在本地运行 GitHub 应用程序](https://probot.github.io/docs/development/#running-the-app-locally)。 导航到 `http://localhost:3000`， 然后单击 **Register GitHub App（注册 GitHub 应用程序）**按钮： ![注册 Probot GitHub 应用程序](/assets/images/github-apps/github_apps_probot-registration.png) diff --git a/translations/zh-CN/content/developers/github-marketplace/about-github-marketplace.md b/translations/zh-CN/content/developers/github-marketplace/about-github-marketplace.md index 6b9a0d183d23..4c93f7e86611 100644 --- a/translations/zh-CN/content/developers/github-marketplace/about-github-marketplace.md +++ b/translations/zh-CN/content/developers/github-marketplace/about-github-marketplace.md @@ -1,6 +1,6 @@ --- title: 关于 GitHub Marketplace -intro: 'Learn about {% data variables.product.prodname_marketplace %} where you can share your apps and actions publicly with all {% data variables.product.product_name %} users.' +intro: '了解 {% data variables.product.prodname_marketplace %}，您可以在其中向所有 {% data variables.product.product_name %} 用户公开分享您的应用程序和操作。' redirect_from: - /apps/marketplace/getting-started/ - /marketplace/getting-started @@ -14,41 +14,41 @@ versions: {% data reusables.actions.actions-not-verified %} -To learn about publishing {% data variables.product.prodname_actions %} in {% data variables.product.prodname_marketplace %}, see "[Publishing actions in GitHub Marketplace](/actions/creating-actions/publishing-actions-in-github-marketplace)." +要了解如何在 {% data variables.product.prodname_marketplace %} 中发布 {% data variables.product.prodname_actions %}，请参阅“[在 GitHub Marketplace 中发布操作](/actions/creating-actions/publishing-actions-in-github-marketplace)”。 ### 应用 -Anyone can share their apps with other users on {% data variables.product.prodname_marketplace %} but only listings that are verified by {% data variables.product.company_short %} can include paid plans. For more information, see "[About verified creators](/developers/github-marketplace/about-verified-creators)." +任何人都可以在 {% data variables.product.prodname_marketplace %} 上与其他用户分享其应用程序，但只有经 {% data variables.product.company_short %} 验证的上架产品才能包含付费计划。 更多信息请参阅“[关于经验证的创作者](/developers/github-marketplace/about-verified-creators)”。 -If you're interested in creating an app for {% data variables.product.prodname_marketplace %}, but you're new to {% data variables.product.prodname_github_apps %} or {% data variables.product.prodname_oauth_app %}s, see "[Building {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)" or "[Building {% data variables.product.prodname_oauth_app %}s](/developers/apps/building-oauth-apps)." +如果您有兴趣为 {% data variables.product.prodname_marketplace %} 创建应用程序，但对于 {% data variables.product.prodname_github_apps %} 或 {% data variables.product.prodname_oauth_app %} 比较陌生，请参阅“[构建 {% data variables.product.prodname_github_apps %}](/developers/apps/building-github-apps)”或“[构建 {% data variables.product.prodname_oauth_app %}](/developers/apps/building-oauth-apps)”。 -{% data reusables.marketplace.github_apps_preferred %}，尽管您可以在 {% data variables.product.prodname_marketplace %} 中上架 OAuth 和 {% data variables.product.prodname_github_app %}。 For more information, see "[Differences between {% data variables.product.prodname_github_apps %} and {% data variables.product.prodname_oauth_app %}s](/apps/differences-between-apps/)" and "[Migrating {% data variables.product.prodname_oauth_app %}s to {% data variables.product.prodname_github_apps %}](/apps/migrating-oauth-apps-to-github-apps/)." +{% data reusables.marketplace.github_apps_preferred %}，尽管您可以在 {% data variables.product.prodname_marketplace %} 中上架 OAuth 和 {% data variables.product.prodname_github_app %}。 更多信息请参阅“[{% data variables.product.prodname_github_apps %} 与 {% data variables.product.prodname_oauth_app %} 之间的差异](/apps/differences-between-apps/)”和“[将 {% data variables.product.prodname_oauth_app %} 迁移到 {% data variables.product.prodname_github_apps %}](/apps/migrating-oauth-apps-to-github-apps/)”。 如果您对 {% data variables.product.prodname_marketplace %} 有疑问，请直接联系 {% data variables.contact.contact_support %}。 -### Publishing an app to {% data variables.product.prodname_marketplace %} +### 将应用程序发布到 {% data variables.product.prodname_marketplace %} -When you have finished creating your app, you can share it with other users by publishing it to {% data variables.product.prodname_marketplace %}. In summary, the process is: +完成创建应用程序后，您可以将其发布到 {% data variables.product.prodname_marketplace %}，以便与其他用户分享它。 过程归纳如下： -1. Review your app carefully to ensure that it will behave as expected in other repositories and that it follows best practice guidelines. For more information, see "[Security best practices for apps](/developers/github-marketplace/security-best-practices-for-apps)" and "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app#best-practice-for-customer-experience)." +1. 仔细检查您的应用程序，以确保它在其他仓库中的行为与预期一致，并且遵循最佳实践指南。 更多信息请参阅“[应用程序的安全最佳实践](/developers/github-marketplace/security-best-practices-for-apps)”和“[上架应用程序的要求](/developers/github-marketplace/requirements-for-listing-an-app#best-practice-for-customer-experience)”。 -1. Add webhook events to the app to track user billing requests. For more information about the {% data variables.product.prodname_marketplace %} API, webhook events, and billing requests, see "[Using the {% data variables.product.prodname_marketplace %} API in your app](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)." +1. 将 web 挂钩事件添加到应用程序以跟踪用户帐单请求。 有关 {% data variables.product.prodname_marketplace %} API、web 挂钩事件以及帐单请求的更多信息，请参阅“[在应用程序中使用 {% data variables.product.prodname_marketplace %} API](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)”。 -1. Create a draft {% data variables.product.prodname_marketplace %} listing. For more information, see "[Drafting a listing for your app](/developers/github-marketplace/drafting-a-listing-for-your-app)." +1. 创建 {% data variables.product.prodname_marketplace %} 上架信息草稿。 更多信息请参阅“[起草应用程序上架信息](/developers/github-marketplace/drafting-a-listing-for-your-app)”。 -1. Add a pricing plan. For more information, see "[Setting pricing plans for your listing](/developers/github-marketplace/setting-pricing-plans-for-your-listing)." +1. 添加定价计划。 更多信息请参阅“[为上架产品设置定价计划](/developers/github-marketplace/setting-pricing-plans-for-your-listing)”。 -1. Check whether your app meets the requirements for listing on {% data variables.product.prodname_marketplace %} as a free or a paid app. For more information, see "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)." +1. 检查您的应用程序是否满足在 {% data variables.product.prodname_marketplace %} 中作为免费或付费应用程序上架的要求。 更多信息请参阅“[上架应用程序的要求](/developers/github-marketplace/requirements-for-listing-an-app)”。 -1. Read and accept the terms of the "[{% data variables.product.prodname_marketplace %} Developer Agreement](/articles/github-marketplace-developer-agreement/)." +1. 阅读并接受“[{% data variables.product.prodname_marketplace %} 开发者协议](/articles/github-marketplace-developer-agreement/)”的条款。 -1. Submit your listing for publication in {% data variables.product.prodname_marketplace %}, requesting verification if you want to sell the app. For more information, see "[Submitting your listing for publication](/developers/github-marketplace/submitting-your-listing-for-publication)." +1. 提交要在 {% data variables.product.prodname_marketplace %} 中发布的上架信息，如果要出售应用程序，还需要请求验证。 更多信息请参阅“[提交要发布的上架信息](/developers/github-marketplace/submitting-your-listing-for-publication)”。 -An onboarding expert will contact you with any questions or further steps. For example, if you have added a paid plan, you will need to complete the verification process and complete financial onboarding. As soon as your listing is approved the app is published to {% data variables.product.prodname_marketplace %}. +上架专家将联系您，提出一些问题或要求您完成其他步骤。 例如，如果您添加了付费计划，则需要完成验证过程并完成财务手续。 一旦您的上架信息得到批准，应用程序将发布到 {% data variables.product.prodname_marketplace %}。 -### Seeing how your app is performing +### 查看应用程序的表现 -You can access metrics and transactions for your listing. 更多信息请参阅： +您可以访问上架产品的指标和交易。 更多信息请参阅： -- "[Viewing metrics for your listing](/developers/github-marketplace/viewing-metrics-for-your-listing)" -- "[Viewing transactions for your listing](/developers/github-marketplace/viewing-transactions-for-your-listing)" +- “[查看上架产品的指标](/developers/github-marketplace/viewing-metrics-for-your-listing)” +- “[查看上架产品的交易](/developers/github-marketplace/viewing-transactions-for-your-listing)” diff --git a/translations/zh-CN/content/developers/github-marketplace/about-verified-creators.md b/translations/zh-CN/content/developers/github-marketplace/about-verified-creators.md index f5141317c7e7..d4f755772ba5 100644 --- a/translations/zh-CN/content/developers/github-marketplace/about-verified-creators.md +++ b/translations/zh-CN/content/developers/github-marketplace/about-verified-creators.md @@ -1,43 +1,43 @@ --- -title: About verified creators -intro: 'Each organization that wants to sell apps on {% data variables.product.prodname_marketplace %} must follow a verification process. Their identity is checked and their billing process reviewed.' +title: 关于经验证的创作者 +intro: '每个要在 {% data variables.product.prodname_marketplace %} 上出售应用程序的组织必须遵循验证流程。 需要检查其身份并审查其帐单流程。' versions: free-pro-team: '*' --- -### About verified creators +### 关于经验证的创作者 -A verified creator is an organization that {% data variables.product.company_short %} has checked. Anyone can share their apps with other users on {% data variables.product.prodname_marketplace %} but only organizations that are verified by {% data variables.product.company_short %} can sell apps. For more information about organizations, see "[About organizations](/github/setting-up-and-managing-organizations-and-teams/about-organizations)." +经验证的创作者是经过 {% data variables.product.company_short %} 检查的组织。 任何人都可以在 {% data variables.product.prodname_marketplace %} 上与其他用户分享其应用程序，但只有经 {% data variables.product.company_short %} 验证的组织才能出售应用程序。 有关组织的更多信息，请参阅“[关于组织](/github/setting-up-and-managing-organizations-and-teams/about-organizations)”。 -The verification process aims to protect users. For example, it verifies the seller's identity, checks that their {% data variables.product.product_name %} organization is set up securely, and that they can be contacted for support. +验证过程旨在保护用户。 例如，它验证卖方的身份，检查其 {% data variables.product.product_name %} 组织是否安全设置，以及是否可以联系他们获得支持。 -After passing the verification checks, any apps that the organization lists on {% data variables.product.prodname_marketplace %} are shown with a verified creator badge {% octicon "verified" aria-label="Verified creator badge" %}. The organization can now add paid plans to any of their apps. Each app with a paid plan also goes through a financial onboarding process to check that it's set up to handle billing correctly. +验证检查通过后，该组织在 {% data variables.product.prodname_marketplace %} 中上架的任何应用程序都会显示已验证创作者徽章 {% octicon "verified" aria-label="Verified creator badge" %}。 组织现在可以将付费计划添加到其任何应用程序。 每个带有付费计划的应用程序还要通过财务上架流程来检查其是否设置了适当的帐单处理程序。 -![verified creator badges](/assets/images/marketplace/marketplace_verified_creator_badges_apps.png) +![已验证创作者徽章](/assets/images/marketplace/marketplace_verified_creator_badges_apps.png) -In addition to the verified creator badge, you'll also see badges for unverified and verified apps. These apps were published using the old method for verifying individual apps. +除了已验证创建者徽章外，您还将看到未验证和已验证的应用程序徽章。 这些应用程序是使用针对单个应用程序进行验证的旧方法来发布的。 ![绿色的已验证和灰色的未验证徽章](/assets/images/marketplace/marketplace_verified_badges.png) -For information on finding apps to use, see "[Searching {% data variables.product.prodname_marketplace %}](/github/searching-for-information-on-github/searching-github-marketplace)." +有关如何查找要使用的应用程序，请参阅“[搜索 {% data variables.product.prodname_marketplace %}](/github/searching-for-information-on-github/searching-github-marketplace)”。 -### About the verification process +### 关于验证流程 -The first time you request verification for a listing of one of your apps, you will enter the verification process. An onboarding expert will guide you through the process. This includes checking: +首次请求验证应用程序上架信息时，您将进入验证流程。 上架专家将指导您完成整个流程。 这包括检查： -- Profile information - The basic profile information is populated accurately and appropriately. -- Security - The organization has enabled two-factor authentication. -- Verified domain - The organization has verified the domain of the site URL. -- Purchase webhook event - The event is handled correctly by the app. +- 个人资料信息 - 准确、适当地填写基本个人资料信息。 +- 安全性 - 组织已启用双重身份验证。 +- 已验证域 - 组织已验证站点 URL 的域。 +- 购买 web 挂钩事件 - 应用程序能够正确处理该事件。 -When your organization is verified, all your apps are shown with a verified creator badge. You are now able to offer paid plans for any of your apps. +您的组织通过验证后，您的所有应用程序都会显示已验证创作者徽章。 您现在可以为您的任何应用程序提供付费计划。 -For more information about the requirements for listing an app on {% data variables.product.prodname_marketplace %}, see "[Requirements for listing an app on {% data variables.product.prodname_marketplace %}](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)." +有关在 {% data variables.product.prodname_marketplace %} 中上架应用程序的要求，请参阅“[在 {% data variables.product.prodname_marketplace %} 中上架应用程序的要求](/marketplace/getting-started/requirements-for-listing-an-app-on-github-marketplace/)”。 {% data reusables.marketplace.app-transfer-to-org-for-verification %} 有关如何进行验证，请参阅“[提交要发布的上架信息](/developers/github-marketplace/submitting-your-listing-for-publication#transferring-an-app-to-an-organization-before-you-submit)”。 {% note %} -**Note:** This verification process for apps replaces the previous process where individual apps were verified. The current process is similar to the verification process for actions. If you have apps that were verified under the old process, these will not be affected by the changes. The {% data variables.product.prodname_marketplace %} team will contact you with details of how to migrate to organization-based verification. +**注：**此应用程序验证流程将取代以前针对单个应用程序的验证流程。 当前流程类似于操作的验证流程。 在旧流程下验证的应用程序将不会受到流程变更的影响。 {% data variables.product.prodname_marketplace %} 团队将联系您，提供如何迁移到基于组织的验证的详细信息。 {% endnote %} diff --git a/translations/zh-CN/content/developers/github-marketplace/creating-apps-for-github-marketplace.md b/translations/zh-CN/content/developers/github-marketplace/creating-apps-for-github-marketplace.md index 6e9061cc668d..1d932b4bde5f 100644 --- a/translations/zh-CN/content/developers/github-marketplace/creating-apps-for-github-marketplace.md +++ b/translations/zh-CN/content/developers/github-marketplace/creating-apps-for-github-marketplace.md @@ -1,9 +1,8 @@ --- -title: Creating apps for GitHub Marketplace +title: 为 GitHub Marketplace 创建应用程序 intro: '您可以在 {% data variables.product.prodname_marketplace %} 中上架免费和付费的工具，供开发者使用。' mapTopic: true versions: free-pro-team: '*' - enterprise-server: '*' --- diff --git a/translations/zh-CN/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md b/translations/zh-CN/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md index 4107fa4427f4..02e2e61ae707 100644 --- a/translations/zh-CN/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md +++ b/translations/zh-CN/content/developers/github-marketplace/customer-experience-best-practices-for-apps.md @@ -1,20 +1,20 @@ --- -title: Customer experience best practices for apps -intro: 'Guidelines for creating an app that will be easy to use and understand.' -shortTitle: Customer experience best practice +title: 应用程序的客户体验最佳实践 +intro: '指导您创建易于使用和理解的应用程序。' +shortTitle: 客户体验最佳实践 versions: free-pro-team: '*' --- -If you follow these best practices it will help you to provide a good customer experience. +遵循这些最佳实践将有助于您提供良好的客户体验。 -### Customer communication +### 客户沟通 -- Marketing materials for the app should accurately represent the app's behavior. -- Apps should include links to user-facing documentation that describe how to set up and use the app. -- Customers should be able to see what type of plan they have in the billing, profile, or account settings section of the app. -- Customers should be able to install and use your app on both a personal account and an organization account. They should be able to view and manage the app on those accounts separately. +- 应用程序的营销材料应准确反映应用程序的行为。 +- 应用程序应包含面向用户的文档的链接，这些文档介绍如何设置和使用应用程序。 +- 客户应该能够在应用程序的帐单、配置文件或帐户设置部分看到他们在使用什么类型的计划。 +- 客户应该能够在个人帐户和组织帐户上安装和使用您的应用程序。 他们应该能够单独查看和管理这些帐户上的应用程序。 -### Plan management +### 计划管理 {% data reusables.marketplace.marketplace-billing-ui-requirements %} diff --git a/translations/zh-CN/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md b/translations/zh-CN/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md index 58924a15d0ef..480cbeb3b4e4 100644 --- a/translations/zh-CN/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md +++ b/translations/zh-CN/content/developers/github-marketplace/listing-an-app-on-github-marketplace.md @@ -1,6 +1,6 @@ --- -title: Listing an app on GitHub Marketplace -intro: 'Learn about requirements and best practices for listing your app on {% data variables.product.prodname_marketplace %}.' +title: 在 GitHub Marketplace 中上架应用程序 +intro: '了解在 {% data variables.product.prodname_marketplace %} 中上架应用程序的要求和最佳实践。' mapTopic: true redirect_from: - /apps/adding-integrations/listing-apps-on-github-marketplace/ diff --git a/translations/zh-CN/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md b/translations/zh-CN/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md index 7ac1291fd0a1..87b8026fa086 100644 --- a/translations/zh-CN/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md +++ b/translations/zh-CN/content/developers/github-marketplace/pricing-plans-for-github-marketplace-apps.md @@ -48,7 +48,7 @@ versions: 免费试用的固定期限为 14 天。 客户在试用期结束前 4 天（免费试用期第 11 天）收到通知，他们的计划将升级。 在免费试用结束时，如果客户不取消，他们将自动注册到他们正在试用的计划中。 -更多信息请参阅“[处理新购买和免费试用](/developers/github-marketplace/integrating-with-the-github-marketplace-api/handling-new-purchases-and-free-trials/)”。 +更多信息请参阅“[处理新购买和免费试用](/developers/github-marketplace/handling-new-purchases-and-free-trials/)”。 {% note %} diff --git a/translations/zh-CN/content/developers/github-marketplace/receiving-payment-for-app-purchases.md b/translations/zh-CN/content/developers/github-marketplace/receiving-payment-for-app-purchases.md index 3c8a760f5854..dc98c350d713 100644 --- a/translations/zh-CN/content/developers/github-marketplace/receiving-payment-for-app-purchases.md +++ b/translations/zh-CN/content/developers/github-marketplace/receiving-payment-for-app-purchases.md @@ -1,6 +1,6 @@ --- -title: Receiving payment for app purchases -intro: 'At the end of each month, you''ll receive payment for your {% data variables.product.prodname_marketplace %} listing.' +title: 接收应用程序购买的付款 +intro: '在每个月末，您将收到您的 {% data variables.product.prodname_marketplace %} 上架产品的付款。' redirect_from: - /apps/adding-integrations/managing-pricing-and-payments-for-a-github-marketplace-listing/receiving-payment-for-a-github-marketplace-listing/ - /apps/marketplace/managing-pricing-and-payments-for-a-github-marketplace-listing/receiving-payment-for-a-github-marketplace-listing/ @@ -13,8 +13,14 @@ versions: -After your {% data variables.product.prodname_marketplace %} listing is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the onboarding process. +After your {% data variables.product.prodname_marketplace %} listing for an app with a paid plan is created and approved, you'll provide payment details to {% data variables.product.product_name %} as part of the financial onboarding process. -Once your revenue reaches a minimum of $500 U.S. Dollars for the month, you'll receive an electronic payment from {% data variables.product.product_name %} for 75% of the sales price. +Once your revenue reaches a minimum of $500 US dollars for the month, you'll receive an electronic payment from {% data variables.product.company_short %}. This will be the income from marketplace transactions minus the amount charged by {% data variables.product.company_short %} to cover their running costs. -{% data reusables.apps.marketplace_revenue_share %} +For transactions made before January 1, 2021, {% data variables.product.company_short %} retains 25% of transaction income. For transactions made after that date, only 5% is retained by {% data variables.product.company_short %}. This change will be reflected in payments received from the end of January 2021 onward. + +{% note %} + +**Note:** For details of the current pricing and payment terms, see "[{% data variables.product.prodname_marketplace %} developer agreement](/github/site-policy/github-marketplace-developer-agreement)." + +{% endnote %} diff --git a/translations/zh-CN/content/developers/github-marketplace/requirements-for-listing-an-app.md b/translations/zh-CN/content/developers/github-marketplace/requirements-for-listing-an-app.md index 750bf5b37b13..bf3f0debce47 100644 --- a/translations/zh-CN/content/developers/github-marketplace/requirements-for-listing-an-app.md +++ b/translations/zh-CN/content/developers/github-marketplace/requirements-for-listing-an-app.md @@ -53,7 +53,7 @@ versions: - {% data variables.product.prodname_github_app %} 应至少有 100 个安装设施。 - {% data variables.product.prodname_oauth_app %} 应至少有 200 个用户。 - 所有付费应用程序必须处理关于新购买、升级、降级、取消和免费试用的 {% data variables.product.prodname_marketplace %} 购买事件。 更多信息请参阅下面的“[付费应用程序的计费要求](#billing-requirements-for-paid-apps)”。 -- 发布组织必须具有经过验证的域，并且必须启用双重身份验证。 更多信息请参阅“[在组织中要求双重身份验证](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization.")”。 +- 发布组织必须具有经过验证的域，并且必须启用双重身份验证。 更多信息请参阅“[您的组织中需要双重身份验证](/github/setting-up-and-managing-organizations-and-teams/requiring-two-factor-authentication-in-your-organization)”。 当您准备在 {% data variables.product.prodname_marketplace %} 上发布应用程序时，您必须请求验证上架信息。 diff --git a/translations/zh-CN/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md b/translations/zh-CN/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md index 1ef04efa9fdc..558a5c3e41d4 100644 --- a/translations/zh-CN/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md +++ b/translations/zh-CN/content/developers/github-marketplace/rest-endpoints-for-the-github-marketplace-api.md @@ -1,6 +1,6 @@ --- -title: REST endpoints for the GitHub Marketplace API -intro: 'To help manage your app on {% data variables.product.prodname_marketplace %}, use these {% data variables.product.prodname_marketplace %} API endpoints.' +title: GitHub Marketplace API 的 REST 端点 +intro: '要帮助管理 {% data variables.product.prodname_marketplace %} 上的应用程序，请使用这些 {% data variables.product.prodname_marketplace %} API 端点。' redirect_from: - /apps/marketplace/github-marketplace-api-endpoints/ - /apps/marketplace/integrating-with-the-github-marketplace-api/github-marketplace-rest-api-endpoints/ @@ -11,20 +11,20 @@ versions: -Here are some useful endpoints available for Marketplace listings: +以下是一些可用于 Marketplace 上架产品的有用端点： -* [List plans](/rest/reference/apps#list-plans) -* [List accounts for a plan](/rest/reference/apps#list-accounts-for-a-plan) -* [Get a subscription plan for an account](/rest/reference/apps#get-a-subscription-plan-for-an-account) +* [列出计划](/rest/reference/apps#list-plans) +* [列出计划的帐户](/rest/reference/apps#list-accounts-for-a-plan) +* [获取帐户的订阅计划](/rest/reference/apps#get-a-subscription-plan-for-an-account) * [列出经验证用户的订阅](/rest/reference/apps#list-subscriptions-for-the-authenticated-user) -See these pages for details on how to authenticate when using the {% data variables.product.prodname_marketplace %} API: +有关在使用 {% data variables.product.prodname_marketplace %} API 时如何进行身份验证的详细信息，请参阅以下页面： -* [Authorization options for OAuth Apps](/apps/building-oauth-apps/authorizing-oauth-apps/) -* [Authentication options for GitHub Apps](/apps/building-github-apps/authenticating-with-github-apps/) +* [OAuth 应用程序的授权选项](/apps/building-oauth-apps/authorizing-oauth-apps/) +* [GitHub 应用程序的身份验证选项](/apps/building-github-apps/authenticating-with-github-apps/) {% note %} -**Note:** [Rate limits for the REST API](/rest#rate-limiting) apply to all {% data variables.product.prodname_marketplace %} API endpoints. +**注：**[REST API 的速率限制](/rest#rate-limiting)适用于所有 {% data variables.product.prodname_marketplace %} API 端点。 {% endnote %} diff --git a/translations/zh-CN/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md b/translations/zh-CN/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md index e468593f58f7..a352dec71a1a 100644 --- a/translations/zh-CN/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md +++ b/translations/zh-CN/content/developers/github-marketplace/selling-your-app-on-github-marketplace.md @@ -1,6 +1,6 @@ --- -title: Selling your app on GitHub Marketplace -intro: 'Learn about requirements and best practices for selling your app on {% data variables.product.prodname_marketplace %}.' +title: 在 GitHub Marketplace 上出售应用程序 +intro: '了解在 {% data variables.product.prodname_marketplace %} 上出售应用程序的要求和最佳实践。' mapTopic: true redirect_from: - /apps/marketplace/administering-listing-plans-and-user-accounts/ diff --git a/translations/zh-CN/content/developers/github-marketplace/submitting-your-listing-for-publication.md b/translations/zh-CN/content/developers/github-marketplace/submitting-your-listing-for-publication.md index be3e6cdccde1..09942f2a8aee 100644 --- a/translations/zh-CN/content/developers/github-marketplace/submitting-your-listing-for-publication.md +++ b/translations/zh-CN/content/developers/github-marketplace/submitting-your-listing-for-publication.md @@ -12,7 +12,7 @@ versions: 完成应用程序的上架信息后，您将会看到两个按钮，允许您请求在验证或不验证的情况下发布上架产品。 如果您在上架信息中发布了任何付费定价计划，则“发布而不验证”的 **Request（请求）**按钮将被禁用。 -![Unverified and verified request button](/assets/images/marketplace/marketplace-request-button.png) +![未经验证和已验证请求按钮](/assets/images/marketplace/marketplace-request-button.png) {% data reusables.marketplace.launch-with-free %} @@ -24,7 +24,7 @@ versions: 请求验证上架信息之前，您需要将 {% data variables.product.prodname_marketplace %} 帐单流程和 web 挂钩集成到应用程序中。 更多信息请参阅“[在应用程序中使用 {% data variables.product.prodname_marketplace %} API](/developers/github-marketplace/using-the-github-marketplace-api-in-your-app)”。 -如果已满足上架要求并且已集成 {% data variables.product.prodname_marketplace %} API，请继续提交您的上架信息。 For more information, see "[Requirements for listing an app](/developers/github-marketplace/requirements-for-listing-an-app)." +如果已满足上架要求并且已集成 {% data variables.product.prodname_marketplace %} API，请继续提交您的上架信息。 更多信息请参阅“[上架应用程序的要求](/developers/github-marketplace/requirements-for-listing-an-app)”。 {% data reusables.marketplace.app-transfer-to-org-for-verification %} 有关如何执行此操作的信息，请参阅下面的“[在提交之前将应用程序转让给组织](#transferring-an-app-to-an-organization-before-you-submit)”。 diff --git a/translations/zh-CN/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md b/translations/zh-CN/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md index 79b8ccfe4321..fd23430f819d 100644 --- a/translations/zh-CN/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md +++ b/translations/zh-CN/content/developers/github-marketplace/using-the-github-marketplace-api-in-your-app.md @@ -1,6 +1,6 @@ --- -title: Using the GitHub Marketplace API in your app -intro: 'Learn how to integrate the {% data variables.product.prodname_marketplace %} API and webhook events into your app for the {% data variables.product.prodname_marketplace %} .' +title: 在应用程序中使用 GitHub Marketplace API +intro: '了解如何将 {% data variables.product.prodname_marketplace %} API 和 web 挂钩集成到用于 {% data variables.product.prodname_marketplace %} 的应用程序中。' mapTopic: true redirect_from: - /apps/marketplace/setting-up-github-marketplace-webhooks/ diff --git a/translations/zh-CN/content/developers/index.md b/translations/zh-CN/content/developers/index.md index 81987f268f6f..26b7c2c06cc3 100644 --- a/translations/zh-CN/content/developers/index.md +++ b/translations/zh-CN/content/developers/index.md @@ -1,6 +1,6 @@ --- -title: Developers -intro: 'Go deeper with {% data variables.product.prodname_dotcom %} by integrating with our APIs, customizing your {% data variables.product.prodname_dotcom %} workflow, and building and sharing apps with the community.' +title: 开发者 +intro: '通过与我们的 API 集成，自定义您的 {% data variables.product.prodname_dotcom %} 工作流程，以及构建并与社区分享应用程序，更深入地了解 {% data variables.product.prodname_dotcom %}。' versions: free-pro-team: '*' enterprise-server: '*' 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 5eb45b824790..21a1ded451db 100644 --- a/translations/zh-CN/content/developers/overview/about-githubs-apis.md +++ b/translations/zh-CN/content/developers/overview/about-githubs-apis.md @@ -1,6 +1,6 @@ --- -title: About GitHub's APIs -intro: 'Learn about {% data variables.product.prodname_dotcom %}''s APIs to extend and customize your {% data variables.product.prodname_dotcom %} experience.' +title: 关于 GitHub 的 API +intro: '了解 {% data variables.product.prodname_dotcom %} 的 API 以扩展和自定义您的 {% data variables.product.prodname_dotcom %} 体验。' redirect_from: - /v3/versions versions: @@ -9,18 +9,18 @@ versions: github-ae: '*' --- -There are two stable versions of the GitHub API: the [REST API](/rest) and the [GraphQL API](/graphql). When using the REST API, we encourage you to [request v3 via the `Accept` header](/v3/media/#request-specific-version). For information on using the GraphQL API, see the [v4 docs](/graphql). +GitHub API 有两个稳定版本：[REST API](/rest) 和 [GraphQL API](/graphql)。 使用 REST API 时，我们建议您[通过 `Accept` 标头请求 v3](/v3/media/#request-specific-version)。 有关使用 GraphQL API 的信息，请参阅 [v4 文档](/graphql)。 -## Deprecated versions +## 已弃用版本 ### 测试版 -We deprecated the beta API on April 22, 2014. +我们在 2014 年 4 月 22 日弃用了测试版 API。 ### v2 -We removed support for API v2 on June 12, 2012. +我们在 2012 年 6 月 12 日取消了对 API v2 的支持。 ### v1 -We removed support for API v1 on June 12, 2012. +我们在 2012 年 6 月 12 日取消了对 API v1 的支持。 diff --git a/translations/zh-CN/content/developers/overview/index.md b/translations/zh-CN/content/developers/overview/index.md index 71ddca7f42ea..07eaa458eb1c 100644 --- a/translations/zh-CN/content/developers/overview/index.md +++ b/translations/zh-CN/content/developers/overview/index.md @@ -11,6 +11,7 @@ versions: {% link_in_list /about-githubs-apis %} {% link_in_list /managing-deploy-keys %} +{% link_in_list /viewing-deployment-history %} {% link_in_list /using-ssh-agent-forwarding %} {% link_in_list /secret-scanning %} {% link_in_list /replacing-github-services %} 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 1aeaf494698a..dba2c1424fe9 100644 --- a/translations/zh-CN/content/developers/overview/managing-deploy-keys.md +++ b/translations/zh-CN/content/developers/overview/managing-deploy-keys.md @@ -43,7 +43,9 @@ versions: * 用户不必更改其本地 SSH 设置。 * 不需要多个令牌（每个用户一个）；每个服务器一个令牌就足够了。 * 令牌可随时撤销，本质上变成一次性密码。 +{% if enterpriseServerVersions contains currentVersion %} * 可以使用 [OAuth API](/rest/reference/oauth-authorizations#create-a-new-authorization) 轻松编写生成新令牌的脚本。 +{% endif %} ##### 缺点 diff --git a/translations/zh-CN/content/developers/overview/viewing-deployment-history.md b/translations/zh-CN/content/developers/overview/viewing-deployment-history.md new file mode 100644 index 000000000000..08c26973e209 --- /dev/null +++ b/translations/zh-CN/content/developers/overview/viewing-deployment-history.md @@ -0,0 +1,20 @@ +--- +title: 查看部署历史记录 +intro: 查看仓库的当前和先前部署。 +versions: + free-pro-team: '*' + enterprise-server: '*' + github-ae: '*' +--- + +{% data reusables.actions.environments-beta %} + +您可以通过 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}{% data variables.product.prodname_actions %} 和环境或使用 {% endif %} REST API 和第三方应用程序来交付部署。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %}有关 {% data variables.product.prodname_actions %} 的更多信息，请参阅“[{% data variables.product.prodname_actions %}](/actions)”。 {% endif %}有关使用 REST API 进行部署的更多信息，请参阅“[仓库](/rest/reference/repos#deployments)”。 + +要查看当前和过去的部署，请在仓库的主页上单击 **Environments（环境）**。 ![环境](/assets/images/environments-sidebar.png) + +部署页显示仓库中每个环境的最新活动部署。 如果部署包含环境 URL，则部署旁边将显示链接到 URL 的“View deployment（查看部署）”按钮。 + +活动日志显示环境的部署历史记录。 默认情况下，只有环境的最新部署具有 `Active` 状态；所有先前的活动部署具有 `Inactive` 状态。 有关自动失活部署的更多信息，请参阅“[非活动部署](/rest/reference/repos#inactive-deployments)”。 + +您也可以使用 REST API 来获取有关部署的信息。 更多信息请参阅“[仓库](/rest/reference/repos#deployments)”。 diff --git a/translations/zh-CN/content/developers/webhooks-and-events/creating-webhooks.md b/translations/zh-CN/content/developers/webhooks-and-events/creating-webhooks.md index faf0cd5e4674..619749771ac2 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/creating-webhooks.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/creating-webhooks.md @@ -54,15 +54,15 @@ Web 挂钩需要设置几个配置选项才能使用。 我们将在下面介绍 事件是 web 挂钩的核心。 当仓库上发生特定操作时，就会触发这些 web 挂钩，而服务器的有效负载 URL 会截获它们并采取行动。 -A full list of webhook events, and when they execute, can be found in [the webhooks API][hooks-api] reference. +有关 web 挂钩事件的完整列表以及它们在什么情况下执行，请参阅 [web 挂钩 API][hooks-api] 参考资料。 -Since our webhook is dealing with Issues in a repository, we'll click **Let me select individual events** and then **Issues**. Make sure you select **Active** to receive issue events for triggered webhooks. You can also select all events using the default option. +由于我们的 web 挂钩与仓库中的议题相关，因此我们单击 **Let me select individual events（让我选择单个事件）**，然后单击 **Issues（议题）**。 确保选择 **Active（激活）**以接收触发 web 挂钩的议题事件。 您还可以使用默认选项选择所有事件。 -When you're finished, click **Add webhook**. 唷！ Now that you created the webhook, it's time to set up our local server to test the webhook. Head on over to [Configuring Your Server](/webhooks/configuring/) to learn how to do that. +完成后，单击 **Add webhook（添加 web 挂钩）**。 唷！ 现在您创建了 web 挂钩，是时候设置我们的本地服务器来测试 web 挂钩了。 请参阅[配置服务器](/webhooks/configuring/)了解如何进行测试。 -#### Wildcard Event +#### 通配符事件 -To configure a webhook for all events, use the wildcard (`*`) character to specify the webhook events. When you add the wildcard event, we'll replace any existing events you have configured with the wildcard event and send you payloads for all supported events. You'll also automatically get any new events we might add in the future. +要为所有事件配置 web 挂钩，请使用通配符 (`*`) 来指定 web 挂钩事件。 添加通配符事件时，我们将用通配符事件替换您配置的任何现有事件，并向您发送所有受支持事件的有效负载。 您还会自动获取我们可能在将来添加的任何新事件。 [webhooks-overview]: /webhooks/ [webhook-api]: /rest/reference/repos#hooks diff --git a/translations/zh-CN/content/developers/webhooks-and-events/events.md b/translations/zh-CN/content/developers/webhooks-and-events/events.md index b41161ebfa19..4f8d8636f0e6 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/events.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/events.md @@ -1,6 +1,6 @@ --- title: 事件 -intro: 'Your integrations can subscribe and react to events on {% data variables.product.prodname_dotcom %}.' +intro: '您的集成可以订阅和响应 {% data variables.product.prodname_dotcom %} 上的事件。' mapTopic: true versions: free-pro-team: '*' 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 117b732c22bf..3a4fc625804d 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 @@ -1,6 +1,6 @@ --- -title: GitHub event types -intro: 'For the {% data variables.product.prodname_dotcom %} Events API, learn about each event type, the triggering action on {% data variables.product.prodname_dotcom %}, and each event''s unique properties.' +title: GitHub 事件类型 +intro: '对于 {% data variables.product.prodname_dotcom %} 事件 API，了解每个事件类型、{% data variables.product.prodname_dotcom %} 上的触发操作以及每个事件的唯一属性。' product: '{% data reusables.gated-features.enterprise-accounts %}' redirect_from: - /v3/activity/event_types @@ -11,36 +11,36 @@ versions: --- -The Events API can return different types of events triggered by activity on GitHub. Each event response contains shared properties, but has a unique `payload` object determined by its event type. The [Event object common properties](#event-object-common-properties) describes the properties shared by all events, and each event type describes the `payload` properties that are unique to the specific event. +事件 API 可以返回 GitHub 上的活动触发的不同类型事件。 每个时间响应包含共享属性，但具有由其事件类型确定的唯一 `payload` 对象。 [事件对象公共属性](#event-object-common-properties)描述所有事件共享的属性，而每个事件类型描述特定事件唯一的 `payload` 属性。 {% if currentVersion == "free-pro-team@latest" %} {% endif %} -### Event object common properties +### 事件对象公共属性 -The event objects returned from the Events API endpoints have the same structure. +从事件 API 端点返回的事件对象具有相同的结构。 -| Event API attribute name | 描述 | -| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `id` | Unique identifier for the event. | -| `type` | The type of event. Events uses PascalCase for the name. | -| `actor` | The user that triggered the event. | -| `actor.id` | The unique identifier for the actor. | -| `actor.login` | The username of the actor. | -| `actor.display_login` | The specific display format of the username. | -| `actor.gravatar_id` | The unique identifier of the Gravatar profile for the actor. | -| `actor.url` | The REST API URL used to retrieve the user object, which includes additional user information. | -| `actor.avatar_url` | The URL of the actor's profile image. | -| `repo` | The repository object where the event occurred. | -| `repo.id` | The unique identifier of the repository. | -| `repo.name` | The name of the repository, which includes the owner and repository name. For example, `octocat/hello-world` is the name of the `hello-world` repository owned by the `octocat` user account. | -| `repo.url` | The REST API URL used to retrieve the repository object, which includes additional repository information. | -| `payload` | The event payload object is unique to the event type. See the event type below for the event API `payload` object. | +| 事件 API 属性名称 | 描述 | +| --------------------- | ----------------------------------------------------------------------------------- | +| `id` | 事件的唯一标识符。 | +| `type` | 事件的类型。 事件使用 PascalCase 作为名称。 | +| `actor` | 触发事件的用户。 | +| `actor.id` | 执行者的唯一标识符。 | +| `actor.login` | 执行者的用户名。 | +| `actor.display_login` | 用户名的特定显示格式。 | +| `actor.gravatar_id` | 执行者的 Gravatar 个人资料的唯一标识符。 | +| `actor.url` | 用于检索用户对象的 REST API URL，其中包括更多用户信息。 | +| `actor.avatar_url` | 执行者个人资料图像的 URL。 | +| `repo` | 发生事件的仓库对象。 | +| `repo.id` | 仓库的唯一标识符。 | +| `repo.name` | 仓库名称，包括所有者和仓库的名称。 例如，`octocat/hello-world` 是 `octocat` 用户帐户拥有的 `hello-world` 仓库的名称。 | +| `repo.url` | 用于检索仓库对象的 REST API URL，其中包括更多仓库信息。 | +| `payload` | 事件有效负载对象对于事件类型是唯一的。 关于事件 API `payload` 对象，请参阅下面的事件类型。 | -#### Example WatchEvent event object +#### WatchEvent 事件对象示例 -This example shows the format of the [WatchEvent](#watchevent) response when using the [Events API](/rest/reference/activity#events). +此示例显示了使用[事件 API](/rest/reference/activity#events) 时 [WatchEvent](#watchevent) 响应的格式。 ``` Status: 200 OK @@ -85,7 +85,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.commit_comment_properties %} @@ -95,7 +95,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.create_properties %} @@ -105,7 +105,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.delete_properties %} @@ -115,7 +115,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.fork_properties %} @@ -125,7 +125,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.gollum_properties %} @@ -135,7 +135,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.issue_comment_webhook_properties %} {% data reusables.webhooks.issue_comment_properties %} @@ -146,7 +146,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.issue_event_api_properties %} {% data reusables.webhooks.issue_properties %} @@ -157,7 +157,7 @@ Link: ; rel="next", {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.member_event_api_properties %} {% data reusables.webhooks.member_properties %} @@ -166,9 +166,9 @@ Link: ; rel="next", {% data reusables.webhooks.public_short_desc %} -#### Event `payload` object +#### 事件 `payload` 对象 -This event returns an empty `payload` object. +此事件返回一个空 `payload` 对象。 ### PullRequestEvent @@ -176,7 +176,7 @@ This event returns an empty `payload` object. {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.pull_request_event_api_properties %} {% data reusables.webhooks.pull_request_properties %} @@ -187,7 +187,7 @@ This event returns an empty `payload` object. {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.pull_request_review_comment_event_api_properties %} {% data reusables.webhooks.pull_request_review_comment_properties %} @@ -198,22 +198,22 @@ This event returns an empty `payload` object. {% data reusables.webhooks.events_api_payload %} -| 键 | 类型 | 描述 | -| -------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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` | `字符串` | The full [`git ref`](/rest/reference/git#refs) that was pushed. Example: `refs/heads/main`. | -| `头部` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | -| `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | -| `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 If necessary, you can use the [Commits API](/rest/reference/repos#commits) to fetch additional commits. 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | -| `commits[][sha]` | `字符串` | 提交的 SHA。 | -| `commits[][message]` | `字符串` | 提交消息. | -| `commits[][author]` | `对象` | 提交的 Git 作者。 | -| `commits[][author][name]` | `字符串` | Git 作者的名称。 | -| `commits[][author][email]` | `字符串` | Git 作者的电子邮件地址。 | -| `commits[][url]` | `url` | 指向提交 API 资源的 URL。 | -| `commits[][distinct]` | `布尔值` | 此提交是否与之前推送的任何提交不同。 | +| 键 | 类型 | 描述 | +| -------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------- | +| `push_id` | `整数` | 推送的唯一标识符。 | +| `size` | `整数` | 推送中的提交数。 | +| `distinct_size` | `整数` | 推送中不同提交的数量。 | +| `ref` | `字符串` | 被推送的完整 [`git ref`](/rest/reference/git#refs)。 例如：`refs/heads/main`。 | +| `头部` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | +| `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | +| `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 如有必要，可使用[提交 API](/rest/reference/repos#commits) 获取更多提交。 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | +| `commits[][sha]` | `字符串` | 提交的 SHA。 | +| `commits[][message]` | `字符串` | 提交消息. | +| `commits[][author]` | `对象` | 提交的 Git 作者。 | +| `commits[][author][name]` | `字符串` | Git 作者的名称。 | +| `commits[][author][email]` | `字符串` | Git 作者的电子邮件地址。 | +| `commits[][url]` | `url` | 指向提交 API 资源的 URL。 | +| `commits[][distinct]` | `布尔值` | 此提交是否与之前推送的任何提交不同。 | ### ReleaseEvent @@ -221,7 +221,7 @@ This event returns an empty `payload` object. {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.release_event_api_properties %} {% data reusables.webhooks.release_properties %} @@ -231,7 +231,7 @@ This event returns an empty `payload` object. {% data reusables.webhooks.sponsorship_short_desc %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.sponsorship_event_api_properties %} {% data reusables.webhooks.sponsorship_properties %} @@ -243,6 +243,6 @@ This event returns an empty `payload` object. {% data reusables.webhooks.events_api_payload %} -#### Event `payload` object +#### 事件 `payload` 对象 {% data reusables.webhooks.watch_properties %} diff --git a/translations/zh-CN/content/developers/webhooks-and-events/index.md b/translations/zh-CN/content/developers/webhooks-and-events/index.md index f62151aa5acd..2b9148b73c30 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/index.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/index.md @@ -1,6 +1,6 @@ --- -title: Webhooks and events -intro: 'You can set up, test, and secure webhooks so your integrations can subscribe and react to events on {% data variables.product.prodname_dotcom %}.' +title: Web 挂钩和事件 +intro: '您可以设置、测试和保护 web 挂钩，使您的集成可以订阅和响应 {% data variables.product.prodname_dotcom %} 上的事件。' versions: free-pro-team: '*' enterprise-server: '*' 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 dfac9e4e09e7..4c535e848802 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 @@ -1,6 +1,6 @@ --- -title: Issue event types -intro: 'For the Issues Events API and Timeline API, learn about each event type, the triggering action on {% data variables.product.prodname_dotcom %}, and each event''s unique properties.' +title: 议题事件类型 +intro: '对于议题事件 API 和时间表 API，了解每个事件类型、{% data variables.product.prodname_dotcom %} 上的触发操作以及每个事件的唯一属性。' redirect_from: - /v3/issues/issue-event-types versions: @@ -10,27 +10,27 @@ versions: --- -Issue events are triggered by activity in issues and pull requests and are available in the [Issue Events API](/rest/reference/issues#events) and the [Timeline Events API](/rest/reference/issues#timeline). Each event type specifies whether the event is available in the Issue Events or Timeline Events APIs. +议题事件由议题和拉取请求中的活动触发，可用于[议题事件 API](/rest/reference/issues#events) 和[时间表事件 API](/rest/reference/issues#timeline)。 每个事件类型指定事件是否可用于议题事件或时间表事件 API。 -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. +GitHub 的 REST API 认为每个拉取请求都是一个议题，但并非每个议题都是拉取请求。 因此，议题事件和时间表事件端点可能在响应中同时返回议题和拉取请求。 拉取请求在 `issue` 对象中具有 `pull_request` 属性。 因为拉取请求也是议题，因此议题和拉取请求编号在仓库中不会重叠。 例如，如果您在仓库中打开了您的第一个议题，则编号将为 1。 如果您随后打开了一个拉取请求，则编号将为 2。 每个事件类型指定事件是否发生在拉取请求和/或议题中。 -### Issue event object common properties +### 议题事件对象公共属性 -Issue events all have the same object structure, except events that are only available in the Timeline Events API. Some events also include additional properties that provide more context about the event resources. Refer to the specific event to for details about any properties that differ from this object format. +议题事件都具有相同的对象结构，但仅在时间表事件 API 中可用的事件除外。 某些事件还包括可提供有关事件资源更多上下文的其他属性。 有关不同于此对象格式的任何属性的详细信息，请参阅特定事件。 {% data reusables.issue-events.issue-event-common-properties %} ### added_to_project -The issue or pull request was added to a project board. {% data reusables.projects.disabled-projects %} +议题或拉取请求已添加到项目板。 {% data reusables.projects.disabled-projects %} #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.pre-release-program.starfox-preview %} {% data reusables.pre-release-program.api-preview-warning %} @@ -40,171 +40,171 @@ The issue or pull request was added to a project board. {% data reusables.projec ### 已分配 -The issue or pull request was assigned to a user. +议题或拉取请求已分配给用户。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.assignee-properties %} ### automatic_base_change_failed -GitHub unsuccessfully attempted to automatically change the base branch of the pull request. +GitHub 尝试自动更改拉取请求的基本分支未成功。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### automatic_base_change_succeeded -GitHub successfully attempted to automatically change the base branch of the pull request. +GitHub 尝试自动更改拉取请求的基本分支已成功。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### base_ref_changed -The base reference branch of the pull request changed. +拉取请求的基本引用分支已更改。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | | - ### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### closed -The issue or pull request was closed. When the `commit_id` is present, it identifies the commit that closed the issue using "closes / fixes" syntax. For more information about the syntax, see "[Linking a pull request to an issue](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)". +议题或拉取请求已关闭。 当 `commit_id` 存在时，它使用 "closes / fixes" 语法来标识关闭议题的提交。 有关该语法的更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)”。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### 已评论 -A comment was added to the issue or pull request. +已将评论添加到议题或拉取请求中。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.timeline_events_object_properties %} -| 名称 | 类型 | 描述 | -| -------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| `url` | `字符串` | The REST API URL to retrieve the issue comment. | -| `html_url` | `字符串` | The HTML URL of the issue comment. | -| `issue_url` | `字符串` | The HTML URL of the issue. | -| `id` | `整数` | The unique identifier of the event. | -| `node_id` | `字符串` | The [Global Node ID](/graphql/guides/using-global-node-ids) of the event. | -| `用户` | `对象` | The person who commented on the issue. | -| `created_at` | `字符串` | The timestamp indicating when the comment was added. | -| `updated_at` | `字符串` | The timestamp indicating when the comment was updated or created, if the comment is never updated. | -| `author_association` | `字符串` | The permissions the user has in the issue's repository. For example, the value would be `"OWNER"` if the owner of repository created a comment. | -| `正文` | `字符串` | The comment body text. | -| `event` | `字符串` | The event value is `"commented"`. | -| `actor` | `对象` | The person who generated the event. | +| 名称 | 类型 | 描述 | +| -------------------- | ----- | ---------------------------------------------------- | +| `url` | `字符串` | 用于检索议题评论的 REST API URL。 | +| `html_url` | `字符串` | 议题评论的 HTML URL。 | +| `issue_url` | `字符串` | 议题的 HTML URL。 | +| `id` | `整数` | 事件的唯一标识符。 | +| `node_id` | `字符串` | 事件的[全局节点 ID](/graphql/guides/using-global-node-ids)。 | +| `用户` | `对象` | 对议题发表评论的人。 | +| `created_at` | `字符串` | 指示评论添加时间的时间戳。 | +| `updated_at` | `字符串` | 指示评论更新或创建（如果从未更新）时间的时间戳。 | +| `author_association` | `字符串` | 用户在议题仓库中拥有的权限。 如果仓库的所有者创建了评论，则该值将为 `"OWNER"`。 | +| `正文` | `字符串` | 评论正文文本。 | +| `event` | `字符串` | 事件值为 `"commented"`。 | +| `actor` | `对象` | 生成事件的人。 | ### committed -A commit was added to the pull request's `HEAD` branch. +提交已添加到拉取请求的 `HEAD` 分支。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.timeline_events_object_properties %} -| 名称 | 类型 | 描述 | -| ------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `sha` | `字符串` | The SHA of the commit in the pull request. | -| `node_id` | `字符串` | The [Global Node ID](/graphql/guides/using-global-node-ids) of the event. | -| `url` | `字符串` | The REST API URL to retrieve the commit. | -| `html_url` | `字符串` | The HTML URL of the commit. | -| `作者` | `对象` | The person who authored the commit. | -| `提交者` | `对象` | The person who committed the commit on behalf of the author. | -| `树` | `对象` | The Git tree of the commit. | -| `message` | `字符串` | 提交消息. | -| `父项` | `array of objects` | A list of parent commits. | -| `verfication` | `对象` | The result of verifying the commit's signature. For more information, see "[Signature verification object](/rest/reference/git#signature-verification-object)." | -| `event` | `字符串` | The event value is `"committed"`. | +| 名称 | 类型 | 描述 | +| ------------- | ------ | -------------------------------------------------------------------------------- | +| `sha` | `字符串` | 拉取请求中提交的 SHA。 | +| `node_id` | `字符串` | 事件的[全局节点 ID](/graphql/guides/using-global-node-ids)。 | +| `url` | `字符串` | 用于检索提交的 REST API URL。 | +| `html_url` | `字符串` | 提交的 HTML URL。 | +| `作者` | `对象` | 编写提交的人。 | +| `提交者` | `对象` | 代表作者进行提交的人。 | +| `树` | `对象` | 提交的 Git 树。 | +| `message` | `字符串` | 提交消息. | +| `父项` | `对象数组` | 父提交的列表。 | +| `verfication` | `对象` | 验证提交签名的结果。 更多信息请参阅“[签名验证对象](/rest/reference/git#signature-verification-object)”。 | +| `event` | `字符串` | 事件值为 `"committed"`。 | ### connected -The issue or pull request was linked to another issue or pull request. For more information, see "[Linking a pull request to an issue](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)". +议题或拉取请求已链接到另一个议题或拉取请求。 更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)”。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### convert_to_draft -The pull request was converted to draft mode. +拉取请求已转换为草稿模式。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### converted_note_to_issue -The issue was created by converting a note in a project board to an issue. {% data reusables.projects.disabled-projects %} +此议题是通过将项目板中的注释转换为议题而产生的。 {% data reusables.projects.disabled-projects %} #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.pre-release-program.starfox-preview %} {% data reusables.pre-release-program.api-preview-warning %} @@ -214,139 +214,139 @@ The issue was created by converting a note in a project board to an issue. {% da ### cross-referenced -The issue or pull request was referenced from another issue or pull request. +议题或拉取请求引用自另一个议题或拉取请求。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.timeline_events_object_properties %} -| 名称 | 类型 | 描述 | -| --------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `actor` | `对象` | The person who generated the event. | -| `created_at` | `字符串` | The timestamp indicating when the cross-reference was added. | -| `updated_at` | `字符串` | The timestamp indicating when the cross-reference was updated or created, if the cross-reference is never updated. | -| `source` | `对象` | The issue or pull request that added a cross-reference. | -| `source[type]` | `字符串` | This value will always be `"issue"` because pull requests are of type issue. Only cross-reference events triggered by issues or pull requests are returned in the Timeline Events API. To determine if the issue that triggered the event is a pull request, you can check if the `source[issue][pull_request` object exists. | -| `source[issue]` | `对象` | The `issue` object that added the cross-reference. | -| `event` | `字符串` | The event value is `"cross-referenced"`. | +| 名称 | 类型 | 描述 | +| --------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------- | +| `actor` | `对象` | 生成事件的人。 | +| `created_at` | `字符串` | 指示交叉引用添加时间的时间戳。 | +| `updated_at` | `字符串` | 指示交叉引用更新或创建（如果从未更新）时间的时间戳。 | +| `source` | `对象` | 添加交叉引用的议题或拉取请求。 | +| `source[type]` | `字符串` | 此值将始终为 `"issue"`，因为拉取请求是议题类型。 在时间表事件 API 中仅返回由议题或拉取请求触发的交叉引用事件。 要确定触发事件的议题是否为拉取请求，您可以检查 `source[issue][pull_request` 对象是否存在。 | +| `source[issue]` | `对象` | 添加交叉引用的 `issue` 对象。 | +| `event` | `字符串` | 事件值为 `"cross-referenced"`。 | ### demilestoned -The issue or pull request was removed from a milestone. +议题或拉取请求已从里程碑中删除。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} -`milestone` | `object` | The milestone object. `milestone[title]` | `string` | The title of the milestone. +`milestone` | `object` | 里程碑对象。 `milestone[title]` | `string` | 里程碑的标题。 ### deployed -The pull request was deployed. +拉取请求已部署。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### deployment_environment_changed -The pull request deployment environment was changed. +拉取请求部署环境已更改。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### disconnected -The issue or pull request was unlinked from another issue or pull request. For more information, see "[Linking a pull request to an issue](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)". +议题或拉取请求与另一个议题或拉取请求取消链接。 更多信息请参阅“[将拉取请求链接到议题](/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue)”。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### head_ref_deleted -The pull request's `HEAD` branch was deleted. +拉取请求的 `HEAD` 分支已删除。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### head_ref_restored -The pull request's `HEAD` branch was restored to the last known commit. +拉取请求的 `HEAD` 分支已还原到上次已知提交。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### labeled -A label was added to the issue or pull request. +标签已添加到议题或拉取请求。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.label-properties %} ### locked -The issue or pull request was locked. +议题或拉取请求已锁定。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %} {% data reusables.pre-release-program.sailor-v-preview %} @@ -354,137 +354,137 @@ The issue or pull request was locked. {% endif %} {% data reusables.issue-events.issue-event-common-properties %} -`lock_reason` | `string` | The reason an issue or pull request conversation was locked, if one was provided. +`lock_reason` | `string` | 议题或拉取请求对话被锁定的原因（如果有）。 ### 已提及 -The `actor` was `@mentioned` in an issue or pull request body. +`actor` 在议题或拉取请求正文中被 `@mentioned`。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### marked_as_duplicate -A user with write permissions marked an issue as a duplicate of another issue, or a pull request as a duplicate of another pull request. +具有写入权限的用户将议题标记为另一个议题的重复项，或将拉取请求标记为另一个拉取请求的重复项。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### merged -The pull request was merged. The `commit_id` attribute is the SHA1 of the `HEAD` commit that was merged. The `commit_repository` is always the same as the main repository. +拉取请求已合并。 `commit_id` 属性是已合并 `HEAD` 提交的 SHA1。 `commit_repository` 始终与主仓库相同。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### milestoned -The issue or pull request was added to a milestone. +议题或拉取请求已添加到里程碑。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} -`milestone` | `object` | The milestone object. `milestone[title]` | `string` | The title of the milestone. +`milestone` | `object` | 里程碑对象。 `milestone[title]` | `string` | 里程碑的标题。 ### moved_columns_in_project -The issue or pull request was moved between columns in a project board. {% data reusables.projects.disabled-projects %} +议题或拉取请求已在项目板的各列之间移动。 {% data reusables.projects.disabled-projects %} #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.pre-release-program.starfox-preview %} {% data reusables.pre-release-program.api-preview-warning %} {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.project-card-properties %} -`previous_column_name` | `string` | The name of the column the issue was moved from. +`previous_column_name` | `string` | 从中移动议题的列的名称。 ### 已固定 -The issue was pinned. +该议题已被置顶。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### ready_for_review -A pull request was created that is not in draft mode. +已创建未处于草稿模式下的拉取请求。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### referenced -The issue was referenced from a commit message. The `commit_id` attribute is the commit SHA1 of where that happened and the commit_repository is where that commit was pushed. +议题引用自提交消息。 `commit_id` 属性是发生位置的提交 SHA1，commit_repository 提交被推送的地方。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### removed_from_project -The issue or pull request was removed from a project board. {% data reusables.projects.disabled-projects %} +议题或拉取请求已从项目板中删除。 {% data reusables.projects.disabled-projects %} #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.pre-release-program.starfox-preview %} {% data reusables.pre-release-program.api-preview-warning %} @@ -494,176 +494,176 @@ The issue or pull request was removed from a project board. {% data reusables.pr ### renamed -The issue or pull request title was changed. +议题或拉取请求标题已更改。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} -`rename` | `object` | The name details. `rename[from]` | `string` | The previous name. `rename[to]` | `string` | The new name. +`rename` | `object` | 名称详细信息。 `rename[from]` | `string` | 以前的名称。 `rename[to]` | `string` | 新名称。 ### reopened -The issue or pull request was reopened. +问题或拉取请求已重新打开。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### review_dismissed -The pull request review was dismissed. +拉取请求审查被忽略。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.review-dismissed-properties %} ### review_requested -A pull request review was requested. +已请求拉取请求审查。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.review-request-properties %} ### review_request_removed -A pull request review request was removed. +拉取请求审查被删除。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.review-request-properties %} ### reviewed -The pull request was reviewed. +已审查拉取请求。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 拉取请求
    | | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 拉取请求
    | | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.timeline_events_object_properties %} -| 名称 | 类型 | 描述 | -| -------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| `id` | `整数` | The unique identifier of the event. | -| `node_id` | `字符串` | The [Global Node ID](/graphql/guides/using-global-node-ids) of the event. | -| `用户` | `对象` | The person who commented on the issue. | -| `正文` | `字符串` | The review summary text. | -| `commit_id` | `字符串` | The SHA of the latest commit in the pull request at the time of the review. | -| `submitted_at` | `字符串` | The timestamp indicating when the review was submitted. | -| `state` | `字符串` | The state of the submitted review. Can be one of: `commented`, `changes_requested`, or `approved`. | -| `html_url` | `字符串` | The HTML URL of the review. | -| `pull_request_url` | `字符串` | The REST API URL to retrieve the pull request. | -| `author_association` | `字符串` | The permissions the user has in the issue's repository. For example, the value would be `"OWNER"` if the owner of repository created a comment. | -| `_links` | `对象` | The `html_url` and `pull_request_url`. | -| `event` | `字符串` | The event value is `"reviewed"`. | +| 名称 | 类型 | 描述 | +| -------------------- | ----- | ---------------------------------------------------------------- | +| `id` | `整数` | 事件的唯一标识符。 | +| `node_id` | `字符串` | 事件的[全局节点 ID](/graphql/guides/using-global-node-ids)。 | +| `用户` | `对象` | 对议题发表评论的人。 | +| `正文` | `字符串` | 审查摘要文本。 | +| `commit_id` | `字符串` | 审查时拉取请求中最新提交的 SHA。 | +| `submitted_at` | `字符串` | 指示审查提交时间的时间戳。 | +| `state` | `字符串` | 已提交审查的状态。 可以是以下项之一：`commented`、`changes_requested` 或 `approved`。 | +| `html_url` | `字符串` | 审查的 HTML URL。 | +| `pull_request_url` | `字符串` | 用于检索拉取请求的 REST API URL。 | +| `author_association` | `字符串` | 用户在议题仓库中拥有的权限。 如果仓库的所有者创建了评论，则该值将为 `"OWNER"`。 | +| `_links` | `对象` | `html_url` 和 `pull_request_url`。 | +| `event` | `字符串` | 事件值为 `"reviewed"`。 | ### subscribed -Someone subscribed to receive notifications for an issue or pull request. +有人订阅了接收议题或拉取请求的通知。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### transferred -The issue was transferred to another repository. +议题已转移到另一个仓库。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### unassigned -A user was unassigned from the issue. +已从议题中取消分配用户。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.assignee-properties %} ### unlabeled -A label was removed from the issue. +已从议题中删除标签。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% data reusables.issue-events.label-properties %} ### unlocked -The issue was unlocked. +议题已解锁。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %} {% data reusables.pre-release-program.sailor-v-preview %} @@ -671,62 +671,62 @@ The issue was unlocked. {% endif %} {% data reusables.issue-events.issue-event-common-properties %} -`lock_reason` | `string` | The reason an issue or pull request conversation was locked, if one was provided. +`lock_reason` | `string` | 议题或拉取请求对话被锁定的原因（如果有）。 ### unmarked_as_duplicate -An issue that a user had previously marked as a duplicate of another issue is no longer considered a duplicate, or a pull request that a user had previously marked as a duplicate of another pull request is no longer considered a duplicate. +先前被用户标记为另一个议题的重复项的议题不再被视为重复项，或者先前被用户标记为另一个拉取请求的重复项的拉取请求不再被视为重复项。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### unpinned -The issue was unpinned. +议题被取消置顶。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} ### 已取消订阅 -Someone unsubscribed from receiving notifications for an issue or pull request. +有人取消订阅了接收议题或拉取请求的通知。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-common-properties %} {% if currentVersion == "free-pro-team@latest" %} ### user_blocked -An organization owner blocked a user from the organization. This was done [through one of the blocked user's comments on the issue](/articles/blocking-a-user-from-your-organization#blocking-a-user-in-a-comment). +组织所有者阻止了用户访问组织。 其方法是[阻止用户对议题发表评论](/articles/blocking-a-user-from-your-organization#blocking-a-user-in-a-comment)。 #### 可用性 -| Issue type | Issue events API | Timeline events API | -|:-------------------------- |:----------------:|:-------------------:| -|
    • 议题
    • 拉取请求
    | **X** | **X** | +| 议题类型 | 议题事件 API | 时间表事件 API | +|:-------------------------- |:--------:|:---------:| +|
    • 议题
    • 拉取请求
    | **X** | **X** | -#### Event object properties +#### 事件对象属性 {% data reusables.issue-events.issue-event-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 558685831253..ecfc71dae8ce 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 @@ -1,6 +1,6 @@ --- -title: Securing your webhooks -intro: 'Ensure your server is only receiving the expected {% data variables.product.prodname_dotcom %} requests for security reasons.' +title: 保护 web 挂钩 +intro: '出于安全原因，请确保您的服务器仅接收预期的 {% data variables.product.prodname_dotcom %} 请求。' redirect_from: - /webhooks/securing versions: @@ -11,41 +11,41 @@ versions: -Once your server is configured to receive payloads, it'll listen for any payload sent to the endpoint you configured. For security reasons, you probably want to limit requests to those coming from GitHub. There are a few ways to go about this--for example, you could opt to allow requests from GitHub's IP address--but a far easier method is to set up a secret token and validate the information. +一旦服务器配置为接收有效负载，它将侦听发送到您配置的端点的任何有效负载。 出于安全原因，您可能需要将请求限制为来自 GitHub 的请求。 有几种方法可以做到这一点，例如，您可以选择允许来自 GitHub 的 IP 地址的请求，但更简单的方法是设置一个密钥令牌并验证信息。 {% data reusables.webhooks.webhooks-rest-api-links %} -### Setting your secret token +### 设置密钥令牌 -You'll need to set up your secret token in two places: GitHub and your server. +您需要在两个地方设置您的密钥令牌：GitHub 和您的服务器。 -To set your token on GitHub: +要在 GitHub 上设置令牌： -1. Navigate to the repository where you're setting up your webhook. -2. Fill out the Secret textbox. Use a random string with high entropy (e.g., by taking the output of `ruby -rsecurerandom -e 'puts SecureRandom.hex(20)'` at the terminal). ![Webhook secret token field](/assets/images/webhook_secret_token.png) -3. Click **Update Webhook**. +1. 导航到您设置 web 挂钩的仓库。 +2. 填写密钥文本框。 使用高熵值随机字符串（例如，通过在终端获取 `ruby -rsecurerandom -e 'puts SecureRandom.hex(20)'` 的输出）。 ![Web 挂钩密钥令牌字段](/assets/images/webhook_secret_token.png) +3. 单击 **Update Webhook（更新 web 挂钩）**。 -Next, set up an environment variable on your server that stores this token. Typically, this is as simple as running: +接下来，在服务器上设置存储此令牌的环境变量。 通常，这简单如运行以下命令： ```shell $ export SECRET_TOKEN=your_token ``` -**Never** hardcode the token into your app! +**切勿**将令牌硬编码到您的应用程序中！ -### Validating payloads from GitHub +### 验证来自 GitHub 的有效负载 -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 == "github-ae@latest" %}`X-Hub-Signature-256`{% elsif currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}. +设置密钥令牌后，{% data variables.product.product_name %} 使用它为每个有效负载创建一个哈希签名。 此哈希签名包含在每个请求的标头中，例如 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %}`X-Hub-Signature-256`{% elsif currentVersion ver_lt "enterprise-server@2.23" %}`X-Hub-Signature`{% endif %}。 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} {% 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. +**注：** 为了向后兼容，我们还包括使用 SHA-1 哈希函数生成的 `X-Hub-Signature` 标头。 如果可能，我们建议您使用 `X-Hub-Signature-256` 标头以提高安全性。 下面的示例演示使用 `X-Hub-Signature-256` 标头。 {% endnote %} {% endif %} -For example, if you have a basic server that listens for webhooks, it might be configured similar to this: +例如，如果您有一个侦听 web 挂钩的基本服务器，则配置可能类似于： ``` ruby require 'sinatra' @@ -57,7 +57,7 @@ post '/payload' do end ``` -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: +目的是使用您的 `SECRET_TOKEN` 计算哈希值，并确保结果与来自 {% data variables.product.product_name %} 的哈希匹配。 {% data variables.product.product_name %} 使用 HMAC 十六进制摘要计算哈希，因此您可以重新配置服务器，如下所示： ``` ruby post '/payload' do @@ -71,7 +71,7 @@ end {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@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']) + return halt 500, "Signatures didn't match!" unless Rack::Utils.secure_compare(signature, request.env['HTTP_X_HUB_SIGNATURE_256']) end{% elsif 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) @@ -79,10 +79,10 @@ def verify_signature(payload_body) end{% endif %} ``` -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 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "github-ae@latest" %}`sha256=`{% elsif currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %}, using the key of your secret token and your payload body. +* 无论您使用哪种实现，哈希签名都以 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or "github-ae@latest" %}`sha256=`{% elsif currentVersion ver_lt "enterprise-server@2.23" %}`sha1=`{% endif %} 开头，使用密钥令牌和有效负载正文的键。 -* 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`][secure_compare] 这样的方法执行“恒定时间”字符串比较，这有助于减轻针对常规相等运算符的某些定时攻击。 [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 2d26d9d764e3..4df18ff18768 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 @@ -1,6 +1,6 @@ --- title: 测试 web 挂钩 -intro: 'Review your webhook deliveries on {% data variables.product.prodname_dotcom %}, including the HTTP Request and payload as well as the response.' +intro: '查看 {% data variables.product.prodname_dotcom %} 上的 web 挂钩交付，包括 HTTP 请求和有效负载以及响应。' redirect_from: - /webhooks/testing versions: @@ -10,28 +10,28 @@ 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. +现在，您已经[配置了本地服务器](/webhooks/configuring/)，您可能有兴趣将代码推到极限。 为此，GitHub 的 web 挂钩视图提供了一些工具来测试已部署的有效负载。 -### Listing recent deliveries +### 列出最近的交付 -Every webhook has its own "Recent Deliveries" section, which lists, at a glance whether a delivery was successful (green check) or failed (red x). You can also identify when each delivery was attempted. +每个 web 挂钩都有自己的“最近交付”部分，它一目了然地列出了交付是成功（绿色钩号）还是失败（红色 x）。 您还可以确定每个交付的尝试时间。 -{% data variables.product.product_name %} keeps a log of each webhook delivery for {% if currentVersion == "free-pro-team@latest" %} 30 {% else %} 8 {% endif %} days. +{% data variables.product.product_name %} 保留每个 web 挂钩交付的日志 {% if currentVersion == "free-pro-team@latest" %} 30 {% else %} 8 {% endif %} 天。 ![最近交付视图](/assets/images/webhooks_recent_deliveries.png) -### Digging into results +### 挖掘结果 -By expanding an individual delivery, you'll be able to witness *precisely* what information GitHub is attempting to send to your server. This includes both the HTTP Request and Response. +通过展开单个交付，您将能够*精确*地见证 GitHub 尝试向您的服务器发送哪些信息。 这包括 HTTP 请求和响应。 -#### Request +#### 请求 -The webhook delivery view provides information on which Headers were sent by GitHub. It also includes details about the JSON payload. +Web 挂钩交付视图提供有关 GitHub 发送哪些标头的信息。 它还包括有关 JSON 有效负载的详细信息。 -![Viewing a payload request](/assets/images/payload_request_tab.png) +![查看有效负载请求](/assets/images/payload_request_tab.png) #### 响应 -The response tab lists how your server replied once it received the payload from GitHub. This includes the status code, the headers, and any additional data within the response body. +响应选项卡列出了服务器从 GitHub 收到有效负载后如何响应。 这包括状态代码、标头以及响应正文中的任何其他数据。 ![查看有效负载响应](/assets/images/payload_response_tab.png) 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 b9628c6a0872..de115a28089f 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 @@ -1,6 +1,6 @@ --- title: Web 挂钩事件和有效负载 -intro: 'For each webhook event, you can review when the event occurs, an example payload, and descriptions about the payload object parameters.' +intro: '对于每个 web 挂钩事件，您可以查看事件发生的时间、示例有效负载以及有关有效负载对象参数的说明。' product: '{% data reusables.gated-features.enterprise_account_webhooks %}' redirect_from: - /early-access/integrations/webhooks/ @@ -33,7 +33,7 @@ versions: {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} 更多信息请参阅“[构建 {% data variables.product.prodname_github_app %}](/apps/building-github-apps/)”。 -The unique properties for a webhook event are the same properties you'll find in the `payload` property when using the [Events API](/rest/reference/activity#events). 唯一的例外是 [`push` 事件](#push)。 `push` 事件 web 挂钩有效负载的独特属性与 Events API 中的 `payload` 属性不同。 Web 挂钩有效负载包含更详细的信息。 +Web 挂钩事件的独特属性与您使用[事件 API](/rest/reference/activity#events) 时在 `payload` 属性中发现的属性相同。 唯一的例外是 [`push` 事件](#push)。 `push` 事件 web 挂钩有效负载的独特属性与 Events API 中的 `payload` 属性不同。 Web 挂钩有效负载包含更详细的信息。 {% tip %} @@ -45,14 +45,14 @@ The unique properties for a webhook event are the same properties you'll find in 递送到 web 挂钩已配置 URL 端点的 HTTP POST 有效负载将包含几个特殊标头： -| 标头 | 描述 | -| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `X-GitHub-Event` | 触发递送的事件名称。 | -| `X-GitHub-Delivery` | A [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier) to identify the delivery.{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@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 != "github-ae@latest" %} -| `X-Hub-Signature` | This header is sent if the webhook is configured with a [`secret`](/rest/reference/repos#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 == "github-ae@latest" %} -| `X-Hub-Signature-256` | This header is sent if the webhook is configured with a [`secret`](/rest/reference/repos#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 %} +| 标头 | 描述 | +| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `X-GitHub-Event` | 触发递送的事件名称。 | +| `X-GitHub-Delivery` | 用于标识交付的 [GUID](http://en.wikipedia.org/wiki/Globally_unique_identifier)。{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@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 %}{% if currentVersion != "github-ae@latest" %} +| `X-Hub-Signature` | 如果使用 [`secret`](/rest/reference/repos#create-hook-config-params) 配置了 web 挂钩，则发送此标头。 这是请求正文的 HMAC 十六进制摘要，它是使用 SHA-1 哈希函数和作为 HMAC `key` 的 `secret` 生成的。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} 提供 `X-Hub-Signature` 是为了兼容现有集成，我们建议您使用更安全的 `X-Hub-Signature-256`。{% endif %}{% endif %}{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" or currentVersion == "github-ae@latest" %} +| `X-Hub-Signature-256` | 如果使用 [`secret`](/rest/reference/repos#create-hook-config-params) 配置了 web 挂钩，则发送此标头。 这是请求正文的 HMAC 十六进制摘要，它是使用 SHA-256 哈希函数和作为 HMAC `key` 的 `secret` 生成的。{% endif %} 此外，请求的 `User-Agent` 将含有前缀 `GitHub-Hookshot/`。 @@ -162,7 +162,7 @@ The unique properties for a webhook event are the same properties you'll find in {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} -`sender` | `object` | If the `action` is `reopened_by_user` or `closed_by_user`, the `sender` object will be the user that triggered the event. The `sender` object is empty for all other actions. +`sender` | `object` | 如果 `action` 是 `reopened_by_user` 或 `closed_by_user`，则 `sender` 对象将是触发事件的用户。 对于所有其他操作，`sender` 对象都为空。 #### Web 挂钩有效负载示例 @@ -195,7 +195,7 @@ The unique properties for a webhook event are the same properties you'll find in {% data reusables.webhooks.content_reference_short_desc %} -Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如果您注册了一个子域 (`https://subdomain.example.com`)，则只有该子域的 URL 才会触发此事件。 如果您注册了一个域 (`https://example.com`)，则该域及所有子域的 URL 都会触发此事件。 See "[Create a content attachment](/rest/reference/apps#create-a-content-attachment)" to create a new content attachment. +Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如果您注册了一个子域 (`https://subdomain.example.com`)，则只有该子域的 URL 才会触发此事件。 如果您注册了一个域 (`https://example.com`)，则该域及所有子域的 URL 都会触发此事件。 请参阅“[创建内容附件](/rest/reference/apps#create-a-content-attachment)”以创建新的内容附件。 只有 {% data variables.product.prodname_github_app %} 才能接收此事件。 {% data variables.product.prodname_github_app %} 必须具有 `content_references` `write` 权限才能订阅此事件。 @@ -430,7 +430,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 {% endnote %} -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} +{% if currentVersion == "free-pro-team@latest" %} {% note %} **注：**{% data reusables.pre-release-program.suspend-installation-beta %} 更多信息请参阅“[挂起 {% data variables.product.prodname_github_app %} 安装](/apps/managing-github-apps/suspending-a-github-app-installation/)”。 @@ -618,7 +618,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 ### meta -配置此事件的 web 挂钩已被删除。 此事件将仅监听对安装此事件的特定挂钩的更改。 Therefore, it must be selected for each hook that you'd like to receive meta events for. +配置此事件的 web 挂钩已被删除。 此事件将仅监听对安装此事件的特定挂钩的更改。 因此，必须为要接收元事件的每个挂钩选择它。 #### 可用性 @@ -675,11 +675,11 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ------------ | ----- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `action` | `字符串` | 执行的操作内容. Can be one of:{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} `created`,{% endif %} `deleted`, `renamed`, `member_added`, `member_removed`, or `member_invited`. | -| `邀请` | `对象` | 对用户的邀请或电子邮件邀请（如果操作为 `member_invited`）。 | -| `membership` | `对象` | 用户和组织之间的成员资格。 当操作为 `member_invited` 时不存在。 | +| 键 | 类型 | 描述 | +| ------------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} `created`、{% endif %} `deleted`、`renamed`、`member_added`、`member_removed` 或 `member_invited`。 | +| `邀请` | `对象` | 对用户的邀请或电子邮件邀请（如果操作为 `member_invited`）。 | +| `membership` | `对象` | 用户和组织之间的成员资格。 当操作为 `member_invited` 时不存在。 | {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} {% data reusables.webhooks.sender_desc %} @@ -715,7 +715,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 ### package -与 {% data variables.product.prodname_registry %} 有关的活动。 {% data reusables.webhooks.action_type_desc %} For more information, see the "[blocking organization users](/rest/reference/orgs#blocking)" REST API. 更多信息请参阅“[使用 {% data variables.product.prodname_registry %} 管理包](/github/managing-packages-with-github-packages)”以详细了解 {% data variables.product.prodname_registry %}。 +与 {% data variables.product.prodname_registry %} 有关的活动。 {% data reusables.webhooks.action_type_desc %}更多信息请参阅“[使用 {% data variables.product.prodname_registry %} 管理包](/github/managing-packages-with-github-packages)”以详细了解 {% data variables.product.prodname_registry %}。 #### 可用性 @@ -746,10 +746,10 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| ---- | ---- | -------------------------------------------------------------------------------------- | -| `id` | `整数` | 页面构建的唯一标识符。 | -| `构建` | `对象` | The [List GitHub Pages builds](/rest/reference/repos#list-github-pages-builds) itself. | +| 键 | 类型 | 描述 | +| ---- | ---- | ----------------------------------------------------------------------- | +| `id` | `整数` | 页面构建的唯一标识符。 | +| `构建` | `对象` | [列表 GitHub Pages 构建](/rest/reference/repos#list-github-pages-builds)本身。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -775,7 +775,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 | -------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `zen` | `字符串` | GitHub zen 的随机字符串。 | | `hook_id` | `整数` | 触发 ping 的 web 挂钩的 ID。 | -| `挂钩` | `对象` | The [webhook configuration](/rest/reference/repos#get-a-repository-webhook). | +| `挂钩` | `对象` | [web 挂钩配置](/rest/reference/repos#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 %} @@ -969,24 +969,24 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 #### Web 挂钩有效负载对象 -| 键 | 类型 | 描述 | -| -------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `ref` | `字符串` | The full [`git ref`](/rest/reference/git#refs) that was pushed. Example: `refs/heads/main`. | -| `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | -| `after` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | -| `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 If necessary, you can use the [Commits API](/rest/reference/repos#commits) to fetch additional commits. 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | -| `commits[][id]` | `字符串` | 提交的 SHA。 | -| `commits[][timestamp]` | `字符串` | The ISO 8601 timestamp of the commit. | -| `commits[][message]` | `字符串` | 提交消息. | -| `commits[][author]` | `对象` | 提交的 Git 作者。 | -| `commits[][author][name]` | `字符串` | Git 作者的名称。 | -| `commits[][author][email]` | `字符串` | Git 作者的电子邮件地址。 | -| `commits[][url]` | `url` | 指向提交 API 资源的 URL。 | -| `commits[][distinct]` | `布尔值` | 此提交是否与之前推送的任何提交不同。 | -| `commits[][added]` | `数组` | An array of files added in the commit. | -| `commits[][modified]` | `数组` | An array of files modified by the commit. | -| `commits[][removed]` | `数组` | An array of files removed in the commit. | -| `pusher` | `对象` | 推送提交的用户。 | +| 键 | 类型 | 描述 | +| -------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------- | +| `ref` | `字符串` | 被推送的完整 [`git ref`](/rest/reference/git#refs)。 例如：`refs/heads/main`。 | +| `before` | `字符串` | 推送之前在 `ref` 上最近提交的 SHA。 | +| `after` | `字符串` | 推送之后在 `ref` 上最近提交的 SHA。 | +| `commits` | `数组` | 描述所推送提交的提交对象数组。 （该数组最多包含 20 个提交。 如有必要，可使用[提交 API](/rest/reference/repos#commits) 获取更多提交。 此限制仅适用于时间表事件，而不适用于 web 挂钩递送。） | +| `commits[][id]` | `字符串` | 提交的 SHA。 | +| `commits[][timestamp]` | `字符串` | 提交的 ISO 8601 时间戳。 | +| `commits[][message]` | `字符串` | 提交消息. | +| `commits[][author]` | `对象` | 提交的 Git 作者。 | +| `commits[][author][name]` | `字符串` | Git 作者的名称。 | +| `commits[][author][email]` | `字符串` | Git 作者的电子邮件地址。 | +| `commits[][url]` | `url` | 指向提交 API 资源的 URL。 | +| `commits[][distinct]` | `布尔值` | 此提交是否与之前推送的任何提交不同。 | +| `commits[][added]` | `数组` | 在提交中添加的文件数组。 | +| `commits[][modified]` | `数组` | 由提交修改的文件数组。 | +| `commits[][removed]` | `数组` | 在提交中删除的文件数组。 | +| `pusher` | `对象` | 推送提交的用户。 | {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} @@ -1022,7 +1022,7 @@ Web 挂钩事件是基于您注册的域的特异性而触发的。 例如，如 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} ### repository_dispatch -This event occurs when a {% data variables.product.prodname_github_app %} sends a `POST` request to the "[Create a repository dispatch event](/rest/reference/repos#create-a-repository-dispatch-event)" endpoint. +当 {% data variables.product.prodname_github_app %} 将 `POST` 请求发送到“[创建仓库分发事件](/rest/reference/repos#create-a-repository-dispatch-event)”端点时，此事件发生。 #### 可用性 @@ -1047,7 +1047,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends | 键 | 类型 | 描述 | | -------- | ----- | -------------------------------------------- | -| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - 创建了仓库。
    • `deleted` - 仓库被删除。
    • `archived` - 仓库被存档。
    • `unarchived` - 仓库被取消存档。
      • {% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %}
    • `anonymous_access_enabled` - A repository is [enabled for anonymous Git access](/rest/overview/api-previews#anonymous-git-access-to-repositories), `anonymous_access_disabled` - A repository is [disabled for anonymous Git access](/rest/overview/api-previews#anonymous-git-access-to-repositories)
      • {% endif %}
    • `edited` - 仓库的信息被编辑。
    • `renamed` - 仓库被重命名。
    • `transferred` - 仓库被转让。
    • `publicized` - 仓库被设为公共。
    • `privatized` - 仓库被设为私有。
    | +| `action` | `字符串` | 执行的操作内容. 可以是以下选项之一：
    • `created` - 创建了仓库。
    • `deleted` - 仓库被删除。
    • `archived` - 仓库被存档。
    • `unarchived` - 仓库被取消存档。
      • {% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %}
    • `anonymous_access_enabled` - 仓库被[启用匿名 Git 访问](/rest/overview/api-previews#anonymous-git-access-to-repositories), `anonymous_access_disabled` - 仓库被[禁用匿名 Git 访问](/rest/overview/api-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 %} @@ -1060,7 +1060,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {% if currentVersion == "free-pro-team@latest"%} ### repository_import -{% data reusables.webhooks.repository_import_short_desc %} 要在个人仓库中接收此事件，必须在导入之前创建一个空仓库。 This event can be triggered using either the [GitHub Importer](/articles/importing-a-repository-with-github-importer/) or the [Source imports API](/rest/reference/migrations#source-imports). +{% data reusables.webhooks.repository_import_short_desc %} 要在个人仓库中接收此事件，必须在导入之前创建一个空仓库。 此事件可使用 [GitHub 导入工具](/articles/importing-a-repository-with-github-importer/)或[来源导入 API](/rest/reference/migrations#source-imports) 触发。 #### 可用性 @@ -1110,7 +1110,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends - 仓库 web 挂钩 - 组织 web 挂钩 -- {% data variables.product.prodname_github_app %}s with the `secret_scanning_alerts:read` permission +- 具有 `secret_scanning_alerts:read` 权限的 {% data variables.product.prodname_github_app %} #### Web 挂钩有效负载对象 @@ -1118,16 +1118,18 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {% data reusables.webhooks.repo_desc %} {% data reusables.webhooks.org_desc %} {% data reusables.webhooks.app_desc %} -`sender` | `object` | If the `action` is `resolved` or `reopened`, the `sender` object will be the user that triggered the event. The `sender` object is empty for all other actions. +`sender` | `object` | 如果 `action` 是 `resolved` 或 `reopened`，则 `sender` 对象将是触发事件的用户。 对于所有其他操作，`sender` 对象都为空。 #### Web 挂钩有效负载示例 {{ webhookPayloadsForCurrentVersion.secret_scanning_alert.reopened }} {% endif %} +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@1.19" %} ### security_advisory 与安全通告相关的活动。 安全通告提供有关 GitHub 软件中安全漏洞的信息。 安全通告数据集还支持 GitHub 安全警报，请参阅“[关于漏洞依赖项的安全警报](/articles/about-security-alerts-for-vulnerable-dependencies/)”。 +{% endif %} #### 可用性 @@ -1316,7 +1318,7 @@ This event occurs when a {% data variables.product.prodname_github_app %} sends {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ### workflow_dispatch -This event occurs when someone triggers a workflow run on GitHub or sends a `POST` request to the "[Create a workflow dispatch event](/rest/reference/actions/#create-a-workflow-dispatch-event)" endpoint. 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#workflow_dispatch)”。 +当有人触发 GitHub 上的工作流程运行或将 `POST` 请求发送到“[创建工作流程分发事件](/rest/reference/actions/#create-a-workflow-dispatch-event)”端点时，此事件发生。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#workflow_dispatch)”。 #### 可用性 @@ -1330,11 +1332,11 @@ This event occurs when someone triggers a workflow run on GitHub or sends a `POS {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} ### workflow_run -When a {% data variables.product.prodname_actions %} workflow run is requested or completed. 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#workflow_run)”。 +当 {% data variables.product.prodname_actions %} 工作流程运行被请求或完成时。 更多信息请参阅“[触发工作流程的事件](/actions/reference/events-that-trigger-workflows#workflow_run)”。 #### 可用性 -- {% data variables.product.prodname_github_app %}s with the `actions` or `contents` permissions. +- 具有 `actions` 或 `contents` 权限的 {% data variables.product.prodname_github_app %}。 #### Web 挂钩有效负载对象 diff --git a/translations/zh-CN/content/developers/webhooks-and-events/webhooks.md b/translations/zh-CN/content/developers/webhooks-and-events/webhooks.md index c1790a920c20..36b06b94e647 100644 --- a/translations/zh-CN/content/developers/webhooks-and-events/webhooks.md +++ b/translations/zh-CN/content/developers/webhooks-and-events/webhooks.md @@ -1,6 +1,6 @@ --- title: Web 挂钩 -intro: 'Learn to set up, test, and secure webhooks to integrate with {% data variables.product.prodname_dotcom %}.' +intro: '了解如何设置、测试和保护与 {% data variables.product.prodname_dotcom %} 集成的 web 挂钩。' mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md index f348234d87fe..674a34234612 100644 --- a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md +++ b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md @@ -1,54 +1,54 @@ --- -title: About discussions -intro: Use discussions to ask and answer questions, share information, make announcements, and conduct or participate in a conversation about a project on {% data variables.product.product_name %}. +title: 关于讨论 +intro: 使用讨论来提问和回答问题、共享信息、发布公告以及进行或参与有关 {% data variables.product.product_name %} 上项目的对话。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About discussions +### 关于讨论 -With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within the project's repository. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools. +使用 {% data variables.product.prodname_discussions %}，项目的社区可以创建和参与项目仓库中的对话。 讨论使项目的维护者、参与者和访问者能够在没有第三方工具的情况下，在中心位置收集和完成以下目标。 -- Share announcements and information, gather feedback, plan, and make decisions -- Ask questions, discuss and answer the questions, and mark the discussions as answered -- Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows +- 共享公告和信息、收集反馈、计划和决策 +- 提出问题、讨论和回答问题，以及将讨论标记为已回答 +- 为访客和贡献者营造一种邀请的氛围，讨论目标、发展、管理和工作流程 -![Discussions tab for a repository](/assets/images/help/discussions/hero.png) +![仓库的讨论选项卡](/assets/images/help/discussions/hero.png) -You don't need to close a discussion like you close an issue or a pull request. +您不需要像关闭议题或拉取请求那样结束讨论。 -If a repository administrator or project maintainer enables discussions for a repository, anyone who visits the repository can create and participate in discussions for the repository. Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. 更多信息请参阅“[组织的仓库权限级别](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)”。 +如果仓库管理员或项目维护者支持存储库的讨论，则访问仓库的任何人都可以创建和参与仓库的讨论。 仓库管理员和项目维护者可以管理仓库中的讨论和讨论类别，并固定讨论以提高讨论的可见性。 主持人和协作者可以将评论标记为答案、锁定讨论并将议题转换为讨论。 更多信息请参阅“[组织的仓库权限级别](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)”。 -For more information about management of discussions for your repository, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +有关管理仓库讨论的更多信息，请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)”。 -### About categories and formats for discussions +### 关于讨论的类别和格式 {% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %} -For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. {% data reusables.discussions.github-recognizes-members %} +对于采用问题/答案格式的讨论，讨论中的单个评论可以标记为讨论的答案。 {% data reusables.discussions.github-recognizes-members %} -For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +更多信息请参阅“[管理仓库中讨论的类别](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)”。 -### Best practices for discussions +### 讨论的最佳实践 -As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see "[Collaborating with maintainers using discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)." +作为社区成员或维护者，发起讨论以提出问题或讨论影响社区的信息。 更多信息请参阅“[使用讨论与维护者协作](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions)”。 -Participate in a discussion to ask and answer questions, provide feedback, and engage with the project's community. For more information, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +参与讨论、提出问题和回答问题、提供反馈，以及与项目的社区互动。 更多信息请参阅“[参与讨论](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)”。 -You can spotlight discussions that contain important, useful, or exemplary conversations among members in the community. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +您可以突出讨论社区成员之间重要、有益或堪称典范的对话。 更多信息请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)”。 -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %}更多信息请参阅“[主持仓库中的讨论](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)”。 ### 分享反馈 -You can share your feedback about {% data variables.product.prodname_discussions %} with {% data variables.product.company_short %}. To join the conversation, see [`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22). +您可以与 {% data variables.product.company_short %} 分享您对 {% data variables.product.prodname_discussions %} 的反馈。 要加入对话，请参阅 [`github/feedback`](https://github.com/github/feedback/discussions?discussions_q=category%3A%22Discussions+Feedback%22)。 ### 延伸阅读 -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" +- “[关于 {% data variables.product.prodname_dotcom %} 上的书写和格式化](/github/writing-on-github/about-writing-and-formatting-on-github)” +- "[搜索讨论](/github/searching-for-information-on-github/searching-discussions)" - "[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications)" - "[调解评论和对话](/github/building-a-strong-community/moderating-comments-and-conversations)" - “[在 {% data variables.product.prodname_dotcom %} 上维护您的安全](/github/building-a-strong-community/maintaining-your-safety-on-github)” diff --git a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index be12ce18c7ae..69682f65a3b5 100644 --- a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md @@ -1,48 +1,48 @@ --- -title: Collaborating with maintainers using discussions -shortTitle: Collaborating with maintainers -intro: You can contribute to the goals, plans, health, and community for a project on {% data variables.product.product_name %} by communicating with the maintainers of the project in a discussion. -permissions: People with read permissions to a repository can start and participate in discussions in the repository. +title: 使用讨论与维护者协作 +shortTitle: 与维护者协作 +intro: 您可以通过在讨论中与项目的维护者沟通，为 {% data variables.product.product_name %} 项目的目标、计划、运行状况和社区做出贡献。 +permissions: 对仓库具有读取权限的人可以发起及参与仓库中的讨论。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About collaboration with maintainers using discussions +### 关于使用讨论与维护者协作 -{% data reusables.discussions.about-discussions %} If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "[‎About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} 如果您使用或参与某个项目，可以发起讨论，以提出建议，并就您的计划、问题、想法和反馈与维护者及社区成员进行互动。 更多信息请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions)”。 -{% data reusables.discussions.about-categories-and-formats %} Repository administrators and project maintainers can delete a discussion. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)." +{% data reusables.discussions.about-categories-and-formats %} 仓库管理员和项目维护者可以删除讨论。 更多信息请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#deleting-a-discussion)”。 -{% data reusables.discussions.github-recognizes-members %} These members appear in a list of the most helpful contributors to the project's discussions. As your project grows, you can grant higher access permissions to active members of your community. For more information, see "[Granting higher permissions to top contributors](/discussions/guides/granting-higher-permissions-to-top-contributors)" +{% data reusables.discussions.github-recognizes-members %} 这些成员出现在对项目讨论最有帮助的贡献者名单中。 随着项目的发展，您可以向社区的活动成员授予更高的访问权限。 更多信息请参阅“[向顶级贡献者授予更高权限](/discussions/guides/granting-higher-permissions-to-top-contributors)” -![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) +![对项目讨论最有帮助的贡献者](/assets/images/help/discussions/most-helpful.png) -For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." +有关参与讨论的信息，请参阅“[参与讨论](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)”。 ### 基本要求 -To collaborate with maintainers using discussions, a repository administrator or project maintainer must enable discussions for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +为使用讨论与维护者协作，仓库管理员或项目维护者必须为仓库启用讨论。 更多信息请参阅“[启用和禁用仓库讨论](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)”。 -### Starting a discussion +### 开始讨论 {% data reusables.discussions.starting-a-discussion %} -### Filtering the list of discussions +### 过滤讨论列表 -You can search for discussions and filter the list of discussions in a repository. For more information, see "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)." +您可以在仓库中搜索讨论并过滤讨论列表。 更多信息请参阅“[搜索讨论](/github/searching-for-information-on-github/searching-discussions)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the **Search all discussions** field, type a search query. Optionally, to the right of the search field, click a button to further filter the results. ![Search bar and buttons for filtering discussions](/assets/images/help/discussions/search-and-filter-controls.png) -1. In the list of discussions, click the discussion you want to view. ![Discussion search results](/assets/images/help/discussions/search-result.png) +1. 在 **Search all discussions（搜索所有讨论）** 字段中输入搜索查询。 （可选）在搜索字段右侧，单击按钮以进一步过滤结果。 ![用于过滤讨论的搜索栏和按钮](/assets/images/help/discussions/search-and-filter-controls.png) +1. 在讨论列表中，单击要查看的讨论。 ![讨论搜索结果](/assets/images/help/discussions/search-result.png) -### Converting an issue to a discussion +### 将议题转换为讨论 -{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions in your repository](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)." +{% data reusables.discussions.you-can-convert-an-issue %}更多信息请参阅“[主持仓库中的讨论](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion#converting-an-issue-to-a-discussion)”。 ### 延伸阅读 -- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +- “[关于 {% data variables.product.prodname_dotcom %} 上的书写和格式化](/github/writing-on-github/about-writing-and-formatting-on-github)” - “[在 {% data variables.product.prodname_dotcom %} 上维护您的安全](/github/building-a-strong-community/maintaining-your-safety-on-github)” diff --git a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/index.md b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/index.md index 44aed03c8b9e..fc53b88e390e 100644 --- a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/index.md +++ b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/index.md @@ -1,7 +1,7 @@ --- -title: Collaborating with your community using discussions -shortTitle: Collaborating using discussions -intro: Gather and discuss your project with community members and other maintainers. +title: 使用讨论与社区协作 +shortTitle: 使用讨论进行协作 +intro: 与社区成员和其他维护者一起收集和讨论您的项目。 versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index c16fa4f3a7df..b0263490ee97 100644 --- a/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/translations/zh-CN/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -1,31 +1,31 @@ --- -title: Participating in a discussion -intro: You can converse with the community and maintainers in a forum within the repository for a project on {% data variables.product.product_name %}. -permissions: People with read permissions to a repository can participate in discussions in the repository. +title: 参与讨论 +intro: 您可以在仓库的论坛中与社区和维护者交流 {% data variables.product.product_name %} 上的项目。 +permissions: 对仓库具有读取权限的人可以参与仓库中的讨论。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About participation in a discussion +### 关于参与讨论 -{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} 更多信息请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions)”。 -In addition to starting or viewing a discussion, you can comment in response to the original comment from the author of the discussion. You can also create a comment thread by replying to an individual comment that another community member made within the discussion, and react to comments with emoji. For more information about reactions, see "[About conversations on {% data variables.product.prodname_dotcom %}](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)." +除了开始或查看讨论之外，您还可以对讨论作者的原始评论做出响应。 您还可以通过回复其他社区成员在讨论中进行的个人评论，以及使用表情符号对评论做出反应来创建评论线程。 有关反应的更多信息，请参阅“[关于 {% data variables.product.prodname_dotcom %} 上的对话](/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github#reacting-to-ideas-in-comments)”。 -You can block users and report disruptive content to maintain a safe and pleasant environment for yourself on {% data variables.product.product_name %}. For more information, see "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/github/building-a-strong-community/maintaining-your-safety-on-github)." +您可以阻止用户并报告破坏性内容，以便自己在 {% data variables.product.product_name %} 上保持一个安全愉快的环境。 更多信息请参阅“[保持您在 {% data variables.product.prodname_dotcom %} 上的安全](/github/building-a-strong-community/maintaining-your-safety-on-github)”。 ### 基本要求 -Discussions must be enabled for the repository for you to participate in a discussion in the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +必须对仓库启用讨论，您才可以参与仓库中的讨论。 更多信息请参阅“[启用和禁用仓库讨论](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)”。 -### Creating a discussion +### 创建讨论 {% data reusables.discussions.starting-a-discussion %} -### Marking a comment as an answer +### 将评论标记为答案 -Discussion authors and users with the triage role or greater for a repository can mark a comment as the answer to a discussion in the repository. +对于仓库具有分类角色或更高角色的讨论作者和用户可以将评论标记为仓库中讨论的答案。 {% data reusables.discussions.marking-a-comment-as-an-answer %} diff --git a/translations/zh-CN/content/discussions/guides/best-practices-for-community-conversations-on-github.md b/translations/zh-CN/content/discussions/guides/best-practices-for-community-conversations-on-github.md index ec1a20ae298c..a40d2d9626d7 100644 --- a/translations/zh-CN/content/discussions/guides/best-practices-for-community-conversations-on-github.md +++ b/translations/zh-CN/content/discussions/guides/best-practices-for-community-conversations-on-github.md @@ -1,45 +1,45 @@ --- -title: Best practices for community conversations on GitHub -shortTitle: Best practices for community conversations -intro: 'You can use discussions to brainstorm with your team, and eventually move the conversation to a discussion when you are ready to scope out the work.' +title: GitHub 上社区对话的最佳实践 +shortTitle: 社区对话的最佳实践 +intro: '您可以使用讨论与团队进行头脑风暴，并在准备好确定工作范围时最终将对话移动到讨论中。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Community conversations in {% data variables.product.prodname_discussions %} +### {% data variables.product.prodname_discussions %} 中的社区对话 -Since {% data variables.product.prodname_discussions %} is an open forum, there is an opportunity to bring non-code collaboration into a project's repository and gather diverse feedback and ideas more quickly. You can help drive a productive conversation by: +由于 {% data variables.product.prodname_discussions %} 是一个开放的论坛，因此有机会将非代码协作引入项目的仓库，并更快地收集各种反馈和想法。 您可以通过以下方式帮助推动富有成果的对话： -- Asking pointed questions and follow-up questions to garner specific feedback -- Capture a diverse experience and distill it down to main points -- Open an issue to take action based on the conversation, where applicable +- 提出针对性的问题和后续问题，以收集具体反馈 +- 获取不同的体验并提炼到要点 +- 打开议题，根据对话采取行动（如果适用） -For more information about opening an issue and cross-referencing a discussion, see "[Opening an issue from a comment](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)." +有关打开议题和交叉引用讨论的更多信息，请参阅“[从评论打开议题](/github/managing-your-work-on-github/opening-an-issue-from-a-comment)”。 -### Learning about conversations on GitHub +### 了解 GitHub 中的对话 -You can create and participate in discussions, issues, and pull requests, depending on the type of conversation you'd like to have. +您可以创建和参与讨论、议题及拉取请求，具体取决于您希望进行的对话类型。 -You can use {% data variables.product.prodname_discussions %} to discuss big picture ideas, brainstorm, and spike out a project's specific details before committing it to an issue, which can then be scoped. Discussions are useful for teams if: -- You are in the discovery phase of a project and are still learning which director your team wants to go in -- You want to collect feedback from a wider community about a project -- You want to keep bug fixes, feature requests, and general conversations separate +您可以使用 {% data variables.product.prodname_discussions %} 讨论大局想法、集思广益，并在将项目提交到议题之前，先找出项目的具体细节，然后可以确定议题的范围。 在以下情况下，讨论对团队非常有用： +- 您处于项目的发现阶段，仍在了解您的团队希望由哪个主管领导 +- 您希望从更广泛的社区收集有关项目的反馈 +- 您希望将漏洞修复、功能请求和常规对话分开 议题适用于讨论项目的具体细节，如漏洞修复和计划的改进。 更多信息请参阅“[关于议题](/articles/about-issues)”。 拉取请求允许您直接评论提议的更改。 更多信息请参阅“[关于拉取请求](/articles/about-pull-requests)”和“[评论拉取请求](/articles/commenting-on-a-pull-request)”。 {% data reusables.organizations.team-discussions-purpose %} 更多信息请参阅“[关于团队讨论](/articles/about-team-discussions)”。 -### Following contributing guidelines +### 遵守参与指南 -Before you open a discussion, check to see if the repository has contributing guidelines. The CONTRIBUTING file includes information about how the repository maintainer would like you to contribute ideas to the project. +在打开讨论之前，检查仓库是否有参与指南。 CONTRIBUTING 文件包含仓库维护员希望您如何向项目贡献想法的信息。 更多信息请参阅“[设置健康参与的项目](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)”。 ### 后续步骤 -To continue learning about {% data variables.product.prodname_discussions %} and quickly create a discussion for your community, see "[Quickstart for {% data variables.product.prodname_discussions %}](/discussions/quickstart)." +要继续了解 {% data variables.product.prodname_discussions %} 并快速创建社区的讨论，请参阅“[{% data variables.product.prodname_discussions %} 快速入门](/discussions/quickstart)”。 ### 延伸阅读 diff --git a/translations/zh-CN/content/discussions/guides/finding-discussions-across-multiple-repositories.md b/translations/zh-CN/content/discussions/guides/finding-discussions-across-multiple-repositories.md index dddf07b20ac0..37216b8af98d 100644 --- a/translations/zh-CN/content/discussions/guides/finding-discussions-across-multiple-repositories.md +++ b/translations/zh-CN/content/discussions/guides/finding-discussions-across-multiple-repositories.md @@ -1,20 +1,20 @@ --- -title: Finding discussions across multiple repositories -intro: 'You can easily access every discussion you''ve created or participated in across multiple repositories.' +title: 在多个仓库中查找讨论 +intro: '您可以轻松地访问您在多个仓库中创建或参与的每个讨论。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Finding discussions +### 查找讨论 1. 导航至 {% data variables.product.prodname_dotcom_the_website %}。 -1. In the top-right corner of {% data variables.product.prodname_dotcom_the_website %}, click your profile photo, then click **Your discussions**. !["Your discussions" in drop-down menu for profile photo on {% data variables.product.product_name %}](/assets/images/help/discussions/your-discussions.png) -1. Toggle between **Created** and **Commented** to see the discussions you've created or participated in. +1. 在 {% data variables.product.prodname_dotcom_the_website %} 的右上角，单击您的个人资料照片，然后单击 **Your discussions（您的讨论）**。 ![{% data variables.product.product_name %} 上个人资料照片下拉菜单中的"您的讨论"](/assets/images/help/discussions/your-discussions.png) +1. 在 **Created（已创建）**与 **Commented（已评论）**之间切换，以查看您创建或参与的讨论。 ### 延伸阅读 -- "[Searching discussions](/github/searching-for-information-on-github/searching-discussions)" +- "[搜索讨论](/github/searching-for-information-on-github/searching-discussions)" - "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)" - "[Managing discussions for your community](/discussions/managing-discussions-for-your-community)" diff --git a/translations/zh-CN/content/discussions/guides/granting-higher-permissions-to-top-contributors.md b/translations/zh-CN/content/discussions/guides/granting-higher-permissions-to-top-contributors.md index 906d7feb0ad5..d40f6f7c6bb4 100644 --- a/translations/zh-CN/content/discussions/guides/granting-higher-permissions-to-top-contributors.md +++ b/translations/zh-CN/content/discussions/guides/granting-higher-permissions-to-top-contributors.md @@ -1,6 +1,6 @@ --- -title: Granting higher permissions to top contributors -intro: 'Repository administrators can promote any community member to a moderator and maintainer.' +title: 向顶级贡献者授予更高的权限 +intro: '仓库管理员可以将任何社区成员提升到主持人和维护员。' versions: free-pro-team: '*' --- @@ -9,24 +9,24 @@ versions: ### 简介 -The most helpful contributors for the past 30 days are highlighted on the {% data variables.product.prodname_discussions %} dashboard, based on how many comments were marked as answers by other community members. Helpful contributors can help drive a healthy community and moderate and guide the community space in addition to maintainers. +根据有多少条评论被其他社区成员标记为答案，过去 30 天内最有帮助的贡献者会在 {% data variables.product.prodname_discussions %} 仪表板上突出显示。 除了维护者之外，有帮助的贡献者也可以帮助推动一个健康的社区并主持和指导社区空间。 -### Step 1: Audit your discussions top contributors +### 第 1 步：审核讨论的顶级贡献者 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. Compare the list of contributors with their access permissions to see who qualifies to moderate the discussion. +1. 将贡献者列表与其访问权限进行比较，看谁有资格主持讨论。 -### Step 2: Review permission levels for discussions +### 第 2 步：审查讨论的权限级别 -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +对仓库具有分类权限的人可以通过将评论标记为答案、锁定不再有用或对社区造成损害的讨论，以及在想法仍处于开发的早期阶段时将问题转换为讨论，从而帮助主持项目的讨论。 更多信息请参阅“[主持讨论](/discussions/managing-discussions-for-your-community/moderating-discussions)”。 -For more information about repository permission levels and {% data variables.product.prodname_discussions %}, see "[Repository permissions levels for an organization](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)." +有关仓库权限级别和 {% data variables.product.prodname_discussions %} 的更多信息，请参阅“[组织的仓库权限级别](/github/setting-up-and-managing-organizations-and-teams/repository-permission-levels-for-an-organization)”。 -### Step 3: Change permissions levels for top contributors +### 第 3 步：更改顶级贡献者的权限级别 -You can change a contributor's permission levels to give them more access to the tooling they need to moderate GitHub Discussions. To change a person's or team's permission levels, see "[Managing teams and people with access to your repository](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)." +您可以更改贡献者的权限级别，使他们能够更多地访问他们需要的 GitHub 讨论工具。 要更改个人或团队的权限级别，请参阅“[管理有权访问您的仓库的团队和人员](/github/administering-a-repository/managing-teams-and-people-with-access-to-your-repository)”。 -### Step 4: Notify community members of elevated access +### 第 4 步：向社区成员通知提升的访问权限 -When you change a collaborators permission level, they will receive a notification for the change. +当您更改协作者权限级别时，他们将收到更改通知。 diff --git a/translations/zh-CN/content/discussions/guides/index.md b/translations/zh-CN/content/discussions/guides/index.md index 1f16f604790f..13eff1cc5794 100644 --- a/translations/zh-CN/content/discussions/guides/index.md +++ b/translations/zh-CN/content/discussions/guides/index.md @@ -1,21 +1,21 @@ --- -title: Discussions guides +title: 讨论指南 shortTitle: 指南 -intro: 'Discover pathways to get started or learn best practices for participating or monitoring your community''s discussions.' +intro: '了解开始或学习参与或监控社区讨论的最佳做法的途径。' versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### Getting started with discussions +### 开始讨论 {% link_in_list /about-discussions %} {% link_in_list /best-practices-for-community-conversations-on-github %} {% link_in_list /finding-discussions-across-multiple-repositories %} -### Administering discussions +### 管理讨论 {% link_in_list /granting-higher-permissions-to-top-contributors %} diff --git a/translations/zh-CN/content/discussions/index.md b/translations/zh-CN/content/discussions/index.md index bfbd387225ca..2193cabe0b4a 100644 --- a/translations/zh-CN/content/discussions/index.md +++ b/translations/zh-CN/content/discussions/index.md @@ -1,8 +1,8 @@ --- -title: GitHub Discussions Documentation +title: GitHub Discussions 文档 beta_product: true shortTitle: GitHub Discussions -intro: '{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Community members can ask and answer questions, share updates, have open-ended conversations, and follow along on decisions affecting the community''s way of working.' +intro: '{% data variables.product.prodname_discussions %} 是一个围绕开源项目为社区提供协作沟通的论坛。 社区成员可以提出和回答问题，分享更新，进行开放式对话，并关注影响社区工作方式的决策。' introLinks: quickstart: /discussions/quickstart featuredLinks: @@ -37,19 +37,19 @@ versions: {% assign discussionsCommunityExamples = site.data.variables.discussions_community_examples %} {% if discussionsCommunityExamples %}
    -

    Communities using discussions

    +

    使用讨论的社区

    {% render 'discussions-community-card' for discussionsCommunityExamples as example %}
    {% if discussionsCommunityExamples.length > 6 %} - + {% endif %}
    {% octicon "search" width="24" %}

    抱歉，找不到结果

    似乎没有适合您的过滤条件的示例。
    请尝试其他过滤条件或添加代码示例

    - Add your community {% octicon "arrow-right" %} + 添加您的社区 {% octicon "arrow-right" %}
    {% endif %} diff --git a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/index.md b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/index.md index 8ccb2875b2fe..73fa1b886c4b 100644 --- a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/index.md +++ b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/index.md @@ -1,7 +1,7 @@ --- -title: Managing discussions for your community -shortTitle: Managing discussions -intro: 'You can enable and configure discussions for your repository, and you can use tools on {% data variables.product.product_name %} to moderate conversations among community members.' +title: 管理社区的讨论 +shortTitle: 管理讨论 +intro: '您可以为仓库启用和配置讨论，还可以使用 {% data variables.product.product_name %} 上的工具主持社区成员之间的对话。' versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md index fe2bfbd824b8..a94d12abc118 100644 --- a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md +++ b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository.md @@ -1,56 +1,56 @@ --- -title: Managing categories for discussions in your repository -intro: You can categorize the discussions in your repository to organize conversations for your community members, and you can choose a format for each category. -permissions: Repository administrators and people with write or greater access to a repository can enable discussions in the repository. +title: 管理仓库中讨论的类别 +intro: 您可以对仓库中的讨论进行分类，以组织社区成员的对话，也可为每个类别选择格式。 +permissions: 仓库管理员以及对仓库具有写入或更大访问权限的人员可以在仓库中启用讨论。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About categories for discussions +### 关于讨论类别 {% data reusables.discussions.about-discussions %} {% data reusables.discussions.about-categories-and-formats %} -Each category must have a unique name and emoji pairing, and can be accompanied by a detailed description stating its purpose. Categories help maintainers organize how conversations are filed and are customizable to help distinguish categories that are Q&A or more open-ended conversations.{% data reusables.discussions.repository-category-limit %} +每个类别必须具有唯一的名称和表情符号配对，并可以附有说明其用途的详细说明。 类别帮助维护者组织如何提交对话，并可自定义，以帮助区分问答或更多开放式对话的类别。{% data reusables.discussions.repository-category-limit %} -For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +更多信息请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)”。 -### Default categories +### 默认类别 -| 分类 | Purpose | 类型 | -|:--------------- |:-------------------------------------------------------------------- |:--------------------- | -| #️⃣ General | Anything and everything relevant to the project | Open-ended discussion | -| 💡Ideas | Ideas to change or improve the project | Open-ended discussion | -| 🙏 Q&A | Questions for the community to answer, with a question/answer format | Question and Answer | -| 🙌 Show and tell | Creations, experiments, or tests relevant to the project | Open-ended discussion | +| 分类 | 目的 | 类型 | +|:------- |:------------------- |:----- | +| #️⃣ 常规 | 与项目相关的任何及所有内容 | 开放式讨论 | +| 💡想法 | 改变或改进项目的想法 | 开放式讨论 | +| 🙏 问答 | 供社区回答的问题，使用问题/回答的形式 | 问题及解答 | +| 🙌 展示和说明 | 与项目有关的创作、试验或测试 | 开放式讨论 | -### Creating a category +### 创建类别 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.edit-categories %} -1. Click **New category**. !["New category" button above list of discussion categories for a repository](/assets/images/help/discussions/click-new-category-button.png) -1. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." ![Emoji, title, description, and discussion format for new category](/assets/images/help/discussions/edit-category-details.png) -1. 单击 **Create（创建）**。 !["Create" button for new category](/assets/images/help/discussions/new-category-click-create-button.png) +1. 单击 **New category（新类别）**。 ![仓库讨论类别列表上方的"新类别"按钮](/assets/images/help/discussions/click-new-category-button.png) +1. 编辑类别的表情符号、标题、说明和讨论格式。 有关讨论格式的更多信息，请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)”。 ![新类别的表情符号、标题、说明和讨论格式](/assets/images/help/discussions/edit-category-details.png) +1. 单击 **Create（创建）**。 ![新类别的"创建"按钮](/assets/images/help/discussions/new-category-click-create-button.png) -### Editing a category +### 编辑类别 -You can edit a category to change the category's emoji, title, description, and discussion format. +您可以编辑类别以更改类别的表情符号、标题、说明和讨论格式。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "pencil" aria-label="The pencil icon" %}. ![Edit button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-edit-for-category.png) +1. 在列表中类别右侧，单击 {% octicon "pencil" aria-label="The pencil icon" %}。 ![仓库类别列表中类别右侧的编辑按钮](/assets/images/help/discussions/click-edit-for-category.png) 1. {% data reusables.discussions.edit-category-details %} -![Editing emoji, title, description, and discussion format for existing category](/assets/images/help/discussions/edit-existing-category-details.png) -1. 单击 **Save changes（保存更改）**。 !["Save changes" button for existing category](/assets/images/help/discussions/existing-category-click-save-changes-button.png) +![编辑现有类别的表情符号、标题、说明和讨论格式](/assets/images/help/discussions/edit-existing-category-details.png) +1. 单击 **Save changes（保存更改）**。 ![现有类别的"保存更改"按钮](/assets/images/help/discussions/existing-category-click-save-changes-button.png) -### Deleting a category +### 删除类别 -When you delete a category, {% data variables.product.product_name %} will move all discussions in the deleted category to an existing category that you choose. +删除类别时，{% data variables.product.product_name %} 会将已删除类别中的所有讨论移到您选择的现有类别。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. To the right of a category in the list, click {% octicon "trash" aria-label="The trash icon" %}. ![Trash button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-delete-for-category.png) -1. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/choose-new-category.png) -1. Click **Delete & Move**. ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/click-delete-and-move-button.png) +1. 在列表中类别右侧，单击 {% octicon "trash" aria-label="The trash icon" %}。 ![仓库类别列表中类别右侧的垃圾桶按钮](/assets/images/help/discussions/click-delete-for-category.png) +1. 使用下拉菜单，为要删除的类别中的任何讨论选择新类别。 ![删除现有类别时用于选择新类别的下拉菜单](/assets/images/help/discussions/choose-new-category.png) +1. 单击 **Delete & Move（删除并移动）**。 ![删除现有类别时用于选择新类别的下拉菜单](/assets/images/help/discussions/click-delete-and-move-button.png) diff --git a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md index 07f315e23b2a..713540bbd443 100644 --- a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md +++ b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository.md @@ -1,94 +1,94 @@ --- -title: Managing discussions in your repository -intro: You can categorize, spotlight, transfer, or delete the discussions in a repository. -permissions: Repository administrators and people with write or greater access to a repository can manage discussions in the repository. +title: 管理仓库中的讨论 +intro: 您可以对仓库中的讨论进行分类、聚焦、转让或删除。 +permissions: 仓库管理员以及对仓库具有写入或更大访问权限的人员可以管理仓库中的讨论。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About management of discussions +### 关于讨论的管理 -{% data reusables.discussions.about-discussions %} For more information about discussions, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +{% data reusables.discussions.about-discussions %} 有关讨论的更多信息，请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions)”。 -Organization owners can choose the permissions required to create a discussion for repositories owned by the organization. For more information, see "[Managing discussion creation for repositories in your organization](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)." +组织所有者可以选择为组织拥有的仓库创建讨论所需的权限。 更多信息请参阅“[管理组织中仓库的讨论创建](/github/setting-up-and-managing-organizations-and-teams/managing-discussion-creation-for-repositories-in-your-organization)”。 -As a discussions maintainer, you can create community resources to encourage discussions that are aligned with the overall project goal and maintain a friendly open forum for collaborators. Creating a code of conduct or contribution guidelines for collaborators to follow will help facilitate a collaborative and productive forum. For more information on creating community resources, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)," and "[Setting guidelines for repository contributors](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)." +作为讨论维护者，您可以创建社区资源，以鼓励与总体项目目标一致的讨论，并为协作者维护一个友好、开放的论坛。 为协作者制定行为守则或参与指南将有助于促进协作和富有成效的论坛。 有关创建社区资源的更多信息，请参阅“[为项目中添加行为准则](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)”和“[设置仓库参与者指南](/github/building-a-strong-community/setting-guidelines-for-repository-contributors)”。 -For more information on facilitating a healthy discussion, see "[Moderating comments and conversations](/github/building-a-strong-community/moderating-comments-and-conversations)." +有关引导健康的讨论的更多信息，请参阅“[调解评论和对话](/github/building-a-strong-community/moderating-comments-and-conversations)”。 ### 基本要求 -To manage discussions in a repository, discussions must be enabled for the repository. For more information, see "[Enabling or disabling discussions for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." +要管理仓库中的讨论，必须为存储库启用讨论。 更多信息请参阅“[启用和禁用仓库讨论](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)”。 -### Changing the category for a discussion +### 更改讨论类别 -You can categorize discussions to help community members find related discussions. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" article. +您可以对讨论进行分类，以帮助社区成员查找相关的讨论。 更多信息请参阅“[管理仓库中讨论的类别](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)”文章。 -You can also move a discussion to a different category. +您也可以将讨论移动到另一个类别。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. 在右侧侧边栏中，单击 {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion（编辑固定的讨论）**。 ![讨论右侧边栏中的"固定讨论"](/assets/images/help/discussions/click-edit-pinned-discussion.png) -### Pinning a discussion +### 固定讨论 -You can pin up to four important discussions above the list of discussions for the repository. +您可以在仓库讨论列表上固定多达四个重要的讨论。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-pin-discussion.png) -1. Optionally, customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. 在右侧边栏中，单击 {% octicon "pin" aria-label="The pin icon" %} **Pin discussion（固定讨论）**。 ![讨论右侧边栏中的"固定讨论"](/assets/images/help/discussions/click-pin-discussion.png) +1. （可选）自定义固定讨论的外观。 ![固定讨论的自定义选项](/assets/images/help/discussions/customize-pinned-discussion.png) +1. 单击 **Pin discussion（固定讨论）**。 ![固定的讨论自定义选项下的"固定讨论"按钮](/assets/images/help/discussions/click-pin-discussion-button.png) -### Editing a pinned discussion +### 编辑固定的讨论 -Editing a pinned discussion will not change the discussion's category. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)." +编辑固定的讨论不会更改讨论的类别。 更多信息请参阅“[管理仓库中讨论的类别](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. !["Pin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png) -1. Customize the look of the pinned discussion. ![Customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png) -1. Click **Pin discussion**. !["Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png) +1. 在右侧侧边栏中，单击 {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion（编辑固定的讨论）**。 ![讨论右侧边栏中的"固定讨论"](/assets/images/help/discussions/click-edit-pinned-discussion.png) +1. 自定义固定的讨论的外观。 ![固定讨论的自定义选项](/assets/images/help/discussions/customize-pinned-discussion.png) +1. 单击 **Pin discussion（固定讨论）**。 ![固定的讨论自定义选项下的"固定讨论"按钮](/assets/images/help/discussions/click-pin-discussion-button.png) -### Unpinning a discussion +### 取消固定讨论 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion**. !["Unpin discussion" in right sidebar for discussion](/assets/images/help/discussions/click-unpin-discussion.png) -1. Read the warning, then click **Unpin discussion**. !["Unpin discussion" button beneath warning in modal](/assets/images/help/discussions/click-unpin-discussion-button.png) +1. 在右侧边栏中，单击 {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion（取消固定讨论）**。 ![讨论右侧边栏中的"取消固定讨论"](/assets/images/help/discussions/click-unpin-discussion.png) +1. 阅读警告，然后单击 **Unpin discussion（取消固定讨论）**。 ![模式中警告下方的"取消固定讨论"按钮](/assets/images/help/discussions/click-unpin-discussion-button.png) -### Transferring a discussion +### 转让讨论 -To transfer a discussion, you must have permissions to create discussions in the repository where you want to transfer the discussion. +要转让讨论，您必须具有在要转让讨论的仓库中创建讨论的权限。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "arrow-right" aria-label="The right arrow icon" %} **Transfer discussion**. !["Transfer discussion" in right sidebar for discussion](/assets/images/help/discussions/click-transfer-discussion.png) -1. Select the **Choose a repository** drop-down, and click the repository you want to transfer the discussion to. !["Choose a repository" drop-down, "Find a repository" search field, and repository in list](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) -1. Click **Transfer discussion**. !["Transfer discussion" button](/assets/images/help/discussions/click-transfer-discussion-button.png) +1. 在右侧边栏中，单击 {% octicon "arrow-right" aria-label="The right arrow icon" %} **Transfer discussion（转让讨论）**。 ![讨论右侧边栏中的"转让讨论"](/assets/images/help/discussions/click-transfer-discussion.png) +1. 选择 **Choose a repository（选择仓库）**下拉菜单，并单击讨论要转让到的仓库。 !["选择仓库"下拉列表、"查找仓库"搜索字段以及列表中的仓库](/assets/images/help/discussions/use-choose-a-repository-drop-down.png) +1. 单击 **Transfer discussion（转让讨论）**。 !["转让讨论"按钮](/assets/images/help/discussions/click-transfer-discussion-button.png) -### Deleting a discussion +### 删除讨论 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} {% data reusables.discussions.click-discussion-in-list %} -1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**. !["Delete discussion" in right sidebar for discussion](/assets/images/help/discussions/click-delete-discussion.png) -1. Read the warning, then click **Delete this discussion**. !["Delete this discussion" button beneath warning in modal](/assets/images/help/discussions/click-delete-this-discussion-button.png) +1. 在右侧边栏中，单击 {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion（删除讨论）**。 ![讨论右侧边栏中的"删除讨论"](/assets/images/help/discussions/click-delete-discussion.png) +1. 阅读警告，然后单击 **Delete this discussion（删除此讨论）**。 ![模式中警告下方的"删除此讨论"按钮](/assets/images/help/discussions/click-delete-this-discussion-button.png) -### Converting issues based on labels +### 基于标签转换议题 -You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure. +您可以将具有相同标签的所有议题批量转换为讨论。 具有此标签的未来议题也将自动转换为您配置的讨论和类别。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} {% data reusables.project-management.labels %} -1. Next to the label you want to convert to issues, click **Convert issues**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. 在要转换为议题的标签旁边，单击 **Convert issues（转换议题）**。 +1. 选择 **Choose a category（选择类别）**下拉菜单，然后单击讨论的类别。 +1. 单击 **I understand, convert this issue to a discussion（我了解，请将此议题转换为讨论）**。 diff --git a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/moderating-discussions.md b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/moderating-discussions.md index 2c91d32d89f6..f3499de89cd0 100644 --- a/translations/zh-CN/content/discussions/managing-discussions-for-your-community/moderating-discussions.md +++ b/translations/zh-CN/content/discussions/managing-discussions-for-your-community/moderating-discussions.md @@ -1,39 +1,39 @@ --- -title: Moderating discussions -intro: 'You can promote healthy collaboration by marking comments as answers, locking or unlocking discussions, and converting issues to discussions. and editing or deleting comments, discussions, and categories that don''t align with your community''s code of conduct to discussions.' -permissions: People with triage access to a repository can moderate discussions in the repository. +title: 主持讨论 +intro: '您可以通过将评论标记为答案、锁定或解锁讨论以及将问题转化为讨论来促进健康的协作。 以及编辑或删除与社区行为准则不一致的评论、讨论和类别。' +permissions: 对仓库具有分类权限的人可以主持仓库中的讨论。 versions: free-pro-team: '*' --- {% data reusables.discussions.beta %} -### About moderating discussions +### 关于主持讨论 -{% data reusables.discussions.about-discussions %} If you have triage permissions for a repository, you can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. +{% data reusables.discussions.about-discussions %}如果您对仓库具有分类权限，便可通过将评论标记为答案、锁定不再有用或对社区造成损害的讨论，以及在想法仍处于开发的早期阶段时将问题转换为讨论，从而帮助主持项目的讨论。 -### Marking a comment as an answer +### 将评论标记为答案 {% data reusables.discussions.marking-a-comment-as-an-answer %} -### Locking discussions +### 锁定讨论 -It's appropriate to lock a conversation when the entire conversation is not constructive or violates your community's code of conduct or {% data variables.product.prodname_dotcom %}'s [Community Guidelines](/github/site-policy/github-community-guidelines). You can also lock a conversation to prevent comments on a discussion you want to use as an announcement to the community. When you lock a conversation, people with write access to the repository will still be able to comment on the discussion. +当整个对话没有建设性或者违反社区的行为准则或 {% data variables.product.prodname_dotcom %} 的[社区指导方针](/github/site-policy/github-community-guidelines)时，锁定对话是明智之举。 您还可以锁定对话，以防止对要用作社区公告的讨论发表评论。 锁定对话时，对仓库具有写入权限的人仍然可以对讨论发表评论。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.discussions.discussions-tab %} -1. In the list of discussions, click the discussion you want to lock. ![Lock discussion](/assets/images/help/discussions/unanswered-discussion.png) -1. In the right margin of a discussion, click **Lock conversation**. -1. Read the information about locking conversations and click **Lock conversation on this discussion**. -1. When you're ready to unlock the conversation, click **Unlock conversation**, then click **Unlock conversation on this discussion**. +1. 在讨论列表中，单击要锁定的讨论。 ![锁定讨论](/assets/images/help/discussions/unanswered-discussion.png) +1. 在讨论的右侧边缘单击 **Lock conversation（锁定对话）**。 +1. 阅读有关锁定对话的信息，然后单击 **Lock conversation on this discussion（在此讨论中锁定对话）**。 +1. 当您准备好解锁对话时，单击 **Unlock conversation（解锁对话）**，然后单击 **Unlock conversation on this discussion（解锁此讨论上的对话）**。 -### Converting an issue to a discussion +### 将议题转换为讨论 -When you convert an issue to a discussion, the discussion is automatically created using the content from the issue. People with write access to a repository can bulk convert issues based on labels. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +在将议题转换为讨论时，会使用议题中的内容自动创建讨论。 对仓库拥有写入权限的人可以根据标签批量转换议题。 更多信息请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)”。 {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-issues %} -1. In the list of issues, click the issue you'd like to convert. -1. In the right margin of an issue, click **Convert to discussion**. -1. Select the **Choose a category** drop-down menu, and click a category for your discussion. -1. Click **I understand, convert this issue to a discussion**. +1. 在议题列表中，单击您想要转换的议题。 +1. 在议题的右侧边缘单击 **Convert to discussion（转换为讨论）**。 +1. 选择 **Choose a category（选择类别）**下拉菜单，然后单击讨论的类别。 +1. 单击 **I understand, convert this issue to a discussion（我了解，请将此议题转换为讨论）**。 diff --git a/translations/zh-CN/content/discussions/quickstart.md b/translations/zh-CN/content/discussions/quickstart.md index 2a288ec201db..fc33bb43fca9 100644 --- a/translations/zh-CN/content/discussions/quickstart.md +++ b/translations/zh-CN/content/discussions/quickstart.md @@ -1,6 +1,6 @@ --- -title: Quickstart for GitHub Discussions -intro: 'Enable {% data variables.product.prodname_discussions %} on an existing repository and start conversations with your community.' +title: GitHub Discussions 快速入门 +intro: '在现有仓库上启用 {% data variables.product.prodname_discussions %} ，并发起与社区的对话。' allowTitleToDifferFromFilename: true versions: free-pro-team: '*' @@ -10,49 +10,49 @@ versions: ### 简介 -{% data variables.product.prodname_discussions %} is a collaborative communication forum for the community around an open source project. Discussions are for conversations that need to be transparent and accessible but do not need to be tracked on a project board and are not related to code, unlike issues. Discussions enable fluid, open conversation in a public forum. +{% data variables.product.prodname_discussions %} 是一个围绕开源项目为社区提供协作沟通的论坛。 不像议题，讨论用于需要透明和可访问的对话，但不需要在项目板上进行跟踪，并且与代码无关。 讨论使公共论坛中能够进行流畅、公开的对话。 -Discussions give a space for more collaborative conversations by connecting and giving a more centralized area to connect and find information. +通过连接和提供更集中的区域来连接和查找信息，讨论为更多协作对话提供了空间。 -### Enabling {% data variables.product.prodname_discussions %} on your repository +### 在仓库中启用 {% data variables.product.prodname_discussions %} -Repository owners and people with write access can enable {% data variables.product.prodname_discussions %} for a community on their public repositories. +仓库所有者和具有写入访问权限的人可在其公共仓库中为社区启用 {% data variables.product.prodname_discussions %}。 -When you first enable a {% data variables.product.prodname_discussions %}, you will be invited to configure a welcome post. +当您首次启用 {% data variables.product.prodname_discussions %} 时，将邀请您配置欢迎帖子。 {% data reusables.repositories.navigate-to-repo %} -1. 在仓库名称下，单击 {% octicon "gear" aria-label="The gear icon" %} **Settings（设置）**。 ![Public settings button](/assets/images/help/discussions/public-repo-settings.png) -1. Under "Features", click **Set up discussions**. ![Set up a discussion button under "Features" for enabling or disabling discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png) -1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community. +1. 在仓库名称下，单击 {% octicon "gear" aria-label="The gear icon" %} **Settings（设置）**。 ![公共设置按钮](/assets/images/help/discussions/public-repo-settings.png) +1. 在“Features（功能）”下，单击 **Set up discussions（设置讨论）**。 ![在"Features（功能）"下设置讨论按钮，用于启用或禁用仓库的讨论](/assets/images/help/discussions/setup-discussions-button.png) +1. 在“Start a new discussion（开始新讨论）”下，编辑模板以与要为社区设置的资源和语气保持一致。 1. Click **Start discussion**. !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png) -### Welcoming contributions to your discussions +### 欢迎参与您的讨论 -You can welcome your community and introduce a new way to communicate in a repository by creating a welcome post and pin the post to your {% data variables.product.prodname_discussions %} page. Pinning and locking discussions helps people know that a post is meant as an announcement. You can use announcements as a way to link people to more resources and offer guidance for opening discussions in your community. For more information about pinning a discussion, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)." +您可以通过创建欢迎帖子并固定帖子到 {% data variables.product.prodname_discussions %} 页面，欢迎您的社区，并引入在仓库中沟通的新方式。 固定和锁定讨论有助于人们知道帖子是作为公告发布的。 您可以使用公告将人员链接到更多资源，并指导在社区中开始讨论。 有关固定讨论的更多信息，请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository#pinning-a-discussion)”。 -### Setting up community guidelines for contributors +### 为贡献者设置社区指南 -You can set contributing guidelines to encourage collaborators to have meaningful, useful conversations that are relevant to the repository. You can also update the repository's README to communicate expectations on when collaborators should open an issue or discussion. +您可以设置参与指南，以鼓励协作者进行与仓库相关的有意义、有用的对话。 您还可以更新仓库的 README，以传达协作者何时应打开问题或讨论的期望。 -For more information about providing guidelines for your project, see "[Adding a code of conduct to your project](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)" and "[Setting up your project for healthy contributions](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)." +有关为项目提供指南的更多信息，请参阅“[为项目添加行为准则](/github/building-a-strong-community/adding-a-code-of-conduct-to-your-project)”和“[设置健康参与的项目](/github/building-a-strong-community/setting-up-your-project-for-healthy-contributions)”。 -### Creating a new discussion +### 创建新讨论 -Anyone with access to a repository can create a discussion. +有权访问仓库的任何人都可以创建讨论。 {% data reusables.discussions.starting-a-discussion %} -### Organizing discussions into relevant categories +### 将讨论组织到相关类别 -Repository owners and people with write access can create new categories to keep discussions organized. Collaborators participating and creating new discussions can group discussions into the most relevant existing categories. Discussions can also be recategorized after they are created. For more information, see "[Managing categories for discussions in your repository](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)" +仓库所有者和具有写入权限的人可以创建新类别来保持讨论井然有序。 参与和创建新讨论的协作者可以将讨论分组到最相关的现有类别。 讨论也可以在创建后重新分类。 更多信息请参阅“[管理仓库中讨论的类别](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions-in-your-repository)”。 -### Promoting healthy conversations +### 促进健康的对话 -People with write permissions for a repository can help surface important conversations by pinning discussions, deleting discussions that are no longer useful or are damaging to the community, and transferring discussions to more relevant repositories owned by the organization. For more information, see "[Managing discussions in your repository](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)." +具有仓库写入权限的人可以通过固定讨论、删除不再有用或对社区有害的讨论以及将讨论转移到组织拥有的更相关的仓库，来帮助显示重要的对话。 更多信息请参阅“[管理仓库中的讨论](/discussions/managing-discussions-for-your-community/managing-discussions-in-your-repository)”。 -People with triage permissions for a repository can help moderate a project's discussions by marking comments as answers, locking discussions that are not longer useful or are damaging to the community, and converting issues to discussions when an idea is still in the early stages of development. For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +对仓库具有分类权限的人可以通过将评论标记为答案、锁定不再有用或对社区造成损害的讨论，以及在想法仍处于开发的早期阶段时将问题转换为讨论，从而帮助主持项目的讨论。 更多信息请参阅“[主持讨论](/discussions/managing-discussions-for-your-community/moderating-discussions)”。 ### 后续步骤 -Once there is a clear path to scope work out and move an idea from concept to reality, you can create an issue and start tracking your progress. For more information on creating an issue from a discussion, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions)." +一旦有明确的路径来确定范围以及将想法从概念变为现实，您就可以创建议题并开始跟踪进度。 有关从讨论创建议题的更多信息，请参阅“[主持讨论](/discussions/managing-discussions-for-your-community/moderating-discussions)”。 diff --git a/translations/zh-CN/content/education/guides.md b/translations/zh-CN/content/education/guides.md index 6f4d797ba70d..1a64df81edb8 100644 --- a/translations/zh-CN/content/education/guides.md +++ b/translations/zh-CN/content/education/guides.md @@ -1,44 +1,44 @@ --- -title: Guides for GitHub Education -intro: 'These guides for {% data variables.product.prodname_education %} help you teach and learn both {% data variables.product.product_name %} and software development.' +title: GitHub Education 指南 +intro: '这些 {% data variables.product.prodname_education %} 指南帮助您教授和学习 {% data variables.product.product_name %} 和软件开发。' allowTitleToDifferFromFilename: true versions: free-pro-team: '*' --- -### Get started with {% data variables.product.product_name %} +### 开始使用 {% data variables.product.product_name %} -Teachers, students, and researchers can use tools from {% data variables.product.product_name %} to enrich a software development curriculum and develop real-world collaboration skills. +教师、学生和研究人员可以使用 {% data variables.product.product_name %} 的工具来丰富软件开发课程，开发实际协作技能。 -- [Sign up for a new {% data variables.product.prodname_dotcom %} account](/github/getting-started-with-github/signing-up-for-a-new-github-account) -- [Git and {% data variables.product.prodname_dotcom %} quickstart ](/github/getting-started-with-github/quickstart) -- [Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount) -- [Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack) +- [注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account) +- [Git 和 {% data variables.product.prodname_dotcom %} 快速入门 ](/github/getting-started-with-github/quickstart) +- [申请教育者或研究人员折扣](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount) +- [申请学生开发包](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack) -### Run a software development course with {% data variables.product.company_short %} +### 使用 {% data variables.product.company_short %} 运行软件开发课程 -Administer a classroom, assign and review work from your students, and teach the new generation of software developers with {% data variables.product.prodname_classroom %}. +使用 {% data variables.product.prodname_classroom %} 管理课堂，分配和检查学生的工作，并且教授新一代软件开发人员。 -- [Basics of setting up {% data variables.product.prodname_classroom %} ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom) -- [Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms) -- [Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment) -- [Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment) -- [Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository) -- [Leave feedback with pull requests](/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests) -- [Use autograding](/education/manage-coursework-with-github-classroom/use-autograding) +- [设置 {% data variables.product.prodname_classroom %} 的基本知识 ](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom) +- [管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms) +- [创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment) +- [创建组分配](/education/manage-coursework-with-github-classroom/create-a-group-assignment) +- [从模板仓库创建作业](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository) +- [通过拉取请求留下反馈](/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests) +- [使用自动分级](/education/manage-coursework-with-github-classroom/use-autograding) -### Learn to develop software +### 学习开发软件 -Incorporate {% data variables.product.prodname_dotcom %} into your education, and use the same tools as the professionals. +将 {% data variables.product.prodname_dotcom %} 并入您的教育，并使用与专业人士相同的工具。 -- [Git and {% data variables.product.prodname_dotcom %} learning resources](/github/getting-started-with-github/git-and-github-learning-resources) -- [Use {% data variables.product.prodname_dotcom %} for your schoolwork](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork) -- [Try {% data variables.product.prodname_desktop %}](/desktop) -- [Try {% data variables.product.prodname_cli %}](/github/getting-started-with-github/github-cli) +- [Git 和 {% data variables.product.prodname_dotcom %} 学习资源](/github/getting-started-with-github/git-and-github-learning-resources) +- [使用 {% data variables.product.prodname_dotcom %} 做功课](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork) +- [试用 {% data variables.product.prodname_desktop %}](/desktop) +- [试用 {% data variables.product.prodname_cli %}](/github/getting-started-with-github/github-cli) -### Contribute to the community +### 为社区做贡献 -Participate in the community, get training from {% data variables.product.company_short %}, and learn or teach new skills. +参与社区，从 {% data variables.product.company_short %} 获得培训，并学习或教授新技能。 - [{% data variables.product.prodname_education_community %}](https://education.github.community) - [关于 Campus Experts](/education/teach-and-learn-with-github-education/about-campus-experts) diff --git a/translations/zh-CN/content/education/index.md b/translations/zh-CN/content/education/index.md index c3827df2883b..55254ec12ed4 100644 --- a/translations/zh-CN/content/education/index.md +++ b/translations/zh-CN/content/education/index.md @@ -1,7 +1,7 @@ --- -title: GitHub Education Documentation -shortTitle: Education -intro: "{% data variables.product.prodname_education %} helps you teach or learn software development with the tools and support of {% data variables.product.company_short %}'s platform and community." +title: GitHub Education 文档 +shortTitle: 教育版 +intro: "{% data variables.product.prodname_education %} 通过平台以及对 {% data variables.product.company_short %} 平台和社区的支持帮助您教授或学习软件开发。" introLinks: quickstart: /education/quickstart featuredLinks: @@ -21,19 +21,19 @@ featuredLinks: - /education/manage-coursework-with-github-classroom/teach-with-github-classroom changelog: - - title: 'Try something new at Local Hack Day: Learn' + title: '在 Local Hack Day（当地黑客日）尝试新内容：学习' date: '2020-10-15' href: https://github.blog/2020-10-15-try-something-new-at-local-hack-day-learn/ - - title: 'Remote Education: Creating community through shared experiences' + title: '远程教育：通过共享体验创建社区' date: '2020-09-24' href: https://github.blog/2020-09-24-remote-education-creating-community-through-shared-experiences/ - - title: 'Remote Education: A series of best practices for online campus communities' + title: '远程教育：在线校园社区的一系列最佳实践' date: '2020-09-10' href: https://github.blog/2020-09-10-remote-education-a-series-of-best-practices-for-online-campus-communities/ - - title: Welcome to the inaugural class of MLH Fellows + title: 欢迎来到 MLH 研究员的首期课程 date: '2020-06-24' href: https://github.blog/2020-06-24-welcome-to-the-inaugural-class-of-mlh-fellows/ layout: product-landing diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md index f00b2f90edab..001fadc3834d 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom.md @@ -1,31 +1,31 @@ --- -title: About using MakeCode Arcade with GitHub Classroom -shortTitle: About using MakeCode Arcade -intro: You can configure MakeCode Arcade as the online IDE for assignments in {% data variables.product.prodname_classroom %}. +title: 关于使用 MakeCode Arcade 与 GitHub Classroom +shortTitle: 关于使用 MakeCode Arcade +intro: 您可以将 MakeCode Arcade 配置为 {% data variables.product.prodname_classroom %} 中作业的在线 IDE。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-makecode --- -### About MakeCode Arcade +### 关于 MakeCode Arcade -MakeCode Arcade is an online integrated development environment (IDE) for developing retro arcade games using drag-and-drop block programming and JavaScript. Students can write, edit, run, test, and debug code in a browser with MakeCode Arcade. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +MakeCode Arcade 是一个在线集成开发环境 (IDE)，用于使用拖放块编程和 JavaScript 开发复古街机游戏。 学生可以使用 MakeCode Arcade 在浏览器中编写、编辑、运行、测试和调试代码。 有关在线 IDE 和 {% data variables.product.prodname_classroom %} 的更多信息，请参阅“[集成 {% data variables.product.prodname_classroom %} 与在线 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)”。 {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit MakeCode Arcade, the student must sign into MakeCode Arcade with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on MakeCode Arcade. +学生第一次单击按钮访问 MakeCode Arcade 时，必须使用 {% data variables.product.product_name %} 证书登录 MakeCode Arcade。 登录后，学生将有权访问包含作业仓库中代码、在 MakeCode Arcade 上完全配置的开发环境。 -For more information about working on MakeCode Arcade, see the [MakeCode Arcade Tour](https://arcade.makecode.com/ide-tour) and [documentation](https://arcade.makecode.com/docs) on the MakeCode Arcade website. +有关在 MakeCode Arcade 上工作的详细信息，请参阅 MakeCode Arcade 网站上的 [MakeCode Arcade 一览](https://arcade.makecode.com/ide-tour)和[文档](https://arcade.makecode.com/docs)。 -MakeCode Arcade does not support multiplayer-editing for group assignments. Instead, students can collaborate with Git and {% data variables.product.product_name %} features like branches and pull requests. +MakeCode Arcade 不支持对小组作业进行多人编辑。 但学生可以协作使用 Git 和 {% data variables.product.product_name %} 功能，如分支和拉取请求。 -### About submission of assignments with MakeCode Arcade +### 关于使用 MakeCode Arcade 提交作业 -By default, MakeCode Arcade is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with MakeCode Arcade, students should push changes to {% data variables.product.product_location %} using the {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} button at the bottom of the screen. +默认情况下，MakeCode Arcade 配置为推送到 {% data variables.product.product_location %} 上的作业仓库。 使用 MakeCode Arcade 处理作业后，学生应使用屏幕底部的 {% octicon "mark-github" aria-label="The GitHub mark" %}{% octicon "arrow-up" aria-label="The up arrow icon" %} 按钮将更改推送到 {% data variables.product.product_location %}。 -![MakeCode Arcade version control functionality](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) +![MakeCode Arcade 版本控制功能](/assets/images/help/classroom/ide-makecode-arcade-version-control-button.png) ### 延伸阅读 -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[关于 README](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md index ad440d799a75..2f09b5f55e93 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom.md @@ -1,33 +1,33 @@ --- -title: About using Repl.it with GitHub Classroom -shortTitle: About using Repl.it -intro: You can configure Repl.it as the online integrated development environment (IDE) for assignments in {% data variables.product.prodname_classroom %}. +title: 关于使用 Repl.it 与 GitHub Classroom +shortTitle: 关于使用 Repl.it +intro: 您可以将 Repl.it 配置为在线集成开发环境 (IDE)，以用于 {% data variables.product.prodname_classroom %} 中的作业。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/student-experience-replit --- -### About Repl.it +### 关于 Repl.it -Repl.it is an online integrated development environment (IDE) that supports multiple programming languages. Students can write, edit, run, test, and debug code in a browser with Repl.it. For more information about online IDEs and {% data variables.product.prodname_classroom %}, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +Repl.it 是一个支持多种编程语言的在线集成开发环境 (IDE)。 学生可以使用 Repl.it 在浏览器中写入、编辑、运行、测试和调试代码。 有关在线 IDE 和 {% data variables.product.prodname_classroom %} 的更多信息，请参阅“[集成 {% data variables.product.prodname_classroom %} 与在线 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)”。 {% data reusables.classroom.readme-contains-button-for-online-ide %} -The first time the student clicks the button to visit Repl.it, the student must sign into Repl.it with {% data variables.product.product_name %} credentials. After signing in, the student will have access to a development environment containing the code from the assignment repository, fully configured on Repl.it. +学生第一次单击按钮访问 Repl.it 时，必须使用 {% data variables.product.product_name %} 证书登录 Repl.it。 登录后，学生将有权访问包含作业仓库中代码、在 Repl.it 上完全配置的开发环境。 -For more information about working on Repl.it, see the [Repl.it Quickstart Guide](https://docs.repl.it/misc/quick-start#the-repl-environment). +有关操作 Repl.it 的更多信息，请参阅 [Repl.it 快速入门指南](https://docs.repl.it/misc/quick-start#the-repl-environment)。 -For group assignments, students can use Repl.it Multiplayer to work collaboratively. For more information, see the [Repl.it Multiplayer](https://repl.it/site/multiplayer) website. +对于小组作业，学生可以使用 Repl.it Multiplayer 协同工作。 更多信息请参阅 [Repl.it Multiplayer](https://repl.it/site/multiplayer) 网站。 -### About submission of assignments with Repl.it +### 关于使用 Repl.it 提交作业 -By default, Repl.it is configured to push to the assignment repository on {% data variables.product.product_location %}. After making progress on an assignment with Repl.it, students should push changes to {% data variables.product.product_location %} using the version control functionality in the left sidebar. +默认情况下，Repl.it 配置为推送到 {% data variables.product.product_location %} 上的作业仓库。 在 Repl.it 的作业中取得进展后，学生应使用左侧边栏中的版本控制功能将更改推送到 {% data variables.product.product_location %}。 -![Repl.it version control functionality](/assets/images/help/classroom/ide-replit-version-control-button.png) +![Repl.it 版本控制功能](/assets/images/help/classroom/ide-replit-version-control-button.png) -For more information about using Git on Repl.it, see the [Repl.it + Git Tutorial](https://repl.it/talk/learn/Replit-Git-Tutorial/23331) on the Repl.it website. +有关在 Repl.it 上使用 Git 的更多信息，请参阅 Repl.it 网站上的 [Repl.it + Git 教程](https://repl.it/talk/learn/Replit-Git-Tutorial/23331)。 ### 延伸阅读 -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[关于 README](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md index 1ee1e1b5a1e3..c2ed5aa2e56c 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom.md @@ -1,33 +1,33 @@ --- -title: Basics of setting up GitHub Classroom -shortTitle: '{% data variables.product.prodname_classroom %} basics' -intro: Learn how to set up your classroom, manage assignments, and configure time-saving automation. +title: 设置 GitHub Classroom 的基础知识 +shortTitle: '{% data variables.product.prodname_classroom %} 基础知识' +intro: 了解如何设置教室、管理作业和配置节省时间的自动化。 versions: free-pro-team: '*' --- -### Videos about {% data variables.product.prodname_classroom %} +### 关于 {% data variables.product.prodname_classroom %} 的视频 -You can watch a series of short video tutorials about the configuration and use of {% data variables.product.prodname_classroom %}. To watch all videos as part of a continuous playlist, see the [{% data variables.product.prodname_classroom %} Getting Started Guide](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u) on YouTube. +您可以观看一系列有关 {% data variables.product.prodname_classroom %} 配置和使用的短视频教程。 要观看作为连续播放列表一部分的所有视频，请参阅 YouTube 上的 [{% data variables.product.prodname_classroom %} 入门指南](https://www.youtube.com/playlist?list=PLIRjfNq867bewk3ZGV6Z7a16YDNRCpK3u)。 -For more information about terminology for {% data variables.product.prodname_classroom %}, see "[Glossary](/education/manage-coursework-with-github-classroom/glossary)". +有关 {% data variables.product.prodname_classroom %} 的术语的详细信息，请参阅“[术语](/education/manage-coursework-with-github-classroom/glossary)”。 -1. Getting started {% octicon "link-external" aria-label="The external link icon" %} -2. Adding your student roster {% octicon "link-external" aria-label="The external link icon" %} -3. Creating assignments - - Creating an assignment using a {% data variables.product.prodname_dotcom %} repository {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Microsoft MakeCode as your online IDE {% octicon "link-external" aria-label="The external link icon" %} - - Creating an assignment using Repl.it as your online IDE {% octicon "link-external" aria-label="The external link icon" %} -4. How students complete assignments {% octicon "link-external" aria-label="The external link icon" %} -5. How teachers review assignments {% octicon "link-external" aria-label="The external link icon" %} -6. Creating group assignments {% octicon "link-external" aria-label="The external link icon" %} -7. Next steps to get started {% octicon "link-external" aria-label="The external link icon" %} -8. {% data variables.product.prodname_dotcom %} Teacher Toolbox {% octicon "link-external" aria-label="The external link icon" %} +1. 使用入门 {% octicon "link-external" aria-label="The external link icon" %} +2. 添加学生名册 {% octicon "link-external" aria-label="The external link icon" %} +3. 创建作业 + - 使用 {% data variables.product.prodname_dotcom %} 仓库创建作业 {% octicon "link-external" aria-label="The external link icon" %} + - 使用 Microsoft MakeCode 将作业创建为在线 IDE {% octicon "link-external" aria-label="The external link icon" %} + - 使用 Repl.it 将作业创建为在线 IDE {% octicon "link-external" aria-label="The external link icon" %} +4. 学生如何完成作业 {% octicon "link-external" aria-label="The external link icon" %} +5. 教师如何审阅作业 {% octicon "link-external" aria-label="The external link icon" %} +6. 创建小组作业 {% octicon "link-external" aria-label="The external link icon" %} +7. 后续使用步骤 {% octicon "link-external" aria-label="The external link icon" %} +8. {% data variables.product.prodname_dotcom %} 教师工具箱 {% octicon "link-external" aria-label="The external link icon" %} ### 后续步骤 -For more information about teaching with {% data variables.product.prodname_classroom %}, see "[Teach with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)." +关于使用 {% data variables.product.prodname_classroom %} 教学的更多信息，请参阅“[使用 {% data variables.product.prodname_classroom %} 教学](/education/manage-coursework-with-github-classroom/teach-with-github-classroom)”。 ### 延伸阅读 -- "[Teach and learn with {% data variables.product.prodname_education %}](/education/teach-and-learn-with-github-education)" +- "[使用 {% data variables.product.prodname_education %} 教学和学习](/education/teach-and-learn-with-github-education)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md index b53f88c0974c..c63e7ac1e8c9 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories.md @@ -1,50 +1,50 @@ --- -title: Configure default settings for assignment repositories -shortTitle: Configure defaults for assignment repositories -intro: You can use the Probot Settings app to configure the default settings for repositories that {% data variables.product.prodname_classroom %} creates for an assignment. -permissions: Organization owners can configure default settings for assignment repositories by installing a {% data variables.product.prodname_github_app %} for the organization. +title: 配置作业仓库的默认设置 +shortTitle: 配置作业仓库的默认值 +intro: 您可以使用 Probot 设置应用程序为 {% data variables.product.prodname_classroom %} 创建用于作业的仓库配置默认设置。 +permissions: 组织所有者可以通过为组织安装 {% data variables.product.prodname_github_app %} 来配置作业仓库的默认设置。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/probot-settings --- -### About configuration of defaults for assignment repositories +### 关于作业仓库的默认值配置 -{% data variables.product.prodname_classroom %} creates a repository that belongs for each student or team that accepts an assignment. The repository belongs to the organization that you use for {% data variables.product.prodname_classroom %}. Assignment repositories can be empty, or you can use a template repository. For more information, see "[Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)." +{% data variables.product.prodname_classroom %} 创建属于接受作业的每个学生或团队的仓库。 仓库属于您用于 {% data variables.product.prodname_classroom %} 的组织。 作业仓库可以是空的，也可以使用模板仓库。 更多信息请参阅“[从模板仓库创建作业](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)”。 {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} -With the Probot Settings app, you can create a file named _.github/settings.yml_ in a repository that contains a list of settings for the repository, and then install a {% data variables.product.prodname_github_app %} for your organization that automatically applies the settings to the repository. +使用 Probot 设置应用程序，您可以在包含仓库设置列表的仓库中创建名为 _.github/settings.yml_ 的文件，然后为组织安装自动将设置应用到仓库的 {% data variables.product.prodname_github_app %} 。 -You can include _.github/settings.yml_ in a template repository that you use for an assignment in {% data variables.product.prodname_classroom %}. When an individual or team accepts the assignment, {% data variables.product.prodname_classroom %} creates the assignment repository, and the Settings app automatically applies the settings from _.github/settings.yml_. +您可以在模板仓库中包含用于 {% data variables.product.prodname_classroom %} 中作业的 _.github/settings.yml_。 当个人或团队接受作业时，{% data variables.product.prodname_classroom %} 会创建作业仓库，并且设置应用程序自动从 _.github/settings.yml_ 应用设置。 -Probot is a a project, framework, and collection of free apps to automate {% data variables.product.product_name %}. A Probot app can listen to repository events, like the creation of new commits, comments, and issues, and automatically respond to the event. +Probot 是一个免费应用程序的项目、框架和集合，用于自动化 {% data variables.product.product_name %}。 Probot 应用程序可以侦听仓库事件，如创建新提交、注释和议题，并自动响应事件。 -For more information, see the [Probot website](https://probot.github.io) and the [Settings app website](https://probot.github.io/apps/settings/). For more information about {% data variables.product.prodname_github_apps %}, see "[About apps](/developers/apps/about-apps)." +更多信息请参阅 [Probot 网站](https://probot.github.io)和[设置应用程序网站](https://probot.github.io/apps/settings/)。 有关 {% data variables.product.prodname_github_apps %} 的更多信息，请参阅“[关于应用程序](/developers/apps/about-apps)”。 -### Adding the Settings app to your organization +### 将设置应用程序添加到组织 -After you install the Probot Settings app for your organization, the app will apply the settings that you define in _.github/settings.yml_ for any repository in your organization, including new assignment repositories that {% data variables.product.prodname_classroom %} creates. +为组织安装 Probot 设置应用程序后，该应用程序将对组织中的任何仓库（包括 {% data variables.product.prodname_classroom %} 创建的新作业仓库）应用您在 _.github/settings.yml_ 中定义的设置。 -1. Navigate to the [Settings app page](https://github.com/apps/settings). -1. Click **Install**, then click the organization that you use for {% data variables.product.prodname_classroom %}. Provide the app full access to all repositories owned by the organization. ![Installing the Probot Settings app](/assets/images/help/classroom/probot-settings.gif) +1. 导航到[设置应用程序页面](https://github.com/apps/settings)。 +1. 单击 **Install（安装）**，然后单击用于 {% data variables.product.prodname_classroom %} 的组织。 为应用程序提供对组织拥有的所有仓库的完全访问权限。 ![安装 Probot 设置应用程序](/assets/images/help/classroom/probot-settings.gif) -### Configuring default settings for an assignment repository +### 配置作业仓库的默认设置 -1. Create a template repository that contains a _.github/settings.yml_ file. For a complete list of settings, see the [README](https://github.com/probot/settings#github-settings) for the `probot/settings` repository. For more information about using a template repository for starter code in {% data variables.product.prodname_classroom %}, see "[Create an assignment from a template repository](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)." +1. 创建包含 _.github/settings.yml_ 文件的模板仓库。 有关设置的完整列表，请参阅 `probot/settings` 仓库的 [README](https://github.com/probot/settings#github-settings)。 有关对 {% data variables.product.prodname_classroom %} 中的起始代码使用模板仓库的更多信息，请参阅“[从模板仓库创建作业](/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository)”。 {% warning %} - **Warning:** Do not define `collaborators` in the _.github/settings.yml_ file for your template repository. {% data variables.product.prodname_classroom %} automatically grants teachers and teaching assistants access to assignment repositories. + **警告：**不要在模板仓库的 _.github/settings.yml_ 文件中定义`协作者`。 {% data variables.product.prodname_classroom %} 自动授予教师和教师助理访问作业仓库的权限。 {% endwarning %} -1. Create an assignment using the template repository containing _.github/settings.yml_ as the starter code. {% data reusables.classroom.for-more-information-about-assignment-creation %} +1. 使用包含 _.github/settings.yml_ 作为起始代码的模板仓库创建作业。 {% data reusables.classroom.for-more-information-about-assignment-creation %} -The Probot Settings app for your organization will now apply the settings you define in _.github/settings.yml_ within the template repository to every assignment repository that {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} creates for a student or team. +组织的 Probot 设置应用程序现在会将您在模板仓库的 _.github/settings.yml_ 中定义的设置应用到 {% data reusables.classroom.you-may-want-to-predefine-repository-settings %} 为学生或团队创建的每个作业仓库。 ### 延伸阅读 -- [Probot apps](https://probot.github.io/apps/) -- [Probot documentation](https://probot.github.io/docs/) +- [Probot 应用程序](https://probot.github.io/apps/) +- [Probot 文档](https://probot.github.io/docs/) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md index accb5a7fb43e..4f80950303d2 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Connect a learning management system to GitHub Classroom -intro: You can configure an LTI-compliant learning management system (LMS) to connect to {% data variables.product.prodname_classroom %} so that you can import a roster for your classroom. +title: 将学习管理系统连接到 GitHub Classroom +intro: 您可以配置 LTI 兼容的学习管理系统 (LMS) 连接到 {% data variables.product.prodname_classroom %}，以便导入用于课堂的名册。 versions: free-pro-team: '*' redirect_from: @@ -12,127 +12,127 @@ redirect_from: - /education/manage-coursework-with-github-classroom/setup-moodle --- -### About configuration of your LMS +### 关于 LMS 的配置 -You can connect a learning management system (LMS) to {% data variables.product.prodname_classroom %}, and {% data variables.product.prodname_classroom %} can import a roster of student identifiers from the LMS. To connect your LMS to {% data variables.product.prodname_classroom %}, you must enter configuration credentials for {% data variables.product.prodname_classroom %} in your LMS. +您可以将学习管理系统 (LMS) 连接到 {% data variables.product.prodname_classroom %}，然后 {% data variables.product.prodname_classroom %} 可以从 LMS 导入学生标识符名册。 若要将 LMS 连接到 {% data variables.product.prodname_classroom %}，必须在 LMS 中输入 {% data variables.product.prodname_classroom %} 的配置凭据。 ### 基本要求 -To configure an LMS to connect to {% data variables.product.prodname_classroom %}, you must first create a classroom. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-classroom)." +要配置 LMS 连接到 {% data variables.product.prodname_classroom %}，您必须先创建一个教室。 更多信息请参阅“[管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-classroom)”。 -### Supported LMSes +### 支持的 LMSes -{% data variables.product.prodname_classroom %} supports import of roster data from LMSes that implement Learning Tools Interoperability (LTI) standards. +{% data variables.product.prodname_classroom %} 支持从实施学习工具互操作性 (LTI) 标准的 LMS 导入名册数据。 -- LTI version 1.0 and/or 1.1 -- LTI Names and Roles Provisioning 1.X +- LTI 版本 1.0 和/或 1.1 +- 配置 1.X 的 LTI 名称和角色 -Using LTI helps keep your information safe and secure. LTI is an industry-standard protocol and GitHub Classroom's use of LTI is certified by the Instructional Management System (IMS) Global Learning Consortium. For more information, see [Learning Tools Interoperability](https://www.imsglobal.org/activity/learning-tools-interoperability) and [About IMS Global Learning Consortium](http://www.imsglobal.org/aboutims.html) on the IMS Global Learning Consortium website. +使用 LTI 有助于确保您的信息安全。 LTI 是一个行业标准协议，GitHub Classroom 对 LTI 的使用得到了教学管理系统 (IMS) 全球学习联盟的认证。 更多信息请参阅[学习工具互操作性](https://www.imsglobal.org/activity/learning-tools-interoperability)和 IMS 全球学习联盟网站上的[关于 IMS 全球学习联盟](http://www.imsglobal.org/aboutims.html)。 -{% data variables.product.company_short %} has tested import of roster data from the following LMSes into {% data variables.product.prodname_classroom %}. +{% data variables.product.company_short %} 测试了名册数据从以下 LMS 到 {% data variables.product.prodname_classroom %} 的导入。 - Canvas - Google Classroom - Moodle - Sakai -Currently, {% data variables.product.prodname_classroom %} doesn't support import of roster data from Blackboard or Brightspace +目前， {% data variables.product.prodname_classroom %} 不支持从 Blackboard 或 Brightspace 导入名册数据 -### Generating configuration credentials for your classroom +### 为教室生成配置凭据 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. If your classroom already has a roster, you can either update the roster or delete the roster and create a new roster. - - For more information about deleting and creating a roster, see "[Deleting a roster for a classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#deleting-a-roster-for-a-classroom)" and "[Creating a roster for your classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)." - - For more information about updating a roster, see "[Adding students to the roster for your classroom](/education/manage-coursework-with-github-classroom/manage-classrooms#adding-students-to-the-roster-for-your-classroom)." -1. In the list of LMSes, click your LMS. If your LMS is not supported, click **Other LMS**. ![List of LMSes](/assets/images/help/classroom/classroom-settings-click-lms.png) -1. Read about connecting your LMS, then click **Connect to _LMS_**. -1. Copy the "Consumer Key", "Shared Secret", and "Launch URL" for the connection to the classroom. ![Copy credentials](/assets/images/help/classroom/classroom-copy-credentials.png) +1. 如果您的教室已有名册，您可以更新名册或删除名册并创建新的名册。 + - 有关删除和创建名册的更多信息，请参阅“[删除教室名册](/education/manage-coursework-with-github-classroom/manage-classrooms#deleting-a-roster-for-a-classroom)”和“[创建教室名册](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)”。 + - 有关更新名册的更多信息，请参阅“[将学生添加到教室的名册](/education/manage-coursework-with-github-classroom/manage-classrooms#adding-students-to-the-roster-for-your-classroom)”。 +1. 在 LMS 列表中，单击您的 LMS。 如果您的 LMS 不受支持，请单击**其他 LMS**。 ![LMS 列表](/assets/images/help/classroom/classroom-settings-click-lms.png) +1. 阅读有关连接 LMS 的操作，然后单击 **连接到 _LMS_**。 +1. 复制用于连接到教室的“消费者密钥”、“共享密钥”和“启动 URL”。 ![复制凭据](/assets/images/help/classroom/classroom-copy-credentials.png) -### Configuring a generic LMS +### 配置通用 LMS -You must configure the privacy settings for your LMS to allow external tools to receive roster information. +您必须为 LMS 配置隐私设置，以允许外部工具接收名册信息。 -1. Navigate to your LMS. -1. Configure an external tool. -1. Provide the configuration credentials you generated in {% data variables.product.prodname_classroom %}. - - Consumer key +1. 导航到 LMS。 +1. 配置外部工具。 +1. 提供您在 {% data variables.product.prodname_classroom %} 中生成的配置凭据。 + - 消费者密钥 - 共享机密 - - Launch URL (sometimes called "tool URL" or similar) + - 启动 URL（有时称为“工具 URL”或类似名称） -### Configuring Canvas +### 配置 Canvas -You can configure {% data variables.product.prodname_classroom %} as an external app for Canvas to import roster data into your classroom. For more information about Canvas, see the [Canvas website](https://www.instructure.com/canvas/). +您可以将 {% data variables.product.prodname_classroom %} 配置为 Canvas 的外部应用以将名册数据导入到您的教室。 有关 Canvas 的更多信息，请参阅 [Canvas 网站](https://www.instructure.com/canvas/)。 -1. Sign into [Canvas](https://www.instructure.com/canvas/#login). -1. Select the Canvas course to integrate with {% data variables.product.prodname_classroom %}. +1. 登录到 [Canvas](https://www.instructure.com/canvas/#login)。 +1. 选择要与 {% data variables.product.prodname_classroom %} 集成的 Canvas 课程。 1. 在左边栏中，单击 **Settings（设置）**。 -1. Click the **Apps** tab. -1. Click **View app configurations**. -1. Click **+App**. -1. Select the **Configuration Type** drop-down menu, and click **By URL**. -1. Paste the configuration credentials from {% data variables.product.prodname_classroom %}. For more information, see "[Generating configuration credentials for your classroom](#generating-configuration-credentials-for-your-classroom)." - - | Field in Canvas app configuration | Value or setting | - |:------------------------------------------------------------------------- |:------------------------------------------------------------------ | - | **Consumer Key** | Consumer key from {% data variables.product.prodname_classroom %} - | **Shared Secret** | Shared secret from {% data variables.product.prodname_classroom %} - | **Allow this tool to access the IMS Names and Role Provisioning Service** | Enabled | - | **Configuration URL** | Launch URL from {% data variables.product.prodname_classroom %} +1. 单击 **Apps（应用程序）**选项卡。 +1. 单击 **View app configurations（查看应用程序配置）**。 +1. 单击 **+App**。 +1. 选择 **Configuration Type（配置类型）**下拉菜单，然后单击 **By URL（通过 URL）**。 +1. 从 {% data variables.product.prodname_classroom %} 粘贴配置凭据。 更多信息请参阅“[为教室生成配置凭据](#generating-configuration-credentials-for-your-classroom)”。 + + | Canvas 应用程序配置中的字段 | 值或设置 | + |:------------------------- |:-------------------------------------------------------- | + | **消费者密钥** | {% data variables.product.prodname_classroom %} 中的消费者密钥 | + | **共享秘密** | {% data variables.product.prodname_classroom %} 中的共享密钥 | + | **允许此工具访问 IMS 名称和角色预配服务** | 已启用 | + | **配置 URL** | {% data variables.product.prodname_classroom %} 中的启动 URL | {% note %} - **Note**: If you don't see a checkbox in Canvas labeled "Allow this tool to access the IMS Names and Role Provisioning Service", then your Canvas administrator must contact Canvas support to enable membership service configuration for your Canvas account. Without enabling this feature, you won't be able to sync the roster from Canvas. For more information, see [How do I contact Canvas Support?](https://community.canvaslms.com/t5/Canvas-Basics-Guide/How-do-I-contact-Canvas-Support/ta-p/389767) on the Canvas website. + **注意**: 如果您在 Canvas 中看不到名为“Allow this tool to access the IMS Names and Role Provisioning Service（允许此工具访问 IMS 名称和角色预配服务）”的复选框，则您的 Canvas 管理员必须联系 Canvas 支持，以为您的 Canvas 帐户启用会员服务配置。 如果不启用此功能，您将无法从 Canvas 同步名册。 更多信息请参阅 Canvas 网站上的[如何联系 Canvas 支持？](https://community.canvaslms.com/t5/Canvas-Basics-Guide/How-do-I-contact-Canvas-Support/ta-p/389767)。 {% endnote %} 1. 单击 **Submit（提交）**。 -1. In the left sidebar, click **Home**. -1. To prompt Canvas to send a confirmation email, in the left sidebar, click **GitHub Classroom**. Follow the instructions in the email to finish linking {% data variables.product.prodname_classroom %}. - -### Configuring Moodle - -You can configure {% data variables.product.prodname_classroom %} as an activity for Moodle to import roster data into your classroom. For more information about Moodle, see the [Moodle website](https://moodle.org). - -You must be using Moodle version 3.0 or greater. - -1. Sign into [Moodle](https://moodle.org/login/index.php). -1. Select the Moodle course to integrate with {% data variables.product.prodname_classroom %}. -1. Click **Turn editing on**. -1. Wherever you'd like {% data variables.product.prodname_classroom %} to be available in Moodle, click **Add an activity or resource**. -1. Choose **External tool** and click **Add**. -1. In the "Activity name" field, type "GitHub Classroom". -1. In the **Preconfigured tool** field, to the right of the drop-down menu, click **+**. -1. Under "External tool configuration", paste the configuration credentials from {% data variables.product.prodname_classroom %}. For more information, see "[Generating configuration credentials for your classroom](#generating-configuration-credentials-for-your-classroom)." - - | Field in Moodle app configuration | Value or setting | - |:--------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | **Tool name** | {% data variables.product.prodname_classroom %} - _YOUR CLASSROOM NAME_

    **Note**: You can use any name, but we suggest this value for clarity. | - | **Tool URL** | Launch URL from {% data variables.product.prodname_classroom %} - | **LTI version** | LTI 1.0/1.1 | - | **Default launch container** | New window | - | **Consumer key** | Consumer key from {% data variables.product.prodname_classroom %} - | **共享机密** | Shared secret from {% data variables.product.prodname_classroom %} - -1. Scroll to and click **Services**. -1. To the right of "IMS LTI Names and Role Provisioning", select the drop-down menu and click **Use this service to retrieve members' information as per privacy settings**. -1. Scroll to and click **Privacy**. -1. To the right of **Share launcher's name with tool** and **Share launcher's email with tool**, select the drop-down menus to click **Always**. +1. 在左侧边栏中，单击 **Home（主页）**。 +1. 要提示 Canvas 发送确认电子邮件，请在左侧栏中单击 **GitHub Classroom**。 按照电子邮件中的说明完成链接 {% data variables.product.prodname_classroom %}。 + +### 配置 Moodle + +您可以将 {% data variables.product.prodname_classroom %} 配置为 Moodle 的活动以将名册数据导入到您的教室。 有关 Moodle 的更多信息，请参阅 [Moodle 网站](https://moodle.org)。 + +您必须使用 Moodle 版本 3.0 或更高版本。 + +1. 登录 [Moodle](https://moodle.org/login/index.php)。 +1. 选择要与 {% data variables.product.prodname_classroom %} 集成的 Moodle 课程。 +1. 单击 **Turn editing on（打开编辑）**。 +1. 当希望 {% data variables.product.prodname_classroom %} 在 Moodle 中可用时，单击 **Add an activity or resource（添加活动或资源）**。 +1. 选择 **External tool（外部工具）**并单击 **Add（添加）**。 +1. 在“Activity name（活动名称）”字段中，键入 "GitHub Classroom"。 +1. 在 **Preconfigured tool（预配置的工具）**字段的下拉菜单右侧，单击 **+**。 +1. 在“External tool configuration（外部工具配置）”下，从 {% data variables.product.prodname_classroom %} 粘贴配置凭据。 更多信息请参阅“[为教室生成配置凭据](#generating-configuration-credentials-for-your-classroom)”。 + + | Moodle 应用程序配置中的字段 | 值或设置 | + |:----------------- |:--------------------------------------------------------------------------------------------------------------------------------- | + | **工具名称** | {% data variables.product.prodname_classroom %} - _YOUR CLASSROOM NAME_

    **注意**：您可以使用任何名称，但为明确起见，我们建议使用这个值。 | + | **工具 URL** | {% data variables.product.prodname_classroom %} 中的启动 URL | + | **LTI 版本** | LTI 1.0/1.1 | + | **默认启动容器** | 新窗口 | + | **消费者密钥** | {% data variables.product.prodname_classroom %} 中的消费者密钥 | + | **共享机密** | {% data variables.product.prodname_classroom %} 中的共享密钥 | + +1. 滚动到 **Services（服务）**并单击。 +1. 在“IMS LTI Names and Role Provisioning（IMS LTI 名称和角色预配）”的右侧，选择下拉菜单并单击 **Use this service to retrieve members' information as per privacy settings（根据隐私设置使用此服务检索成员的信息）**。 +1. 滚动到 **Privacy（隐私）**并单击。 +1. 在 **Share launcher's name with tool（使用工具共享启动者的名称）**和 **Share launcher's email with tool（使用工具共享启动者的电子邮件）**右侧，选择下拉菜单以单击 **Always（始终）**。 1. 在页面底部，单击 **Save changes（保存更改）**。 -1. In the **Preconfigure tool** menu, click **GitHub Classroom - _YOUR CLASSROOM NAME_**. -1. Under "Common module settings", to the right of "Availability", select the drop-down menu and click **Hide from students**. -1. At the bottom of the page, click **Save and return to course**. -1. Navigate to anywhere you chose to display {% data variables.product.prodname_classroom %}, and click the {% data variables.product.prodname_classroom %} activity. +1. 在 **Preconfigure tool（预配置工具）**菜单中，单击 **GitHub Classroom - _YOUR CLASSROOM NAME_**。 +1. 在“Common module settings（通用模块设置）”下“Availability（可用性）”的右侧，选择下拉菜单并单击 **Hide from students（对学生隐藏）**。 +1. 在页面底部，单击 **Save and return to course（保存并返回课程）**。 +1. 导航到您选择显示 {% data variables.product.prodname_classroom %} 的任何位置，然后单击 {% data variables.product.prodname_classroom %} 活动。 -### Importing a roster from your LMS +### 从 LMS 导入名册 -For more information about importing the roster from your LMS into {% data variables.product.prodname_classroom %}, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)." +有关从将名册从 LMS 导入到 {% data variables.product.prodname_classroom %} 的更多信息，请参阅“[管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms#creating-a-roster-for-your-classroom)”。 -### Disconnecting your LMS +### 断开 LMS 连接 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} -1. Under "Connect to a learning management system (LMS)", click **Connection Settings**. !["Connection settings" link in classroom settings](/assets/images/help/classroom/classroom-settings-click-connection-settings.png) -1. Under "Delete Connection to your learning management system", click **Disconnect from your learning management system**. !["Disconnect from your learning management system" button in connection settings for classroom](/assets/images/help/classroom/classroom-settings-click-disconnect-from-your-lms-button.png) +1. 在“Connect to a learning management system (LMS)（连接到学习管理系统 [LMS]）”下，单击 **Connection Settings（连接设置）**。 ![教室设置中的"连接设置"链接](/assets/images/help/classroom/classroom-settings-click-connection-settings.png) +1. 在“Delete Connection to your learning management system（删除与学习管理系统的连接）”下，单击 **Disconnect from your learning management system（断开与学习管理系统的连接）**。 ![教室连接设置中的"从学习管理系统断开连接"按钮](/assets/images/help/classroom/classroom-settings-click-disconnect-from-your-lms-button.png) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md index 842e4c79d267..98e08b1a2b42 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-a-group-assignment.md @@ -1,118 +1,118 @@ --- -title: Create a group assignment -intro: 'You can create a collaborative assignment for teams of students who participate in your course.' +title: 创建组分配 +intro: '您可以为参加您课程的学生团队创建协作作业。' versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/create-group-assignments --- -### About group assignments +### 关于组分配 -{% data reusables.classroom.assignments-group-definition %} Students can work together on a group assignment in a shared repository, like a team of professional developers. +{% data reusables.classroom.assignments-group-definition %} 学生可以像专业开发人员团队一样，在共享仓库中共同完成小组作业。 -When a student accepts a group assignment, the student can create a new team or join an existing team. {% data variables.product.prodname_classroom %} saves the teams for an assignment as a set. You can name the set of teams for a specific assignment when you create the assignment, and you can reuse that set of teams for a later assignment. +当学生接受小组作业时，该学生可以创建新团队或加入现有团队。 {% data variables.product.prodname_classroom %} 将任务团队保存为集合。 您可以在创建作业时为特定作业指定一组团队，并且在后面的作业中可以重复使用该组团队。 {% data reusables.classroom.classroom-creates-group-repositories %} {% data reusables.classroom.about-assignments %} -You can decide how many teams one assignment can have, and how many members each team can have. Each team that a student creates for an assignment is a team within your organization on {% data variables.product.product_name %}. The visibility of the team is secret. Teams that you create on {% data variables.product.product_name %} will not appear in {% data variables.product.prodname_classroom %}. 更多信息请参阅“[关于团队](/github/setting-up-and-managing-organizations-and-teams/about-teams)”。 +您可以决定一个任务可以拥有多少个团队，以及每个团队可以拥有多少成员。 学生为作业创建的每个团队都是 {% data variables.product.product_name %} 上组织内的团队。 团队的可见性是秘密。 您在 {% data variables.product.product_name %} 上创建的团队不会出现在 {% data variables.product.prodname_classroom %} 中。 更多信息请参阅“[关于团队](/github/setting-up-and-managing-organizations-and-teams/about-teams)”。 -For a video demonstration of the creation of a group assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." +有关创建小组作业的视频演示，请参阅“[设置 {% data variables.product.prodname_classroom %} 的基本知识](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)”。 ### 基本要求 {% data reusables.classroom.assignments-classroom-prerequisite %} -### Creating an assignment +### 创建作业 {% data reusables.classroom.assignments-guide-create-the-assignment %} -### Setting up the basics for an assignment +### 设置作业的基本信息 -Name your assignment, decide whether to assign a deadline, define teams, and choose the visibility of assignment repositories. +指定作业的名称，决定是否分配截止时间，确定团队，并选择作业仓库的可见性。 -- [Naming an assignment](#naming-an-assignment) -- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) -- [Choosing an assignment type](#choosing-an-assignment-type) -- [Defining teams for an assignment](#defining-teams-for-an-assignment) -- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) +- [指定作业名称](#naming-an-assignment) +- [分配作业的截止时间](#assigning-a-deadline-for-an-assignment) +- [选择作业类型](#choosing-an-assignment-type) +- [确定作业的团队](#defining-teams-for-an-assignment) +- [选择作业仓库的可见性](#choosing-a-visibility-for-assignment-repositories) -#### Naming an assignment +#### 指定作业名称 -For a group assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the name of the team. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the team's name on {% data variables.product.product_name %} is "student-team", the name of the assignment repository for members of the team will be `assignment-1-student-team`. +对于小组作业，{% data variables.product.prodname_classroom %} 使用仓库前缀和团队名称对仓库命名。 默认情况下，仓库前缀是作业标题。 例如，如果将作业命名为 "assignment-1"，而团队在 {% data variables.product.product_name %} 上的名称是 "student-team"，则团队成员的作业仓库的名称将是 `assignment-1-student-team`。 {% data reusables.classroom.assignments-type-a-title %} -#### Assigning a deadline for an assignment +#### 分配作业的截止时间 {% data reusables.classroom.assignments-guide-assign-a-deadline %} -#### Choosing an assignment type +#### 选择作业类型 -Under "Individual or group assignment", select the drop-down menu, then click **Group assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a individual assignment, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)." +在“Individual or group assignment（个人或小组作业）”下，选择下拉菜单，然后单击 **Group assignment（小组作业）**。 创建作业后不可更改作业类型。 如果要创建个人作业，请参阅“[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)”。 -#### Defining teams for an assignment +#### 确定作业的团队 -If you've already created a group assignment for the classroom, you can reuse a set of teams for the new assignment. To create a new set with the teams that your students create for the assignment, type the name for the set. Optionally, type the maximum number of team members and total teams. +如果已为教室创建了小组作业，可以对新作业重复使用一组团队。 要使用学生为作业创建的团队创建一个新组，请输入组的名称。 （可选）键入团队成员和团队总数的最大数量。 {% tip %} **提示**： -- We recommend including details about the set of teams in the name for the set. For example, if you want to use the set of teams for one assignment, name the set after the assignment. If you want to reuse the set throughout a semester or course, name the set after the semester or course. +- 我们建议在组的名称中包含有关该组团队的详细信息。 例如，如果要对某个作业使用团队组，请以作业命名该组。 如果要在整个学期或课程中重复使用该组，请以学期或课程命名该组。 -- If you'd like to assign students to a specific team, give your students a name for the team and provide a list of members. +- 如果想将学生分配到特定团队，请为学生指定团队的名称并提供成员列表。 {% endtip %} -![Parameters for the teams participating in a group assignment](/assets/images/help/classroom/assignments-define-teams.png) +![用于参与小组作业的团队的参数](/assets/images/help/classroom/assignments-define-teams.png) -#### Choosing a visibility for assignment repositories +#### 选择作业仓库的可见性 {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -### Adding starter code and configuring a development environment +### 添加起始代码并配置开发环境 {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [Choosing a template repository](#choosing-a-template-repository) -- [Choosing an online integrated development environment (IDE)](#choosing-an-online-integrated-development-environment-ide) +- [选择模板仓库](#choosing-a-template-repository) +- [选择在线集成开发环境 (IDE)](#choosing-an-online-integrated-development-environment-ide) -#### Choosing a template repository +#### 选择模板仓库 -By default, a new assignment will create an empty repository for each team that a student creates. {% data reusables.classroom.you-can-choose-a-template-repository %} For more information about template repositories, see "[Creating a template repository](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)." +默认情况下，新作业将为学生创建的每个团队创建一个空仓库。 {% data reusables.classroom.you-can-choose-a-template-repository %} 有关模板仓库的更多信息，请参阅“[创建模板仓库](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)”。 {% data reusables.classroom.assignments-guide-choose-template-repository %} -#### Choosing an online integrated development environment (IDE) +#### 选择在线集成开发环境 (IDE) -{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." +{% data reusables.classroom.about-online-ides %} 更多信息请参阅“[集成 {% data variables.product.prodname_classroom %} 与 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)”。 {% data reusables.classroom.assignments-guide-choose-an-online-ide %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -### Providing feedback +### 提供反馈 -Optionally, you can automatically grade assignments and create a space for discussing each submission with the team. +（可选）您可以自动对作业进行分级，并创建一个空间，用于与团队讨论每个提交。 -- [Testing assignments automatically](#testing-assignments-automatically) -- [Preventing changes to important files](#preventing-changes-to-important-files) -- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) +- [自动测试作业](#testing-assignments-automatically) +- [防止对重要文件的更改](#preventing-changes-to-important-files) +- [为反馈创建拉取请求](#creating-a-pull-request-for-feedback) -#### Testing assignments automatically +#### 自动测试作业 {% data reusables.classroom.assignments-guide-using-autograding %} -#### Preventing changes to important files +#### 防止对重要文件的更改 {% data reusables.classroom.assignments-guide-prevent-changes %} -#### Creating a pull request for feedback +#### 为反馈创建拉取请求 {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -120,26 +120,26 @@ Optionally, you can automatically grade assignments and create a space for discu {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -### Inviting students to an assignment +### 邀请学生参加作业 {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -You can see the teams that are working on or have submitted an assignment in the **Teams** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %} +您可以在作业的 **Teams（团队）**选项卡中查看正在处理或已提交作业的团队。 {% data reusables.classroom.assignments-to-prevent-submission %}
    - Group assignment + 组分配
    ### 后续步骤 -- After you create the assignment and your students form teams, team members can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and the team can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Creating, cloning, and archiving repositories](/github/creating-cloning-and-archiving-repositories)," "[Using Git](/github/using-git)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)," and the free course on [managing merge conflicts](https://lab.github.com/githubtraining/managing-merge-conflicts) from {% data variables.product.prodname_learning %}. +- 在创建作业和学生组成团队后，团队成员可以使用 Git 和 {% data variables.product.product_name %} 的功能开始处理作业。 学生可以克隆仓库、推送提交、管理分支、创建和审查拉取请求、解决合并冲突以及讨论议题的更改。 您和团队都可以审查仓库的提交历史记录。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 使用入门](/github/getting-started-with-github)”、“[创建、克隆和存档仓库](/github/creating-cloning-and-archiving-repositories)”、“[使用 Git](/github/using-git)”和“[协作处理议题和拉取请求](/github/collaborating-with-issues-and-pull-requests)”，以及 {% data variables.product.prodname_learning %} 中的[管理合并冲突](https://lab.github.com/githubtraining/managing-merge-conflicts)课程。 -- When a team finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand how the team collaborated. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." +- 当团队完成作业时，您可以查看仓库中的文件，或者查看仓库的历史和可视化内容，以更好地了解团队如何协作。 更多信息请参阅“[使用图表可视化仓库](/github/visualizing-repository-data-with-graphs)”。 -- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." +- 您可以通过在拉取请求中评论个别提交或行来提供作业反馈。 更多信息请参阅“[评论拉取请求](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)”和“[从代码打开议题](/github/managing-your-work-on-github/opening-an-issue-from-code)”。 有关创建已保存回复以对常见错误提供反馈的信息，请参阅“[关于已保存回复](/github/writing-on-github/about-saved-replies)”。 ### 延伸阅读 -- "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" -- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" -- [Using Existing Teams in Group Assignments?](https://education.github.community/t/using-existing-teams-in-group-assignments/6999) in the {% data variables.product.prodname_education %} Community +- "[在课堂和研究中使用 {% data variables.product.prodname_dotcom %}](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" +- "[将学习管理系统连接到 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" +- {% data variables.product.prodname_education %} 社区中的[在小组作业中使用现有团队吗？](https://education.github.community/t/using-existing-teams-in-group-assignments/6999) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md index f882ddabd69c..c88a18f54f38 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-assignment-from-a-template-repository.md @@ -1,19 +1,19 @@ --- -title: Create an assignment from a template repository -intro: You can create an assignment from a template repository to provide starter code, documentation, and other resources to your students. +title: 从模板仓库创建作业 +intro: 您可以从模板仓库创建作业，为学生提供起始代码、文档和其他资源。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/using-template-repos-for-assignments --- -You can use a template repository on {% data variables.product.product_name %} as starter code for an assignment on {% data variables.product.prodname_classroom %}. Your template repository can contain boilerplate code, documentation, and other resources for your students. 更多信息请参阅“[创建模板仓库](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)”。 +您可以在 {% data variables.product.product_name %} 上使用模板仓库作为 {% data variables.product.prodname_classroom %} 上作业的起始代码。 模板仓库可包含学生的 boilerplate 代码、文档和其他资源。 更多信息请参阅“[创建模板仓库](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)”。 -To use the template repository for your assignment, the template repository must be owned by your organization, or the visibility of the template repository must be public. +要将模板仓库用于作业，模板仓库必须由您的组织拥有，或者模板仓库的可见性必须是公共的。 -{% data reusables.classroom.you-may-want-to-predefine-repository-settings %} For more information, see "[Configure default settings for assignment repositories](/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories)." +{% data reusables.classroom.you-may-want-to-predefine-repository-settings %} 更多信息请参阅“[配置作业仓库的默认设置](/education/manage-coursework-with-github-classroom/configure-default-settings-for-assignment-repositories)”。 ### 延伸阅读 -- "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" -- "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)" +- "[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" +- "[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md index 20bd5c14ef4c..d6f715b922ea 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/create-an-individual-assignment.md @@ -1,6 +1,6 @@ --- -title: Create an individual assignment -intro: You can create an assignment for students in your course to complete individually. +title: 创建个人作业 +intro: 您可以为课程中的学生创建需单独完成的作业。 versions: free-pro-team: '*' redirect_from: @@ -8,7 +8,7 @@ redirect_from: - /education/manage-coursework-with-github-classroom/create-an-individual-assignment --- -### About individual assignments +### 关于个人作业 {% data reusables.classroom.assignments-individual-definition %} @@ -16,83 +16,83 @@ redirect_from: {% data reusables.classroom.about-assignments %} -For a video demonstration of the creation of an individual assignment, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." +有关创建个人作业的视频演示，请参阅“[设置 {% data variables.product.prodname_classroom %} 的基本知识](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)”。 ### 基本要求 {% data reusables.classroom.assignments-classroom-prerequisite %} -### Creating an assignment +### 创建作业 {% data reusables.classroom.assignments-guide-create-the-assignment %} -### Setting up the basics for an assignment +### 设置作业的基本信息 -Name your assignment, decide whether to assign a deadline, and choose the visibility of assignment repositories. +指定作业的名称，决定是否分配截止时间，并选择作业仓库的可见性。 -- [Naming an assignment](#naming-an-assignment) -- [Assigning a deadline for an assignment](#assigning-a-deadline-for-an-assignment) -- [Choosing an assignment type](#choosing-an-assignment-type) -- [Choosing a visibility for assignment repositories](#choosing-a-visibility-for-assignment-repositories) +- [指定作业名称](#naming-an-assignment) +- [分配作业的截止时间](#assigning-a-deadline-for-an-assignment) +- [选择作业类型](#choosing-an-assignment-type) +- [选择作业仓库的可见性](#choosing-a-visibility-for-assignment-repositories) -#### Naming an assignment +#### 指定作业名称 -For an individual assignment, {% data variables.product.prodname_classroom %} names repositories by the repository prefix and the student's {% data variables.product.product_name %} username. By default, the repository prefix is the assignment title. For example, if you name an assignment "assignment-1" and the student's username on {% data variables.product.product_name %} is @octocat, the name of the assignment repository for @octocat will be `assignment-1-octocat`. +对于个人作业，{% data variables.product.prodname_classroom %} 使用仓库前缀和学生的 {% data variables.product.product_name %} 用户名对仓库命名。 默认情况下，仓库前缀是作业标题。 例如，如果您对作业 "assignment-1" 命名，学生在 {% data variables.product.product_name %} 上的用户名是 @octocat，则 @octocat 的作业仓库的名称将是 `assignment-1-octocat`。 {% data reusables.classroom.assignments-type-a-title %} -#### Assigning a deadline for an assignment +#### 分配作业的截止时间 {% data reusables.classroom.assignments-guide-assign-a-deadline %} -#### Choosing an assignment type +#### 选择作业类型 -Under "Individual or group assignment", select the drop-down menu, and click **Individual assignment**. You can't change the assignment type after you create the assignment. If you'd rather create a group assignment, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +在“Individual or group assignment（个人或小组作业）”下，选择下拉菜单，然后单击 **Individual assignment（个人作业）**。 创建作业后不可更改作业类型。 如果要创建小组作业，请参阅“[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)”。 -#### Choosing a visibility for assignment repositories +#### 选择作业仓库的可见性 {% data reusables.classroom.assignments-guide-choose-visibility %} {% data reusables.classroom.assignments-guide-click-continue-after-basics %} -### Adding starter code and configuring a development environment +### 添加起始代码并配置开发环境 {% data reusables.classroom.assignments-guide-intro-for-environment %} -- [Choosing a template repository](#choosing-a-template-repository) -- [Choosing an online integrated development environment (IDE)](#choosing-an-online-integrated-development-environment-ide) +- [选择模板仓库](#choosing-a-template-repository) +- [选择在线集成开发环境 (IDE)](#choosing-an-online-integrated-development-environment-ide) -#### Choosing a template repository +#### 选择模板仓库 -By default, a new assignment will create an empty repository for each student on the roster for the classroom. {% data reusables.classroom.you-can-choose-a-template-repository %} For more information about template repositories, see "[Creating a template repository](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)." +默认情况下，新作业将为教室名册上的每个学生创建一个空仓库。 {% data reusables.classroom.you-can-choose-a-template-repository %} 有关模板仓库的更多信息，请参阅“[创建模板仓库](/github/creating-cloning-and-archiving-repositories/creating-a-template-repository)”。 {% data reusables.classroom.assignments-guide-choose-template-repository %} {% data reusables.classroom.assignments-guide-click-continue-after-starter-code-and-feedback %} -#### Choosing an online integrated development environment (IDE) +#### 选择在线集成开发环境 (IDE) -{% data reusables.classroom.about-online-ides %} For more information, see "[Integrate {% data variables.product.prodname_classroom %} with an IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)." +{% data reusables.classroom.about-online-ides %} 更多信息请参阅“[集成 {% data variables.product.prodname_classroom %} 与 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)”。 {% data reusables.classroom.assignments-guide-choose-an-online-ide %} -### Providing feedback for an assignment +### 为作业提供反馈 -Optionally, you can automatically grade assignments and create a space for discussing each submission with the student. +（可选）您可以自动对作业进行分级，并创建一个空间，用于与学生讨论每个提交。 -- [Testing assignments automatically](#testing-assignments-automatically) -- [Preventing changes to important files](#preventing-changes-to-important-files) -- [Creating a pull request for feedback](#creating-a-pull-request-for-feedback) +- [自动测试作业](#testing-assignments-automatically) +- [防止对重要文件的更改](#preventing-changes-to-important-files) +- [为反馈创建拉取请求](#creating-a-pull-request-for-feedback) -#### Testing assignments automatically +#### 自动测试作业 {% data reusables.classroom.assignments-guide-using-autograding %} -#### Preventing changes to important files +#### 防止对重要文件的更改 {% data reusables.classroom.assignments-guide-prevent-changes %} -#### Creating a pull request for feedback +#### 为反馈创建拉取请求 {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} @@ -100,25 +100,25 @@ Optionally, you can automatically grade assignments and create a space for discu {% data reusables.classroom.assignments-guide-click-create-assignment-button %} -### Inviting students to an assignment +### 邀请学生参加作业 {% data reusables.classroom.assignments-guide-invite-students-to-assignment %} -You can see whether a student has joined the classroom and accepted or submitted an assignment in the **All students** tab for the assignment. {% data reusables.classroom.assignments-to-prevent-submission %} +您可以在作业的 **All students（所有学生）**选项卡中查看学生是否已进入教室或提交作业。 {% data reusables.classroom.assignments-to-prevent-submission %}
    - Individual assignment + 个人作业
    ### 后续步骤 -- Once you create the assignment, students can start work on the assignment using Git and {% data variables.product.product_name %}'s features. Students can clone the repository, push commits, manage branches, create and review pull requests, address merge conflicts, and discuss changes with issues. Both you and student can review the commit history for the repository. For more information, see "[Getting started with {% data variables.product.prodname_dotcom %}](/github/getting-started-with-github)," "[Creating, cloning, and archiving repositories](/github/creating-cloning-and-archiving-repositories)," "[Using Git](/github/using-git)," and "[Collaborating with issues and pull requests](/github/collaborating-with-issues-and-pull-requests)." +- 在创建作业后，学生可以使用 Git 和 {% data variables.product.product_name %} 的功能开始处理作业。 学生可以克隆仓库、推送提交、管理分支、创建和审查拉取请求、解决合并冲突以及讨论议题的更改。 您和学生都可以审查仓库的提交历史记录。 更多信息请参阅“[{% data variables.product.prodname_dotcom %} 使用入门”](/github/getting-started-with-github)、“[创建、克隆和存档仓库](/github/creating-cloning-and-archiving-repositories)”、“[使用 Git](/github/using-git)”和“[协作处理议题和拉取请求](/github/collaborating-with-issues-and-pull-requests)”。 -- When a student finishes an assignment, you can review the files in the repository, or you can review the history and visualizations for the repository to better understand the student's work. For more information, see "[Visualizing repository data with graphs](/github/visualizing-repository-data-with-graphs)." +- 当学生完成作业时，您可以查看仓库中的文件，或者查看仓库的历史和可视化内容，以更好地了解学生的工作。 更多信息请参阅“[使用图表可视化仓库](/github/visualizing-repository-data-with-graphs)”。 -- You can provide feedback for an assignment by commenting on individual commits or lines in a pull request. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)" and "[Opening an issue from code](/github/managing-your-work-on-github/opening-an-issue-from-code)." For more information about creating saved replies to provide feedback for common errors, see "[About saved replies](/github/writing-on-github/about-saved-replies)." +- 您可以通过在拉取请求中评论个别提交或行来提供作业反馈。 更多信息请参阅“[评论拉取请求](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)”和“[从代码打开议题](/github/managing-your-work-on-github/opening-an-issue-from-code)”。 有关创建已保存回复以对常见错误提供反馈的信息，请参阅“[关于已保存回复](/github/writing-on-github/about-saved-replies)”。 ### 延伸阅读 -- "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" -- "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" +- "[在课堂和研究中使用 {% data variables.product.prodname_dotcom %}](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research)" +- "[将学习管理系统连接到 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md index 44e2a0103fc0..67d11a20d08f 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/get-started-with-github-classroom.md @@ -1,7 +1,7 @@ --- -title: Get started with GitHub Classroom +title: GitHub Classroom 使用入门 shortTitle: 入门 -intro: Learn how to configure and use {% data variables.product.prodname_classroom %} to administer your course. +intro: 学习如何配置和使用 {% data variables.product.prodname_classroom %} 来管理您的课程。 mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/glossary.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/glossary.md index 3facfc7ba87f..44d5c75f571e 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/glossary.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/glossary.md @@ -1,49 +1,49 @@ --- title: 词汇表 -intro: You can review explanations of terminology for {% data variables.product.prodname_classroom %}. +intro: 您可以查看 {% data variables.product.prodname_classroom %} 的术语解释。 versions: free-pro-team: '*' --- ### 转让 -An assignment is coursework in {% data variables.product.prodname_classroom %}. A teacher can assign an assignment to an individual student or a group of students. Teachers can import starter code for the assignment, assign students, and create a deadline for each assignment. For more information, see the definitions for "[individual assignment](#individual-assignment)" and "[group assignment](#group-assignment)." +作业是 {% data variables.product.prodname_classroom %} 中的课程。 教师可以将作业分配给单个学生或一组学生。 教师可以导入作业的启动代码，指派学生，并为每项作业设定最后期限。 更多信息请参阅“[个人作业](#individual-assignment)”和“[小组作业](#group-assignment)”的定义。 --- -### classroom +### 教室 -A classroom is the basic unit of {% data variables.product.prodname_classroom %}. Teachers can use a classroom to organize and manage students, teaching assistants, and assignments for a single course. A classroom belongs to an organization on {% data variables.product.prodname_dotcom_the_website %}. To administer a classroom, you must be an organization owner for the organization on {% data variables.product.prodname_dotcom %}. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." +教室是 {% data variables.product.prodname_classroom %} 的基本单位。 教师可以利用教室组织和管理学生、教务助理和单门课程的作业。 教室属于 {% data variables.product.prodname_dotcom_the_website %} 上的组织。 要管理教室，您必须是 {% data variables.product.prodname_dotcom %} 上组织的组织所有者。 更多信息请参阅“[管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms)”。 --- ### {% data variables.product.prodname_classroom %} -{% data variables.product.prodname_classroom %} is a web application for educators that provides course administration tools integrated with {% data variables.product.prodname_dotcom %}. For more information, see the [{% data variables.product.prodname_classroom %}](https://classroom.github.com/) website. +{% data variables.product.prodname_classroom %} 是一个面向教育工作者的网络应用程序，提供与 {% data variables.product.prodname_dotcom %} 集成的课程管理工具。 更多信息请参阅 [{% data variables.product.prodname_classroom %}](https://classroom.github.com/) 网站。 --- -### group assignment +### 小组作业 -{% data reusables.classroom.assignments-group-definition %} For more information, see "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +{% data reusables.classroom.assignments-group-definition %} 更多信息请参阅“[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)”。 --- -### identifier +### 标识符 -An identifier in {% data variables.product.prodname_classroom %} is a unique ID for a student participating in a course. For example, an identifier can be a student name, alphanumeric ID, or email address. +{% data variables.product.prodname_classroom %} 中的标识符是学生参加课程的唯一 ID。 例如，标识符可以是学生姓名、字母数字 ID 或电子邮件地址。 --- -### individual assignment +### 个人作业 -{% data reusables.classroom.assignments-individual-definition %} For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)." +{% data reusables.classroom.assignments-individual-definition %} 更多信息请参阅“[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)”。 --- -### roster +### 名册 -A roster allows a teacher to manage students and assignment submissions in a classroom on {% data variables.product.prodname_classroom %}. Teachers can create a roster by entering a list of student identifiers, or by connecting {% data variables.product.prodname_classroom %} to a learning management system (LMS). For more information about identifiers, see the definition of "[identifier](#identifier)." For more information about connecting {% data variables.product.prodname_classroom %} to an LMS, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." +名册可让教师在 {% data variables.product.prodname_classroom %} 课堂中管理学生和作业提交。 教师可以通过输入学生标识符列表或连接 {% data variables.product.prodname_classroom %} 到学习管理系统 (LMS) 来创建名册。 有关标识符的更多信息，请参阅“[标识符](#identifier)”的定义。 有关将 {% data variables.product.prodname_classroom %} 连接到 LMS 的更多信息，请参阅“[将学习管理系统连接到 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)”。 --- diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/index.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/index.md index e568c09a1627..6814b44119da 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/index.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/index.md @@ -1,7 +1,7 @@ --- -title: Manage coursework with GitHub Classroom +title: 使用 GitHub Classroom 管理课程 shortTitle: '{% data variables.product.prodname_classroom %}' -intro: With {% data variables.product.prodname_classroom %}, you can use {% data variables.product.product_name %} to administer or participate in a course about software development. +intro: 通过 {% data variables.product.prodname_classroom %}，您可以使用 {% data variables.product.product_name %} 来管理或参与有关软件开发的课程。 versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md index f4245ea67232..e40bcabd4253 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide.md @@ -1,7 +1,7 @@ --- -title: Integrate GitHub Classroom with an IDE -shortTitle: Integrate with an IDE -intro: You can help your students write, test, and debug code by preconfiguring a development environment for assignment repositories on {% data variables.product.prodname_classroom %}. +title: 集成 GitHub Classroom 与 IDE +shortTitle: 与 IDE 集成 +intro: 您可以通过在 {% data variables.product.prodname_classroom %} 上预配置作业仓库的开发环境，来帮助学生编写、测试和调试代码。 mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md index 9a2b16772abc..4bae66193c4f 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide.md @@ -1,42 +1,42 @@ --- -title: Integrate GitHub Classroom with an online IDE -shortTitle: Integrate with an online IDE -intro: You can preconfigure a supported online integrated development environment (IDE) for assignments you create in {% data variables.product.prodname_classroom %}. +title: 将 GitHub Classroom 与在线 IDE 集成 +shortTitle: 与在线 IDE 集成 +intro: 您可以为您在 {% data variables.product.prodname_classroom %} 中创建的作业预配置受支持的在线集成开发环境 (IDE)。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/online-ide-integrations --- -### About integration with an online IDE +### 关于与在线 IDE 集成 {% data reusables.classroom.about-online-ides %} -After a student accepts an assignment with an online IDE, the README file in the student's assignment repository will contain a button to open the assignment in the IDE. The student can begin working immediately, and no additional configuration is necessary. +学生接受具有联机 IDE 的作业后，学生作业仓库中的 README 文件将包含一个按钮，用于打开 IDE 中的作业。 学生可以立即开始工作，无需进行其他配置。 -![Button for online IDE in README.md for assignment repository](/assets/images/help/classroom/assignment-repository-ide-button-in-readme.png) +![作业仓库的 README.md 中的在线 IDE 按钮](/assets/images/help/classroom/assignment-repository-ide-button-in-readme.png) -### Supported online IDEs +### 支持的在线 IDE -{% data variables.product.prodname_classroom %} supports the following online IDEs. You can learn more about the student experience for each IDE. +{% data variables.product.prodname_classroom %} 支持以下在线 IDE。 您可以详细了解每个 IDE 的学生体验。 -| IDE | 更多信息 | -|:------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Microsoft MakeCode Arcade | "[About using MakeCode Arcade with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom)" | -| Repl.it | "[About using Repl.it with GitHub Classroom](/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom)" | +| IDE | 更多信息 | +|:------------------------- |:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Microsoft MakeCode Arcade | "[关于结合使用 MakeCode Arcade 与 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/about-using-makecode-arcade-with-github-classroom)" | +| Repl.it | "[关于结合使用 Repl.it 与 GitHub Classroom](/education/manage-coursework-with-github-classroom/about-using-replit-with-github-classroom)" | -### Configuring an online IDE for an assignment +### 为作业配置在线 IDE -You can choose the online IDE you'd like to use for an assignment when you create an assignment. To learn how to create a new assignment that uses an online IDE, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +创建作业时，您可以选择要用于作业的在线 IDE。 要了解如何创建使用在线 IDE 的新作业，请参阅“[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)”或“[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)”。 -### Authorizing the OAuth app for an online IDE +### 为在线 IDE 授权 OAuth 应用程序 -The first time you configure an assignment with an online IDE, you must authorize the OAuth app for the online IDE for your organization. +第一次使用在线 IDE 配置作业时，必须为组织的在线 IDE 授权 OAuth 应用程序。 -!["Go grant access" button in popover for authorizing OAuth app for online IDE](/assets/images/help/classroom/assignment-ide-go-grant-access-button.png) +![用于为在线 IDE 授权 OAuth 应用程序的弹出窗口中的 "Go grant access（授予访问）"按钮](/assets/images/help/classroom/assignment-ide-go-grant-access-button.png) -For all repositories, grant the app **read** access to metadata, administration, and code, and **write** access to administration and code. 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps)”。 +对于所有仓库，授予应用程序**读取**元数据、管理和代码的权限，以及**写入**问管理和代码的权限。 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps)”。 ### 延伸阅读 -- "[About READMEs](/github/creating-cloning-and-archiving-repositories/about-readmes)" +- "[关于 README](/github/creating-cloning-and-archiving-repositories/about-readmes)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md index bca115034607..c3fd486ea1c0 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/learn-with-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Learn with GitHub Classroom -intro: You can participate in coursework in {% data variables.product.prodname_classroom %} and see results from your teacher. +title: 使用 GitHub Classroom 学习 +intro: 您可以参与 {% data variables.product.prodname_classroom %} 中的课程并查看老师的结果。 mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md index c51d2b43d347..94057649ebdf 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/leave-feedback-with-pull-requests.md @@ -1,31 +1,31 @@ --- -title: Leave feedback with pull requests -intro: You can leave feedback for your students in a special pull request within the repository for each assignment. -permissions: People with read permissions to a repository can leave feedback in a pull request for the repository. +title: 通过拉取请求留下反馈 +intro: 您可以仓库内的特定拉取请求中给学生的每个作业留反馈。 +permissions: 对仓库具有读取权限的用户可以在仓库的拉取请求中留下反馈。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/leaving-feedback-in-github --- -### About feedback pull requests for assignments +### 关于作业的反馈拉取请求 {% data reusables.classroom.you-can-create-a-pull-request-for-feedback %} -When you enable the pull request for feedback for an assignment, {% data variables.product.prodname_classroom %} will create a special pull request titled **Feedback** in the assignment repository for each student or team. The pull request automatically shows every commit that a student pushed to the assignment repository's default branch. +对作业启用反馈拉取请求时，{% data variables.product.prodname_classroom %} 将在作业仓库中为每个学生或团队创建标题为**反馈**的拉取请求。 拉取请求会自动显示学生推送到作业仓库的默认分支的每个提交。 ### 基本要求 -To create and access the feedback pull request, you must enable the feedback pull request when you create the assignment. {% data reusables.classroom.for-more-information-about-assignment-creation %} +要创建和访问反馈拉取请求，您必须在创建作业时启用反馈拉取请求。 {% data reusables.classroom.for-more-information-about-assignment-creation %} -### Leaving feedback in a pull request for an assignment +### 在作业的拉取请求中留下反馈 {% data reusables.classroom.sign-into-github-classroom %} -1. In the list of classrooms, click the classroom with the assignment you want to review. ![Classroom in list of classrooms for an organization](/assets/images/help/classroom/click-classroom-in-list.png) +1. 在教室列表中，单击包含要查看的作业的教室。 ![组织教室列表中的教室](/assets/images/help/classroom/click-classroom-in-list.png) {% data reusables.classroom.click-assignment-in-list %} -1. To the right of the submission, click **Review**. ![Review button for assignment in list of submissions for an assignment](/assets/images/help/classroom/assignments-click-review-button.png) -1. Review the pull request. For more information, see "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)." +1. 对于提交的右侧，请单击 **Review（查看）**。 ![作业提交列表中的作业查看按钮](/assets/images/help/classroom/assignments-click-review-button.png) +1. 查看拉取请求。 更多信息请参阅“[评论拉取请求](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)”。 ### 延伸阅读 -- "[Integrate {% data variables.product.prodname_classroom %} with an IDE](http://localhost:4000/en/free-pro-team@latest/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" +- "[集成 {% data variables.product.prodname_classroom %} 与 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide)" diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/manage-classrooms.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/manage-classrooms.md index 8b75539d5685..76cfa929ced5 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/manage-classrooms.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/manage-classrooms.md @@ -1,106 +1,106 @@ --- -title: Manage classrooms -intro: You can create and manage a classroom for each course that you teach using {% data variables.product.prodname_classroom %}. -permissions: Organization owners can manage a classroom for an organization. +title: 管理教室 +intro: 您可以为您使用 {% data variables.product.prodname_classroom %} 教授的每个课程创建和管理一个教室。 +permissions: 组织所有者可管理组织的教室。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/archive-a-classroom --- -### About classrooms +### 关于教室 {% data reusables.classroom.about-classrooms %} -![Classroom](/assets/images/help/classroom/classroom-hero.png) +![教室](/assets/images/help/classroom/classroom-hero.png) -### About management of classrooms +### 关于教室的管理 -{% data variables.product.prodname_classroom %} uses organization accounts on {% data variables.product.product_name %} to manage permissions, administration, and security for each classroom that you create. Each organization can have multiple classrooms. +{% data variables.product.prodname_classroom %} 使用 {% data variables.product.product_name %} 上的组织帐户来管理您创建的每个教室的权限、管理和安全。 每个组织可以有多个教室。 -After you create a classroom, {% data variables.product.prodname_classroom %} will prompt you to invite teaching assistants (TAs) and admins to the classroom. Each classroom can have one or more admins. Admins can be teachers, TAs, or any other course administrator who you'd like to have control over your classrooms on {% data variables.product.prodname_classroom %}. +创建教室后，{% data variables.product.prodname_classroom %} 将提示您邀请助教 (TA) 和管理员到教室。 每个教室可以有一个或多个管理员。 管理员可以是教师、TA 或您希望其控制您在 {% data variables.product.prodname_classroom %} 上的教室的任何其他课程管理员。 -Invite TAs and admins to your classroom by inviting the user accounts on {% data variables.product.product_name %} to your organization as organization owners and sharing the URL for your classrom. Organization owners can administer any classroom for the organization. For more information, see "[Permission levels for an organization](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)" and "[Inviting users to join your organization](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)." +邀请 TA 和管理员进入您的教室，操作方法是以组织所有者身份邀请 {% data variables.product.product_name %} 上的用户帐户到您的组织，并共享您教室的 URL。 组织所有者可以管理组织的任何教室。 更多信息请参阅“[组织的权限级别](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization)”和“[邀请用户加入您的组织](/github/setting-up-and-managing-organizations-and-teams/inviting-users-to-join-your-organization)”。 -When you're done using a classroom, you can archive the classroom and refer to the classroom, roster, and assignments later, or you can delete the classroom if you no longer need the classroom. +使用完教室后，可以存档教室，以后可以参考该教室、名册和作业，或者如果您不再需要该教室，也可以将其删除。 -### About classroom rosters +### 关于教室名册 -Each classroom has a roster. A roster is a list of identifiers for the students who participate in your course. +每个教室都有一个名册。 名册是参加您的课程的学生的标识符列表。 -When you first share the URL for an assignment with a student, the student must sign into {% data variables.product.product_name %} with a user account to link the user account to an identifier for the classroom. After the student links a user account, you can see the associated user account in the roster. You can also see when the student accepts or submits an assignment. +首次与学生共享作业 URL 时，学生必须使用其用户帐户登录 {% data variables.product.product_name %}，才能将用户帐户链接到教室的标识符。 学生链接用户帐户后，您可以在名册中看到关联的用户帐户。 您还可以查看学生何时接受或提交作业。 -![Classroom roster](/assets/images/help/classroom/roster-hero.png) +![教室名册](/assets/images/help/classroom/roster-hero.png) ### 基本要求 -You must have an organization account on {% data variables.product.product_name %} to manage classrooms on {% data variables.product.prodname_classroom %}. For more information, see "[Types of {% data variables.product.company_short %} accounts](/github/getting-started-with-github/types-of-github-accounts#organization-accounts)" and "[Creating a new organization from scratch](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)." +您必须在 {% data variables.product.product_name %} 上拥有组织帐户才能管理 {% data variables.product.prodname_classroom %} 上的教室。 更多信息请参阅“[{% data variables.product.company_short %} 帐户的类型](/github/getting-started-with-github/types-of-github-accounts#organization-accounts)”和“[从头开始创建新组织](/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch)”。 -You must authorize the OAuth app for {% data variables.product.prodname_classroom %} for your organization to manage classrooms for your organization account. 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps)”。 +您必须为组织授权 {% data variables.product.prodname_classroom %} 的 OAuth 应用程序才可管理组织帐户的教室。 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps)”。 -### Creating a classroom +### 创建教室 {% data reusables.classroom.sign-into-github-classroom %} -1. Click **New classroom**. !["New classroom" button](/assets/images/help/classroom/click-new-classroom-button.png) +1. 单击 **New classroom（新教室）**。 !["New classroom（新教室）"按钮](/assets/images/help/classroom/click-new-classroom-button.png) {% data reusables.classroom.guide-create-new-classroom %} -After you create a classroom, you can begin creating assignments for students. For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +创建教室后，您便可开始为学生创建作业。 更多信息请参阅“[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)”或“[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)”。 -### Creating a roster for your classroom +### 为教室创建名册 -You can create a roster of the students who participate in your course. +您可以创建参加本课程的学生名册。 -If your course already has a roster, you can update the students on the roster or delete the roster. For more information, see "[Adding a student to the roster for your classroom](#adding-students-to-the-roster-for-your-classroom)" or "[Deleting a roster for a classroom](#deleting-a-roster-for-a-classroom)." +如果您的课程已有名册，您可以更新名册上的学生或删除名册。 更多信息请参阅“[将学生添加到教室的名册](#adding-students-to-the-roster-for-your-classroom)”或“[删除教室的名册](#deleting-a-roster-for-a-classroom)”。 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. To connect {% data variables.product.prodname_classroom %} to your LMS and import a roster, click {% octicon "mortar-board" aria-label="The mortar board icon" %} **Import from a learning management system** and follow the instructions. For more information, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." !["Import from a learning management system" button](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png) -1. To create a roster manually, type your student identifiers. Optionally, click **Upload a CSV or text file** to upload a file containing the identifiers. ![Text field for typing student identifiers and "Upload a CSV or text file" button](/assets/images/help/classroom/type-or-upload-student-identifiers.png) -1. Click **Create roster**. !["Create roster" button](/assets/images/help/classroom/click-create-roster-button.png) +1. 要将 {% data variables.product.prodname_classroom %} 连接到 LMS 并导入名册，请单击 {% octicon "mortar-board" aria-label="The mortar board icon" %} **从学习管理系统导入**并按照说明操作。 更多信息请参阅“[将学习管理系统连接到 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)”。 !["Import from a learning management system（从学习管理系统导入）"按钮](/assets/images/help/classroom/click-import-from-a-learning-management-system-button.png) +1. 要手动创建名册，请键入学生标识符。 （可选）单击 **Upload a CSV or text file（上传 CSV 或文本文件）**以上传包含标识符的文件。 ![用于键入学生标识符的文本字段和"上传 CSV 或文本文件"按钮](/assets/images/help/classroom/type-or-upload-student-identifiers.png) +1. 单击 **Create roster（创建名册）**。 !["创建名册" 按钮](/assets/images/help/classroom/click-create-roster-button.png) -### Adding students to the roster for your classroom +### 将学生添加到教室的名册 -Your classroom must have an existing roster to add students to the roster. For more information about creating a roster, see "[Creating a roster for your classrom](#creating-a-roster-for-your-classroom)." +教室必须有一个现有的名册，才能将学生添加到名册中。 有关创建名册的更多信息，请参阅"[为教室创建名册](#creating-a-roster-for-your-classroom)。 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. To the right of "Classroom roster", click **Update students**. !["Update students" button to the right of "Classroom roster" heading above list of students](/assets/images/help/classroom/click-update-students-button.png) -1. Follow the instructions to add students to the roster. - - To import students from an LMS, click **Sync from a learning management system**. For more information about importing a roster from an LMS, see "[Connect a learning management system to {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)." - - To manually add students, under "Manually add students", click **Upload a CSV or text file** or type the identifiers for the students, then click **Add roster entries**. ![Modal for choosing method of adding students to classroom](/assets/images/help/classroom/classroom-add-students-to-your-roster.png) +1. 在“Classroom roster（教室名册）”右侧，单击 **Update students（更新学生）**。 ![学生列表上方"教室名册"标题右侧的"更新学生"按钮](/assets/images/help/classroom/click-update-students-button.png) +1. 按照说明将学生添加到名册中。 + - 要从 LMS 导入学生，请点击 **Sync from a learning management system（从学习管理系统同步）**。 有关将从 LMS 导入名册的更多信息，请参阅“[将学习管理系统连接到 {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/connect-a-learning-management-system-to-github-classroom)”。 + - 要手动添加学生，在“Manually add students（手动添加学生）”下，单击 **Upload a CSV or text file（上传 CSV 或文本文件）**或输入学生的标识符，然后单击 **Add roster entries（添加名册条目）**。 ![用于选择将学生添加到课堂的方法的模式](/assets/images/help/classroom/classroom-add-students-to-your-roster.png) -### Renaming a classroom +### 重命名教室 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} -1. Under "Classroom name", type a new name for the classroom. ![Text field under "Classroom name" for typing classroom name](/assets/images/help/classroom/settings-type-classroom-name.png) -1. Click **Rename classroom**. !["Rename classroom" button](/assets/images/help/classroom/settings-click-rename-classroom-button.png) +1. 在“Classroom name（教室名称）”下，为教室输入一个新的名称。 !["教室名称"下用于键入教室名称的文本字段](/assets/images/help/classroom/settings-type-classroom-name.png) +1. 单击 **Rename classroom（重命名教室）**。 !["重命名教室"按钮](/assets/images/help/classroom/settings-click-rename-classroom-button.png) -### Archiving or unarchiving a classroom +### 存档或取消存档教室 -You can archive a classroom that you no longer use on {% data variables.product.prodname_classroom %}. When you archive a classroom, you can't create new assignments or edit existing assignments for the classroom. Students can't accept invitations to assignments in archived classrooms. +您可以在 {% data variables.product.prodname_classroom %} 上存档不再使用的教室。 存档教室时，无法为教室创建新作业或编辑现有作业。 学生不能在存档的教室中接受分配作业的邀请。 {% data reusables.classroom.sign-into-github-classroom %} -1. To the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, then click **Archive**. ![Drop-down menu from horizontal kebab icon and "Archive" menu item](/assets/images/help/classroom/use-drop-down-then-click-archive.png) -1. To unarchive a classroom, to the right of a classroom's name, select the {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} drop-down menu, then click **Unarchive**. ![Drop-down menu from horizontal kebab icon and "Unarchive" menu item](/assets/images/help/classroom/use-drop-down-then-click-unarchive.png) +1. 在教室名称的右侧，选择 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 下拉菜单，然后单击“**Archive（存档）**”。 ![水平烤肉串图标的下拉菜单和"存档"菜单项](/assets/images/help/classroom/use-drop-down-then-click-archive.png) +1. 要取消存档教室，在教室名称的右侧，选择 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 下拉菜单，然后单击 **Unarchive（取消存档）**。 ![水平烤肉串图标的下拉菜单和"Unarchive（取消存档）"菜单项](/assets/images/help/classroom/use-drop-down-then-click-unarchive.png) -### Deleting a roster for a classroom +### 删除教室的名册 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-students %} -1. Under "Delete this roster", click **Delete roster**. !["Delete roster" button under "Delete this roster" in "Students" tab for a classroom](/assets/images/help/classroom/students-click-delete-roster-button.png) -1. Read the warnings, then click **Delete roster**. !["Delete roster" button under "Delete this roster" in "Students" tab for a classroom](/assets/images/help/classroom/students-click-delete-roster-button-in-modal.png) +1. 在“Delete this roster（删除此名册）”下，单击 **Delete roster（删除名册）**。 ![教室的"学生"选项卡中"删除此名册"下的"删除名册"按钮](/assets/images/help/classroom/students-click-delete-roster-button.png) +1. 阅读警告，然后单击 **Delete roster（删除名册）**。 ![教室的"学生"选项卡中"删除此名册"下的"删除名册"按钮](/assets/images/help/classroom/students-click-delete-roster-button-in-modal.png) -### Deleting a classroom +### 删除教室 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-settings %} -1. To the right of "Delete this classroom", click **Delete classroom**. !["Delete repository" button](/assets/images/help/classroom/click-delete-classroom-button.png) +1. 在“Delete this classroom（删除此教室）”右侧，单击 **Delete classroom（删除教室）**。 !["删除仓库"按钮](/assets/images/help/classroom/click-delete-classroom-button.png) 1. **阅读警告**。 -1. To verify that you're deleting the correct classroom, type the name of the classroom you want to delete. ![Modal for deleting a classrom with warnings and text field for classroom name](/assets/images/help/classroom/delete-classroom-modal-with-warning.png) -1. Click **Delete classroom**. !["Delete classroom" button](/assets/images/help/classroom/delete-classroom-click-delete-classroom-button.png) +1. 要验证删除的是否为正确的教室，请键入要删除的教室的名称。 ![用于删除包含警告的教室的模式和教室名称的文本字段](/assets/images/help/classroom/delete-classroom-modal-with-warning.png) +1. 单击 **Delete classroom（删除教室）**。 !["删除教室"按钮](/assets/images/help/classroom/delete-classroom-click-delete-classroom-button.png) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md index 57e3f1e82414..8d0288c482ab 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/run-student-code-in-an-online-ide.md @@ -1,21 +1,21 @@ --- -title: Run student code in an online IDE -intro: You can run the code from a student assignment within the online integrated development environment (IDE) that you configured for the assignment. +title: 于在线 IDE 中运行学生代码 +intro: 您可以在为作业配置的在线集成开发环境 (IDE) 中运行学生作业中的代码。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/running-student-code --- -### About student code and online IDEs +### 关于学生代码和在线 IDE -If you configure an online integrated development environment (IDE) for an assignment, you can run the code within the online IDE. You don't need to clone the assignment repository to your computer. +如果为作业配置在线集成开发环境 (IDE)，您可以在在线 IDE 中运行代码。 您不需要复制作业仓库到您的计算机。 -For more information about online IDEs, see "[Integrate {% data variables.product.prodname_classroom %} with an online IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)." +有关在线 IDE 的更多信息，请参阅“[集成 {% data variables.product.prodname_classroom %} 与在线 IDE](/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-online-ide)”。 -### Running student code in the online IDE +### 在在线 IDE 中运行学生代码 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-assignment-in-list %} -1. To the right of the submission, click **View IDE**. !["View IDE" button for submission using an online IDE](/assets/images/help/classroom/assignments-click-view-ide.png) +1. 在提交的右侧，请单击 **View IDE（查看 IDE）**。 ![使用在线 IDE 提交的"查看 IDE"按钮](/assets/images/help/classroom/assignments-click-view-ide.png) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md index 6e051e9d2d82..6261f3364552 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom.md @@ -1,6 +1,6 @@ --- -title: Teach with GitHub Classroom -intro: Learn how to set up your classroom and assignments. +title: 使用 GitHub Classroom 教学 +intro: 了解如何设置课堂和作业。 mapTopic: true versions: free-pro-team: '*' diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/use-autograding.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/use-autograding.md index 986bda5a5694..d52d0f534dc8 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/use-autograding.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/use-autograding.md @@ -1,6 +1,6 @@ --- -title: Use autograding -intro: You can automatically provide feedback on code submissions from your students by configuring tests to run in the assignment repository. +title: 使用自动分级 +intro: 您可以通过配置测试在作业仓库中运行，来自动提供对您学生提交的代码的反馈。 miniTocMaxHeadingLevel: 4 versions: free-pro-team: '*' @@ -9,75 +9,75 @@ redirect_from: - /education/manage-coursework-with-github-classroom/reviewing-auto-graded-work-teachers --- -### About autograding +### 关于自动分级 {% data reusables.classroom.about-autograding %} -After a student accepts an assignment, on every push to the assignment repository, {% data variables.product.prodname_actions %} runs the commands for your autograding test in a Linux environment containing the student's newest code. {% data variables.product.prodname_classroom %} creates the necessary workflows for {% data variables.product.prodname_actions %}. You don't need experience with {% data variables.product.prodname_actions %} to use autograding. +学生接受作业后，每次推送到作业仓库时，{% data variables.product.prodname_actions %} 都会在包含学生最新代码的 Linux 环境中运行自动分级测试的命令。 {% data variables.product.prodname_classroom %} 为 {% data variables.product.prodname_actions %} 创建必要的工作流程。 您不需要使用 {% data variables.product.prodname_actions %} 的经验便可使用自动分级。 -You can use a testing framework, run a custom command, write input/output tests, or combine different testing methods. The Linux environment for autograding contains many popular software tools. For more information, see the details for the latest version of Ubuntu in "[Specifications for {% data variables.product.company_short %}-hosted runners](/actions/reference/specifications-for-github-hosted-runners#supported-software)." +您可以使用测试框架、运行自定义命令、编写输入/输出测试或组合不同的测试方法。 用于自动分级的 Linux 环境包含许多流行的软件工具。 更多信息请参阅 [{% data variables.product.company_short %} 托管的运行器的规格](/actions/reference/specifications-for-github-hosted-runners#supported-software)中最新版 Ubuntu 的详细信息。 -You can see an overview of which students are passing autograding tests by navigating to the assignment in {% data variables.product.prodname_classroom %}. A green checkmark means that all tests are passing for the student, and a red X means that some or all tests are failing for the student. If you award points for one or more tests, then a bubble shows the score for the tests out of the maximum possible score for the assignment. +您可以通过导航 {% data variables.product.prodname_classroom %} 中的作业来查看哪些学生通过了自动分级测试的概况。 绿色复选标记表示学生的所有测试都已通过，红色 X 表示学生的部分或所有测试都未通过。 如果您为一个或多个测试评分，则气泡会显示测试的分数以及作业可得最高分数。 -![Overview for an assignment with autograding results](/assets/images/help/classroom/autograding-hero.png) +![包含自动评分结果的作业概述](/assets/images/help/classroom/autograding-hero.png) -### Grading methods +### 评分方法 -There are two grading methods: input/output tests and run command tests. +有两种评分方法：输入/输出测试和运行命令测试。 -#### Input/output test +#### 输入/输出测试 -An input/output test optionally runs a setup command, then provides standard input to a test command. {% data variables.product.prodname_classroom %} evaluates the test command's output against an expected result. +输入/输出测试可以选择性运行设置命令，然后向测试命令提供标准输入。 {% data variables.product.prodname_classroom %} 根据预期结果评估测试命令的输出。 -| 设置 | 描述 | -|:------------------- |:------------------------------------------------------------------------------------------------------------------------------ | -| **Test name** | The name of the test, to identify the test in logs | -| **Setup command** | _Optional_. A command to run before tests, such as compilation or installation | -| **Run command** | The command to run the test and generate standard output for evaluation | -| **Inputs** | Standard input for run command | -| **Expected output** | The output that you want to see as standard output from the run command | -| **Comparison** | The type of comparison between the run command's output and the expected output

    • **Included**: Passes when the expected output appears
      anywhere in the standard output from the run command
    • **Exact**: Passes when the expected output is completely identical
      to the standard output from the run command
    • **Regex**: Passes if the regular expression in expected
      output matches against the standard output from the run command
    | -| **Timeout** | In minutes, how long a test should run before resulting in failure | -| **Points** | _Optional_. The number of points the test is worth toward a total score | +| 设置 | 描述 | +|:-------- |:------------------------------------------------------------------ | +| **测试名称** | 测试的名称，用于识别日志中的测试 | +| **设置命令** | _可选_。 在测试之前运行的命令，如编译或安装 | +| **运行命令** | 运行测试并生成用于评估的标准输出的命令 | +| **输入** | 运行命令的标准输入 | +| **预期输出** | 您要视为运行命令的标准输出的输出 | +| **比较** | 运行命令的输出和预期输出之间的比较类型

    • **包括**：当预期输出在
      命令的标准输出的任意位置出现时传递
    • **精确**：当预期输出与运行命令的
      标准输出完全相同时传递
    • **Regex**：当预期输出中的正则表达式与
      运行命令的标准输出匹配时传递
    | +| **超时** | 测试在导致失败之前应运行多长时间（分钟） | +| **分数** | _可选_。 测试从总分中获得的分数 | -#### Run command test +#### 运行命令测试 -A run command test runs a setup command, then runs a test command. {% data variables.product.prodname_classroom %} checks the exit status of the test command. An exit code of `0` results in success, and any other exit code results in failure. +运行命令测试运行设置命令，然后运行测试命令。 {% data variables.product.prodname_classroom %} 检查测试命令的退出状态。 `0` 的退出代码导致成功，任何其他退出代码导致失败。 -{% data variables.product.prodname_classroom %} provides presets for language-specific run command tests for a variety of programming languages. For example, the **Run node** test prefills the setup command with `npm install` and the test command with `npm test`. +{% data variables.product.prodname_classroom %} 为各种编程语言提供语言特定的运行命令测试预设。 例如，**运行节点**测试使用 `npm install` 预填设置命令，使用 `npm test` 预填测试命令。 -| 设置 | 描述 | -|:----------------- |:------------------------------------------------------------------------------ | -| **Test name** | The name of the test, to identify the test in logs | -| **Setup command** | _Optional_. A command to run before tests, such as compilation or installation | -| **Run command** | The command to run the test and generate an exit code for evaluation | -| **Timeout** | In minutes, how long a test should run before resulting in failure | -| **Points** | _Optional_. The number of points the test is worth toward a total score | +| 设置 | 描述 | +|:-------- |:----------------------- | +| **测试名称** | 测试的名称，用于识别日志中的测试 | +| **设置命令** | _可选_。 在测试之前运行的命令，如编译或安装 | +| **运行命令** | 运行测试并生成用于评估的退出代码的命令 | +| **超时** | 测试在导致失败之前应运行多长时间（分钟） | +| **分数** | _可选_。 测试从总分中获得的分数 | -### Configuring autograding tests for an assignment +### 配置作业的自动评分测试 -You can add autograding tests during the creation of a new assignment. {% data reusables.classroom.for-more-information-about-assignment-creation %} +您可以在创建新作业时添加自动评分测试。 {% data reusables.classroom.for-more-information-about-assignment-creation %} -You can add, edit, or delete autograding tests for an existing assignment. If you change the autograding tests for an existing assignment, existing assignment repositories will not be affected. A student or team must accept the assignment and create a new assignment repository to use the new tests. +您可以添加、编辑或删除现有作业的自动评分测试。 如果您更改现有作业的自动评分测试，现有作业仓库将不会受到影响。 学生或团队必须接受作业并创建一个新的作业仓库来使用新的测试。 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.assignments-click-pencil %} -1. In the left sidebar, click **Grading and feedback**. !["Grading and feedback" to the left of assignment's basics](/assets/images/help/classroom/assignments-click-grading-and-feedback.png) -1. Add, edit, or delete an autograding test. - - To add a test, under "Add autograding tests", select the **Add test** drop-down menu, then click the grading method you want to use. ![Using the "Add test" drop-down menu to click a grading method](/assets/images/help/classroom/autograding-click-grading-method.png) Configure the test, then click **Save test case**. !["Save test case" button for an autograding test](/assets/images/help/classroom/assignments-click-save-test-case-button.png) - - To edit a test, to the right of the test name, click {% octicon "pencil" aria-label="The pencil icon" %}. ![Pencil icon for editing an autograding test](/assets/images/help/classroom/autograding-click-pencil.png) Configure the test, then click **Save test case**. !["Save test case" button for an autograding test](/assets/images/help/classroom/assignments-click-save-test-case-button.png) - - To delete a test, to the right of the test name, click {% octicon "trash" aria-label="The trash icon" %}. ![Trash icon for deleting an autograding test](/assets/images/help/classroom/autograding-click-trash.png) -1. At the bottom of the page, click **Update assignment**. !["Update assignment" button at the bottom of the page](/assets/images/help/classroom/assignments-click-update-assignment.png) +1. 在左侧边栏中，单击 **Grading and feedback（评分并反馈）**。 ![作业基本知识左侧的"评分并反馈"](/assets/images/help/classroom/assignments-click-grading-and-feedback.png) +1. 添加、编辑或删除自动评分测试。 + - 要添加测试，在“Add autograding tests（添加自动评分测试）”下，选择 **Add test（添加测试）**下拉菜单，然后单击您想要使用的评分方法。 ![Using the "Add test" drop-down menu to click a grading method](/assets/images/help/classroom/autograding-click-grading-method.png) 配置测试，然后单击“**Save test case（保存测试用例）**”。 ![用于自动评分测试的"保存测试用例"按钮](/assets/images/help/classroom/assignments-click-save-test-case-button.png) + - 要编辑测试，请点击测试名称右侧的 {% octicon "pencil" aria-label="The pencil icon" %}。 ![Pencil icon for editing an autograding test](/assets/images/help/classroom/autograding-click-pencil.png) 配置测试，然后单击“**Save test case（保存测试用例）**”。 ![用于自动评分测试的"保存测试用例"按钮](/assets/images/help/classroom/assignments-click-save-test-case-button.png) + - 要删除测试，请点击测试名称右侧的 {% octicon "trash" aria-label="The trash icon" %}。 ![用于删除自动评分测试的垃圾桶图标](/assets/images/help/classroom/autograding-click-trash.png) +1. 在页面底部，单击 **Update assignment（更新作业）**。 ![页面底部的"更新作业"按钮](/assets/images/help/classroom/assignments-click-update-assignment.png) -### Viewing logs from autograding tests +### 查看自动评分测试的日志 {% data reusables.classroom.sign-into-github-classroom %} {% data reusables.classroom.click-classroom-in-list %} {% data reusables.classroom.click-assignment-in-list %} -1. To the right of a submission, click **View test**. !["View test" button for an assignment submission](/assets/images/help/classroom/assignments-click-view-test.png) -1. Review the test output. For more information, see "[Using workflow run logs](/actions/managing-workflow-runs/using-workflow-run-logs)." +1. 在提交的右侧，请单击 **View test（查看测试）**。 ![用于作业提交的"查看测试"按钮](/assets/images/help/classroom/assignments-click-view-test.png) +1. 查看测试输出。 更多信息请参阅“[使用工作流程运行日志](/actions/managing-workflow-runs/using-workflow-run-logs)”。 ### 延伸阅读 -- [{% data variables.product.prodname_actions %} documentation](/actions) +- [{% data variables.product.prodname_actions %} 文档](/actions) diff --git a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/view-autograding-results.md b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/view-autograding-results.md index 533f4ddcc88d..4c6b75ded5dd 100644 --- a/translations/zh-CN/content/education/manage-coursework-with-github-classroom/view-autograding-results.md +++ b/translations/zh-CN/content/education/manage-coursework-with-github-classroom/view-autograding-results.md @@ -1,29 +1,29 @@ --- -title: View autograding results -intro: You can see results from autograding within the repository for your assignment. +title: 查看自动评分结果 +intro: 您可以在作业仓库中查看自动评分结果。 versions: free-pro-team: '*' redirect_from: - /education/manage-coursework-with-github-classroom/reviewing-auto-graded-work-students --- -### About autograding +### 关于自动分级 -Your teacher can configure tests that automatically check your work when you push to an assignment repository on {% data variables.product.product_location %}. +教师可以配置测试在您推送到 {% data variables.product.product_location %} 上的作业仓库时自动检查您的工作。 -If you're a student and your instructor has configured autograding for your assignment in {% data variables.product.prodname_classroom %}, you'll find autograding test results throughout your assignment repository. If all tests succeed for a commit, you'll see a green checkmark. If any tests fail for a commit, you'll see a red X. You can see detailed logs by clicking the green checkmark or red X. +如果您是学生，并且讲师已为 {% data variables.product.prodname_classroom %} 中的作业配置自动评分，则您会在整个作业仓库找到自动评分测试结果。 如果提交的所有测试都成功，您将看到绿色复选标记。 如果提交的任何测试失败，您会看到红色的 X。您可以通过单击绿色复选标记或红色 X 查看详细日志。 -### Viewing autograding results for an assignment repository +### 查看作业仓库的自动评分结果 -{% data variables.product.prodname_classroom %} uses {% data variables.product.prodname_actions %} to run autograding tests. For more information about viewing the logs for an autograding test, see "[Using workflow run logs](/actions/managing-workflow-runs/using-workflow-run-logs#viewing-logs-to-diagnose-failures)." +{% data variables.product.prodname_classroom %} 使用 {% data variables.product.prodname_actions %} 来运行自动评分测试。 有关查看自动评分测试的日志的详细信息，请参阅“[使用工作流程运行日志](/actions/managing-workflow-runs/using-workflow-run-logs#viewing-logs-to-diagnose-failures)”。 -The **Actions** tab shows the full history of test runs. +**Actions（操作）**选项卡显示测试运行的完整历史记录。 -!["Actions" tab with "All workflows" selected](/assets/images/help/classroom/autograding-actions-tab.png) +![选择了"所有工作流程"的"操作"选项卡](/assets/images/help/classroom/autograding-actions-tab.png) -You can click a specific test run to review log output, like compilation errors and test failures. +您可以单击特定的测试运行来查看日志输出，如编译错误和测试失败。 -![The "{% data variables.product.prodname_classroom %} Autograding Workflow" test results logs in {% data variables.product.prodname_actions %} ](/assets/images/help/classroom/autograding-actions-logs.png) +![{% data variables.product.prodname_actions %} 中的"{% data variables.product.prodname_classroom %} 自动评分工作流程"测试结果日志 ](/assets/images/help/classroom/autograding-actions-logs.png) ### 延伸阅读 diff --git a/translations/zh-CN/content/education/quickstart.md b/translations/zh-CN/content/education/quickstart.md index 3a5c526108a7..cc7bb5045100 100644 --- a/translations/zh-CN/content/education/quickstart.md +++ b/translations/zh-CN/content/education/quickstart.md @@ -1,6 +1,6 @@ --- -title: Quickstart for GitHub Educators -intro: In about 15 minutes, teachers can get started with discounts, training, and tools for {% data variables.product.company_short %}, then create a classroom for the students in a software development course using {% data variables.product.prodname_classroom %}. +title: GitHub Educators 快速入门 +intro: 大约 15 分钟后，教师就可以开始享受 {% data variables.product.company_short %} 的优惠、培训和工具，然后使用 {% data variables.product.prodname_classroom %} 在软件开发课程中为学生创建教室。 allowTitleToDifferFromFilename: true versions: free-pro-team: '*' @@ -8,39 +8,39 @@ versions: ### 简介 -Educators who teach a course on software development can use discounts, partnerships, training, and tools from {% data variables.product.prodname_education %} to effectively teach relevant skills to students. +教授软件开发课程的教育工作者可以使用 {% data variables.product.prodname_education %} 的折扣、伙伴关系、培训和工具有效地向学生传授相关技能。 -In this guide, you'll get started with {% data variables.product.product_name %}, sign up for accounts and discounted services through {% data variables.product.prodname_education %}, and create a space for your course and assignment on {% data variables.product.prodname_classroom %}. +在本指南中，您将从 {% data variables.product.product_name %} 开始，通过 {% data variables.product.prodname_education %} 注册帐户和折扣服务，并在 {% data variables.product.prodname_classroom %} 上为您的课程和作业创建空间。 {% tip %} -**Tip**: If you're a student and you'd like to take advantage of an academic discount, see "[Applying for a student developer pack](/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack)." +**提示**：如果您是学生，想利用学术折扣，请参阅“[申请学生开发包](/github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack)”。 {% endtip %} -### Creating accounts on {% data variables.product.product_name %} +### 在 {% data variables.product.product_name %} 上创建帐户 -First, you'll need to create a free user account on {% data variables.product.product_name %}. +首先，您需要在 {% data variables.product.product_name %} 上创建免费用户帐户。 {% data reusables.accounts.create-account %} -1. Follow the prompts to create your free user account. +1. 按照提示创建免费用户帐户。 -After you create your user account, create a free organization account. You'll use this organization account to create and manage classrooms {% data variables.product.prodname_classroom %}. +创建用户帐户后，创建一个免费的组织帐户。 您将使用此组织帐户创建和管理教室 {% data variables.product.prodname_classroom %}。 {% data reusables.user_settings.access_settings %} {% data reusables.user_settings.organizations %} {% data reusables.organizations.new-organization %} -4. Follow the prompts to create a free organization. +4. 按照提示创建免费组织。 -For more information, see "[Types of {% data variables.product.prodname_dotcom %} accounts](/github/getting-started-with-github/types-of-github-accounts)." +更多信息请参阅“[{% data variables.product.prodname_dotcom %} 帐户的类型](/github/getting-started-with-github/types-of-github-accounts)”。 -### Applying for an educator discount +### 申请教育者折扣 -Next, you'll sign up for discounts on services from {% data variables.product.company_short %}. {% data reusables.education.educator-requirements %} +接下来，您将注册从 {% data variables.product.company_short %} 获得服务折扣。 {% data reusables.education.educator-requirements %} {% tip %} -**Tip** In addition to individual discounts, {% data variables.product.company_short %} offers partnerships with educational institutions through the {% data variables.product.prodname_campus_program %}. For more information, see the [{% data variables.product.prodname_campus_program %}](https://education.github.com/schools) website. +**提示** 除了个人折扣外，{% data variables.product.company_short %} 还通过 {% data variables.product.prodname_campus_program %} 与教育机构合作。 更多信息请参阅 [{% data variables.product.prodname_campus_program %}](https://education.github.com/schools) 网站。 {% endtip %} @@ -52,36 +52,36 @@ Next, you'll sign up for discounts on services from {% data variables.product.co {% data reusables.education.plan-to-use-github %} {% data reusables.education.submit-application %} -### Set up {% data variables.product.prodname_classroom %} +### 设置 {% data variables.product.prodname_classroom %} -With your user account and organization account, you're ready to get started with {% data variables.product.prodname_classroom %}. {% data variables.product.prodname_classroom %} is free to use. You can track and manage assignments, grade work automatically, and provide feedback to your students. +通过用户帐户和组织帐户便可开始使用 {% data variables.product.prodname_classroom %}。 {% data variables.product.prodname_classroom %} 免费使用。 您可以跟踪和管理作业，自动对工作进行评分，并为学生提供反馈。 {% data reusables.classroom.sign-into-github-classroom %} -1. To authorize {% data variables.product.prodname_classroom %} to access your user account on {% data variables.product.prodname_dotcom %}, review the information, then click **Authorize {% data variables.product.prodname_classroom %}**. !["Authorize {% data variables.product.prodname_classroom %}" button for user account](/assets/images/help/classroom/setup-click-authorize-github-classroom.png) -1. Review the information. To authorize {% data variables.product.prodname_classroom %} to access your organization account on {% data variables.product.prodname_dotcom %}, click **Grant**. !["Grant" button for organization](/assets/images/help/classroom/setup-click-grant.png) +1. 要授权 {% data variables.product.prodname_classroom %} 访问您在 {% data variables.product.prodname_dotcom %} 上的用户帐户，请查阅信息，然后单击**授权 {% data variables.product.prodname_classroom %}**。 ![用户帐户的"授权 {% data variables.product.prodname_classroom %}"按钮](/assets/images/help/classroom/setup-click-authorize-github-classroom.png) +1. 查看信息。 要授权 {% data variables.product.prodname_classroom %} 访问您在 {% data variables.product.prodname_dotcom %} 上的组织帐户，请单击 **Grant（授予）**。 ![组织的"授予"按钮](/assets/images/help/classroom/setup-click-grant.png) {% tip %} - **Tip**: If you see a **Request** button instead of a **Grant** button, you are a member of the organization, not an owner. An owner must approve your request for {% data variables.product.prodname_classroom %}. You must be an organization owner to create and manage classrooms and assignments in {% data variables.product.prodname_classroom %}. 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps#oauth-apps-and-organizations)”。 + **提示**：如果您看到 **Request（请求）** 按钮而不是 **Grant（授予）**按钮，则表明您是组织的成员，而不是所有者。 所有者必须批准您的 {% data variables.product.prodname_classroom %} 请求。 您必须是组织所有者才能在 {% data variables.product.prodname_classroom %} 中创建和管理教室和作业。 更多信息请参阅“[授权 OAuth 应用程序](/github/authenticating-to-github/authorizing-oauth-apps#oauth-apps-and-organizations)”。 {% endtip %} -1. Click **Authorize github**. ![Click "Authorize" button for organization](/assets/images/help/classroom/setup-click-authorize-github.png) +1. 单击 **Authorize GitHub（授权 GitHub）**。 ![单击组织的"Authorize（授权）"按钮](/assets/images/help/classroom/setup-click-authorize-github.png) -### Create your classroom +### 创建教室 {% data reusables.classroom.about-classrooms %} {% data reusables.classroom.sign-into-github-classroom %} -1. Click **Create your first classroom** or **New classroom**. +1. 单击 **Create your first classroom（创建第一个教室）**或 **New classroom（新教室）**。 {% data reusables.classroom.guide-create-new-classroom %} ### 后续步骤 -You've created a classroom, and you're ready to enrich your course with {% data variables.product.product_name %} and {% data variables.product.prodname_classroom %}! 🎉 +您已经创建了教室，可以开始使用 {% data variables.product.product_name %} 和 {% data variables.product.prodname_classroom %} 丰富您的课程！ 🎉 -- Watch some videos about {% data variables.product.prodname_classroom %}. For more information, see "[Basics of setting up {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)." -- Manage your classrooms and classroom admins, and create a roster of students for your classroom. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." -- Create an assignment for individual students or teams. {% data reusables.classroom.for-more-information-about-assignment-creation %} -- Write and implement automated tests to provide immediate feedback to students directly in assignment repositories. For more information, see "[Use autograding](/education/manage-coursework-with-github-classroom/use-autograding)." -- Participate in {% data variables.product.prodname_education_community_with_url %}. +- 观看一些关于 {% data variables.product.prodname_classroom %} 的视频。 更多信息请参阅“[设置 {% data variables.product.prodname_classroom %} 的基本知识](/education/manage-coursework-with-github-classroom/basics-of-setting-up-github-classroom)”。 +- 管理您的教室和教室管理员，并为您的教室创建学生名册。 更多信息请参阅“[管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms)”。 +- 为个别学生或团队创建作业。 {% data reusables.classroom.for-more-information-about-assignment-creation %} +- 编写并实施自动化测试，直接在作业仓库中为学生提供即时反馈。 更多信息请参阅“[使用自动分级](/education/manage-coursework-with-github-classroom/use-autograding)”。 +- 参加 {% data variables.product.prodname_education_community_with_url %}。 diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md index f587517629be..754ee0f02b3d 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education-for-students.md @@ -12,9 +12,9 @@ versions: {% data reusables.education.about-github-education-link %} -拥有 {% data variables.product.prodname_dotcom %} 帐户的每个人都可通过 {% data variables.product.prodname_free_user %} 在无限的公共和私有仓库中协作。 作为学生，您也可以申请 {% data variables.product.prodname_student_pack %}，以免费使用专业开发者使用的工具和服务。 For more information, see "[Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" and [{% data variables.product.prodname_education %}](https://education.github.com/pack). +拥有 {% data variables.product.prodname_dotcom %} 帐户的每个人都可通过 {% data variables.product.prodname_free_user %} 在无限的公共和私有仓库中协作。 作为学生，您也可以申请 {% data variables.product.prodname_student_pack %}，以免费使用专业开发者使用的工具和服务。 更多信息请参阅“[申请学生开发包](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)”和 [{% data variables.product.prodname_education %}](https://education.github.com/pack)。 -如果您是 FIRST 机器人俱乐部的成员，您的辅导员可以申请教育者折扣，这样您的团队可以免费使用 {% data variables.product.prodname_team %}（允许无限的用户和私有仓库） 进行协作。 For more information, see "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)." +如果您是 FIRST 机器人俱乐部的成员，您的辅导员可以申请教育者折扣，这样您的团队可以免费使用 {% data variables.product.prodname_team %}（允许无限的用户和私有仓库） 进行协作。 更多信息请参阅“[申请教育者或研究人员折扣](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)”。 ### 延伸阅读 diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education.md index 59dfc4219c3b..e2f1c6b55a51 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/about-github-education.md @@ -16,8 +16,8 @@ versions: 更多信息请参阅[官方 {% data variables.product.prodname_education %}](https://education.github.com/partners/schools) 网页。 -Teachers can manage a course on software development with {% data variables.product.prodname_education %}. {% data variables.product.prodname_classroom %} allows you to distribute code, provide feedback, and manage coursework using {% data variables.product.product_name %}. For more information, see "[Manage coursework with {% data variables.product.prodname_classroom %}](/education/manage-coursework-with-github-classroom)." +教师可以使用 {% data variables.product.prodname_education %} 管理软件开发课程。 {% data variables.product.prodname_classroom %} 可用于发布代码、提供反馈，以及使用 {% data variables.product.product_name %} 管理课程。 更多信息请参阅“[使用 {% data variables.product.prodname_classroom %} 管理课程](/education/manage-coursework-with-github-classroom)”。 要详细了解学生领导者和教师的培训计划，请参阅 "[{% data variables.product.prodname_dotcom %} Campus Experts](https://education.github.com/students/experts)" 和 "[Campus Advisors](https://education.github.com/teachers/advisors)"。 -如果您是学生或教师并且您的学校未作为 {% data variables.product.prodname_education %} 学校与 {% data variables.product.prodname_dotcom %} 合作，您也可以个人申请使用 {% data variables.product.prodname_dotcom %} 的折扣。 For more information, see "[Use {% data variables.product.prodname_dotcom %} for your schoolwork](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork)" or "[Use {% data variables.product.prodname_dotcom %} in your classroom and research](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research/)." +如果您是学生或教师并且您的学校未作为 {% data variables.product.prodname_education %} 学校与 {% data variables.product.prodname_dotcom %} 合作，您也可以个人申请使用 {% data variables.product.prodname_dotcom %} 的折扣。 更多信息请参阅“[使用 {% data variables.product.prodname_dotcom %} 做家庭作业](/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork)”或“[在课堂上和研究中使用 {% data variables.product.prodname_dotcom %}](/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research/)”。 diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md index 0f13be8acfee..3a6923781c46 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack.md @@ -1,5 +1,5 @@ --- -title: Apply for a student developer pack +title: 申请学生开发包 intro: '作为学生，可以申请 {% data variables.product.prodname_student_pack %}，其中包括 {% data variables.product.prodname_dotcom %} 合作伙伴的特惠和福利。' redirect_from: - /github/teaching-and-learning-with-github-education/applying-for-a-student-developer-pack @@ -18,7 +18,7 @@ versions: - 拥有 [{% data variables.product.prodname_dotcom %} 用户帐户](/articles/signing-up-for-a-new-github-account) - 至少年满 13 岁 -证明您现任学生身份的文件包括学校 ID 照看、班级课程表、成绩单和归属或入学签到函。 +证明您现任学生身份的文件包括具有当前注册日期的学校 ID 照片、班级课程表、成绩单以及附属关系或入学签到函。 在作为学生期间，可能会提示您定期重新验证目前的学业身份。 diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md index 1e5adc727de2..56dd33ae891d 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount.md @@ -1,5 +1,5 @@ --- -title: Apply for an educator or researcher discount +title: 申请教育者或研究人员折扣 intro: '如果您是教育者或研究人员，可以为组织申请免费获取 {% data variables.product.prodname_team %}。' redirect_from: - /github/teaching-and-learning-with-github-education/applying-for-an-educator-or-researcher-discount @@ -18,7 +18,7 @@ versions: {% data reusables.education.educator-requirements %} -For more information about user accounts on {% data variables.product.product_name %}, see "[Signing up for a new {% data variables.product.prodname_dotcom %} account](/github/getting-started-with-github/signing-up-for-a-new-github-account)." +有关在 {% data variables.product.product_name %} 上创建用户帐户的更多信息，请参阅“[注册新 {% data variables.product.prodname_dotcom %} 帐户](/github/getting-started-with-github/signing-up-for-a-new-github-account)”。 ### 申请教育者或研究人员折扣 diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/index.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/index.md index 5f1195a3a865..9e73428b8755 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/index.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/index.md @@ -1,7 +1,7 @@ --- -title: Explore the benefits of teaching and learning with GitHub Education -shortTitle: Teach and learn -intro: Learn how {% data variables.product.prodname_education %} can benefit your classroom, schoolwork, or research and how to apply for free access to various developer tools from {% data variables.product.company_short %}'s partners. +title: 探索通过 GitHub Education 教学和学习的好处 +shortTitle: 教学和学习 +intro: 了解 {% data variables.product.prodname_education %} 如何使您的课堂、功课或研究受益，以及如何申请免费使用 {% data variables.product.company_short %} 合作伙伴的各种开发工具。 redirect_from: - /education/teach-and-learn-with-github-education - /github/teaching-and-learning-with-github-education diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md index 4bb3204f8f49..e99625716854 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-at-your-educational-institution.md @@ -1,5 +1,5 @@ --- -title: Use GitHub at your educational institution +title: 在教育机构使用 GitHub intro: '通过 {% data variables.product.prodname_education %} 以及我们针对学生和讲师的各种培训计划，利用 {% data variables.product.prodname_dotcom %} 使您机构的学生、讲师和 IT 员工最大限度地获益。' mapTopic: true redirect_from: diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md index ab86a34b17d2..b42ab59c0a18 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-for-your-schoolwork.md @@ -1,5 +1,5 @@ --- -title: Use GitHub for your schoolwork +title: 使用 GitHub 做功课 intro: '作为学生，使用 {% data variables.product.prodname_dotcom %} 在您的学校项目上协作，并构建真实世界的体验。' mapTopic: true redirect_from: diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md index a6428c692293..ffa4ddaf5150 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/use-github-in-your-classroom-and-research.md @@ -1,5 +1,5 @@ --- -title: Use GitHub in your classroom and research +title: 在课堂上和研究中使用 GitHub intro: '作为教育工作者或研究人员，使用 {% data variables.product.prodname_dotcom %} 在课堂上、学生或研究小组中协作完成您的工作等等。' mapTopic: true redirect_from: diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md index eeb5d45ca8fa..b8962aabaf8d 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-a-student-developer-pack-approved.md @@ -56,7 +56,7 @@ versions: ### 学生身份不合格 以下情况时，您没有资格获得 {% data variables.product.prodname_student_pack %}： -- You're enrolled in an informal learning program that is not part of the [{% data variables.product.prodname_dotcom %} Campus Program](https://education.github.com/schools) and not enrolled in a degree or diploma granting course of study. +- 您已注册参加不属于 [{% data variables.product.prodname_dotcom %} 校园计划](https://education.github.com/schools)的非正式学习计划，但未注册参加授予学位或文凭的学习课程。 - 您未满 13 岁。 您的讲师仍可申请 {% data variables.product.prodname_education %} 折扣供课堂使用。 如果您是编程学校或训练营的学生，并且您的学校参加 [{% data variables.product.prodname_dotcom %} 校园计划](https://education.github.com/schools)，您将有资格获得 {% data variables.product.prodname_student_pack %}。 @@ -64,4 +64,4 @@ versions: ### 延伸阅读 - “[申请学生开发包](/articles/applying-for-a-student-developer-pack)” -- "[Apply for a student developer pack](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)" +- “[申请学生开发包](/education/teach-and-learn-with-github-education/apply-for-a-student-developer-pack)” diff --git a/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md b/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md index 4bc4faeaa9b9..7e0c2008ee30 100644 --- a/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md +++ b/translations/zh-CN/content/education/teach-and-learn-with-github-education/why-wasnt-my-application-for-an-educator-or-researcher-discount-approved.md @@ -42,4 +42,4 @@ versions: ### 延伸阅读 -- "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)" +- “[申请教育工作者或研究人员折扣](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)” 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 d8901c8ab780..58eea3005e02 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 @@ -11,12 +11,16 @@ versions: github-ae: '*' --- +### 关于受保护分支 + {% data reusables.pull_requests.about-protected-branches %} 您可以选择对拉取请求如何合并到存储库中实施限制。 仓库所有者以及对仓库具有管理员权限的用户可以实施特定的工作流程或要求，然后协作者才可创建受保护的分支规则来合并仓库中的分支。 {% data reusables.repositories.branch-rules-example %} 更多信息请参阅“[配置受保护分支](/articles/configuring-protected-branches/)”。 +{% data reusables.pull_requests.you-can-auto-merge %} + ### 排列受保护分支规则的优先级 如果仓库有多个影响相同分支的受保护分支规则，则包含特定分支名称的规则具有最高优先级。 如果有多个受保护分支规则引用相同的特定规则名称，则最先创建的分支规则优先级更高。 diff --git a/translations/zh-CN/content/github/administering-a-repository/configuring-pull-request-merges.md b/translations/zh-CN/content/github/administering-a-repository/configuring-pull-request-merges.md index bb6608a6e8b7..67e317bb5999 100644 --- a/translations/zh-CN/content/github/administering-a-repository/configuring-pull-request-merges.md +++ b/translations/zh-CN/content/github/administering-a-repository/configuring-pull-request-merges.md @@ -1,6 +1,6 @@ --- title: 配置拉取请求合并 -intro: '您可以在 {% data variables.product.product_location %} 上配置拉取请求合并以匹配工作流程和管理 Git 历史记录的首选项，配置方法包括对仓库中的所有拉取请求启用、禁用或实施标准合并提交、压缩提交或变基提交。' +intro: '您可以在 {% data variables.product.product_location %} 上配置拉取请求合并，以匹配您的工作流程和用于管理 Git 历史记录的首选项。' mapTopic: true redirect_from: - /articles/configuring-pull-request-merges 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 1d43ba47ec17..e0e53b9b3d50 100644 --- a/translations/zh-CN/content/github/administering-a-repository/index.md +++ b/translations/zh-CN/content/github/administering-a-repository/index.md @@ -39,6 +39,7 @@ versions: {% link_in_list /about-merge-methods-on-github %} {% link_in_list /configuring-commit-squashing-for-pull-requests %} {% link_in_list /configuring-commit-rebasing-for-pull-requests %} + {% link_in_list /managing-auto-merge-for-pull-requests-in-your-repository %} {% link_in_list /managing-the-automatic-deletion-of-branches %} {% topic_link_in_list /defining-the-mergeability-of-pull-requests %} {% link_in_list /about-protected-branches %} diff --git a/translations/zh-CN/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md b/translations/zh-CN/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md new file mode 100644 index 000000000000..e19203c0666a --- /dev/null +++ b/translations/zh-CN/content/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository.md @@ -0,0 +1,16 @@ +--- +title: Managing auto-merge for pull requests in your repository +intro: "You can allow or disallow auto-merge for pull requests in your repository." +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +permissions: People with maintainer permissions can manage auto-merge for pull requests in a repository. +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +If you allow auto-merge for pull requests in your repository, people can configure individual pull requests in the repository to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +1. Under "Merge button", select or deselect **Allow auto-merge**. ![Checkbox to allow or disallow auto-merge](/assets/images/help/pull_requests/allow-auto-merge-checkbox.png) \ No newline at end of file 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 bd44d84f575c..0c4fe76debb3 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 @@ -38,7 +38,7 @@ versions: *范围*是 {% data variables.product.prodname_oauth_app %} 可以申请访问公共及非公共数据的权限组。 -当您想使用集成了 {% data variables.product.product_name %} 的 {% data variables.product.prodname_oauth_app %} 时，该应用程序可让您了解需要的数据访问权限类型。 如果您授予应用程序访问权限，则应用程序将能代您执行操作，例如读取或修改数据。 例如，如果您要使用申请 `user:email` 范围的应用程序，则该应用程序对您的私有电子邮件地址具有只读权限。 更多信息请参阅“[关于 {% data variables.product.prodname_oauth_app %} 的范围](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)”。 +当您想使用集成了 {% data variables.product.product_name %} 的 {% data variables.product.prodname_oauth_app %} 时，该应用程序可让您了解需要的数据访问权限类型。 如果您授予应用程序访问权限，则应用程序将能代您执行操作，例如读取或修改数据。 例如，如果您要使用申请 `user:email` 范围的应用程序，则该应用程序对您的私有电子邮件地址具有只读权限。 更多信息请参阅“[关于 {% data variables.product.prodname_oauth_app %} 的范围](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)”。 {% tip %} 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 a6d0f4b3f1c5..246644f4d138 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 @@ -32,7 +32,7 @@ versions: *范围*是应用程序可以申请访问公共及非公共数据的权限组。 -要使用集成了 {% data variables.product.product_name %} 的第三方应用程序时，该应用程序会让您了解需要的数据访问权限类型。 如果您授予应用程序访问权限，则应用程序将能代您执行操作，例如读取或修改数据。 例如，如果您要使用申请 `user:email` 范围的应用程序，则该应用程序对您的私有电子邮件地址具有只读权限。 更多信息请参阅“[关于 {% data variables.product.prodname_oauth_app %} 的范围](//apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)”。 +要使用集成了 {% data variables.product.product_name %} 的第三方应用程序时，该应用程序会让您了解需要的数据访问权限类型。 如果您授予应用程序访问权限，则应用程序将能代您执行操作，例如读取或修改数据。 例如，如果您要使用申请 `user:email` 范围的应用程序，则该应用程序对您的私有电子邮件地址具有只读权限。 更多信息请参阅“[关于 {% data variables.product.prodname_oauth_app %} 的范围](/apps/building-integrations/setting-up-and-registering-oauth-apps/about-scopes-for-oauth-apps)”。 {% tip %} 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 27ef9367e915..5f4688cbc8fa 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 @@ -126,8 +126,8 @@ versions: 1. 确保 ssh-agent 正在运行。 您可以根据“[使用 SSH 密钥密码](/articles/working-with-ssh-key-passphrases)”中的“自动启动 ssh-agent”说明，或者手动启动它： ```shell - # 在后台启动 ssh-agent - $ eval $(ssh-agent -s) + # start the ssh-agent in the background + $ eval `ssh-agent -s` > Agent pid 59566 ``` diff --git a/translations/zh-CN/content/github/authenticating-to-github/testing-your-ssh-connection.md b/translations/zh-CN/content/github/authenticating-to-github/testing-your-ssh-connection.md index 4e5a652647de..8d156940eb71 100644 --- a/translations/zh-CN/content/github/authenticating-to-github/testing-your-ssh-connection.md +++ b/translations/zh-CN/content/github/authenticating-to-github/testing-your-ssh-connection.md @@ -31,7 +31,7 @@ versions: > Are you sure you want to continue connecting (yes/no)? ``` -3. 验证您看到的消息中的指纹匹配步骤 2 中的消息之一，然后输入 `yes`： +3. Verify that the fingerprint in the message you see matches {% if currentVersion == "free-pro-team@latest" %}[{% data variables.product.prodname_dotcom %}'s RSA public key fingerprint](/github/authenticating-to-github/githubs-ssh-key-fingerprints){% else %} your enterprise's public key fingerprint{% endif %}. If it does, then type `yes`: ```shell > Hi username! You've successfully authenticated, but GitHub does not > provide shell access. diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md new file mode 100644 index 000000000000..8780a5135e6d --- /dev/null +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request.md @@ -0,0 +1,38 @@ +--- +title: Automatically merging a pull request +intro: 'You can increase development velocity by enabling auto-merge for a pull request so that the pull request will merge automatically when all merge requirements are met.' +product: '{% data reusables.gated-features.auto-merge %}' +versions: + free-pro-team: '*' +--- + +{% data reusables.pull_requests.auto-merge-release-phase %} + +### About auto-merge + +If you enable auto-merge for a pull request, the pull request will merge automatically when all required reviews are met and status checks have passed. Auto-merge prevents you from waiting around for requirements to be met, so you can move on to other tasks. + +Before you can use auto-merge with a pull request, auto-merge must be enabled for the repository. For more information, see "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)." + +You can provide feedback about auto-merge by [contacting us](https://support.github.com/contact/feedback?category=prs-and-code-review&subject=Pull%20request%20auto-merge%20feedback). + +### Enabling auto-merge + +People with write permissions to a repository can enable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to auto-merge. +1. Optionally, to choose a merge method, select the **Enable auto-merge** drop-down menu, then click a merge method. 更多信息请参阅“[关于拉取请求合并](/github/collaborating-with-issues-and-pull-requests/about-pull-request-merges)”。 !["Enable auto-merge" drop-down menu](/assets/images/help/pull_requests/enable-auto-merge-drop-down.png) +1. Click **Enable auto-merge**. ![Button to enable auto-merge](/assets/images/help/pull_requests/enable-auto-merge-button.png) +1. If you chose the merge or squash and merge methods, type a commit message and description and choose the email address you want to author the merge commit. ![Fields to enter commit message and description and choose commit author email](/assets/images/help/pull_requests/pull-request-information-fields.png) +1. Click **Confirm auto-merge**. ![Button to confirm auto-merge](/assets/images/help/pull_requests/confirm-auto-merge-button.png) + +### Disabling auto-merge + +People with write permissions to a repository and pull request authors can disable auto-merge for a pull request. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-pr %} +1. In the "Pull Requests" list, click the pull request you'd like to disable auto-merge for. +1. In the merge box, click **Disable auto-merge**. ![Button to disable auto-merge](/assets/images/help/pull_requests/disable-auto-merge-button.png) diff --git a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/index.md b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/index.md index 02c1e31e27c9..6857ab5cf1e6 100644 --- a/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/index.md +++ b/translations/zh-CN/content/github/collaborating-with-issues-and-pull-requests/index.md @@ -60,5 +60,6 @@ versions: {% topic_link_in_list /incorporating-changes-from-a-pull-request %} {% link_in_list /about-pull-request-merges %} {% link_in_list /merging-a-pull-request %} + {% link_in_list /automatically-merging-a-pull-request %} {% link_in_list /closing-a-pull-request %} {% link_in_list /reverting-a-pull-request %} 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 8fd56fd6ca0d..095fb8ad8e93 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 @@ -14,6 +14,8 @@ versions: 在拉取请求中，您提议将您对头部分支所做的更改合并到基础分支。 {% data reusables.pull_requests.about-protected-branches %} 但是，对于何时可以将拉取请求合并到特定分支可能会有限制。 例如，如果必需状态检查通过，您可能只能将拉取请求合并到默认分支。 更多信息请参阅“[关于受保护分支](/github/administering-a-repository/about-protected-branches)”。 +{% data reusables.pull_requests.you-can-auto-merge %} + 如果拉取请求具有合并冲突，或者您在测试前想测试更改，可以[本地检出拉取请求](/articles/checking-out-pull-requests-locally)，然后使用命令行合并。 无法合并草稿拉取请求。 有关拉取请求草稿的更多信息，请参阅“[关于拉取请求](/articles/about-pull-requests#draft-pull-requests)”。 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 309effd0a63c..d11a128b1c2e 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 @@ -296,7 +296,7 @@ You can quickly analyze small portions of a monorepo when you modify code in spe ### Accessing private repositories -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)." +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 `ghost/foo`, `ghost/bar`, and `ghost/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. 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 index 8877def3a2c6..cbaa80d55181 100644 --- 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 @@ -54,14 +54,8 @@ You should call the {% data variables.product.prodname_codeql_runner %} from the 下载 {% data variables.product.prodname_codeql_runner %} 并确认它可执行后，应将运行器提供给您打算用于 {% data variables.product.prodname_code_scanning %} 的每个 CI 服务器。 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 -$ /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". +wget https://github.com/github/codeql-action/releases/latest/download/codeql-runner-linux +chmod +x codeql-runner-linux ``` 除此之外，每个 CI 服务器还需要： @@ -88,7 +82,7 @@ $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 您可以配置 {% data variables.product.prodname_codeql_runner %} 存储 CodeQL 包的位置以便将来在服务器上进行分析，使用： `--tools-dir` 标志；并配置在分析过程中存储临时文件的位置，使用： `--temp-dir`. -要查看运行器的命令行引用，请使用 `-h` 标志。 例如，要列出所有运行的命令：`codeql-runner-OS -h`，或列出所有可用于 `init` 命令运行的标志：`codeql-runner-OS init -h`（其中 `OS` 因使用的可执行文件而异）。 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)." +要查看运行器的命令行引用，请使用 `-h` 标志。 例如，要列出所有运行的命令：`codeql-runner-OS -h`，或列出所有可用于 `init` 命令运行的标志：`codeql-runner-OS init -h`（其中 `OS` 因使用的可执行文件而异）。 更多信息请参阅“[在 CI 系统中配置 {% data variables.product.prodname_code_scanning %}](/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-codeql-code-scanning-in-your-ci-system#codeql-runner-command-reference)”。 #### 基本示例 @@ -135,7 +129,7 @@ $ /path/to-runner/codeql-runner-linux init --repository octo-org/example-repo-2 > ... > 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 " + Please export these variables to future processes so that CodeQL can monitor the build, for example by running " . /srv/checkout/example-repo-2/codeql-runner/codeql-env.sh". ``` diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md index 03831496b1c0..9eea6bed5f87 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/about-managing-vulnerable-dependencies.md @@ -14,7 +14,7 @@ versions: By checking the dependency reviews on pull requests you can avoid introducing vulnerabilities from dependencies into your codebase. If the pull requests adds a vulnerable dependency, or changes a dependency to a vulnerable version, this is highlighted in the dependency review. You can change the dependency to a patched version before merging the pull request. For more information, see "[Reviewing dependency changes in a pull request](/github/collaborating-with-issues-and-pull-requests/reviewing-dependency-changes-in-a-pull-request)." #### {% data variables.product.prodname_dependabot_alerts %} -{% data variables.product.prodname_dotcom %} can create {% data variables.product.prodname_dependabot_alerts %} when it detects vulnerable dependencies in your repository. The alert is displayed on the Security tab for the repository. The alert includes a link to the affected file in the project, and information about a fixed version. {% data variables.product.prodname_dotcom %} also notifies the maintainers of the repository, according to their notification preferences. 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 +{% data variables.product.prodname_dotcom %} can create {% data variables.product.prodname_dependabot_alerts %} when it detects vulnerable dependencies in your repository. The alert is displayed on the Security tab for the repository. 该警报包括指向项目中受影响的文件的链接，以及有关修复的版本的信息。 {% data variables.product.prodname_dotcom %} also notifies the maintainers of the repository, according to their notification preferences. 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 #### {% data variables.product.prodname_dependabot_security_updates %} When {% data variables.product.prodname_dotcom %} generates a {% data variables.product.prodname_dependabot %} alert for a vulnerable dependency in your repository, {% data variables.product.prodname_dependabot %} can automatically try to fix it for you. {% data variables.product.prodname_dependabot_security_updates %} are automatically generated pull requests that update a vulnerable dependency to a fixed version. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." 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 cddb25cdc190..62c0bcbe5920 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 @@ -1,7 +1,7 @@ --- title: 浏览 GitHub Advisory Database 中的安全漏洞 intro: '{% data variables.product.prodname_advisory_database %} 允许您浏览或搜索影响 {% data variables.product.company_short %} 上开源项目的漏洞。' -shortTitle: Browsing the Advisory Database +shortTitle: 浏览公告数据库 versions: free-pro-team: '*' --- diff --git a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md b/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md index 07be6ef21b53..b5d8bbad1f90 100644 --- a/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md +++ b/translations/zh-CN/content/github/managing-security-vulnerabilities/configuring-dependabot-security-updates.md @@ -1,7 +1,7 @@ --- -title: Configuring Dependabot security updates +title: 配置 Dependabot 安全更新 intro: '您可以使用 {% data variables.product.prodname_dependabot_security_updates %} 或手动拉取请求轻松地更新有漏洞的依赖项。' -shortTitle: Configuring Dependabot security updates +shortTitle: 配置 Dependabot 安全更新 redirect_from: - /articles/configuring-automated-security-fixes - /github/managing-security-vulnerabilities/configuring-automated-security-fixes @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -### About configuring {% data variables.product.prodname_dependabot_security_updates %} +### 关于配置 {% data variables.product.prodname_dependabot_security_updates %} You can enable {% data variables.product.prodname_dependabot_security_updates %} for any repository that uses {% data variables.product.prodname_dependabot_alerts %} and the dependency graph. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." 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 81083d1f3959..848a7a97b880 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: '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.' +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 %}。' mapTopic: true redirect_from: - /articles/updating-your-project-s-dependencies/ 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 442fd513ab15..ec4bfe7a52e0 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,7 +1,7 @@ --- title: 漏洞依赖项检测疑难解答 intro: '如果 {% data variables.product.product_name %} 报告的依赖项信息不符合您的预期，则需要考虑许多因素，您可以检查各种问题。' -shortTitle: Troubleshooting detection +shortTitle: 检测故障排除 versions: free-pro-team: '*' --- @@ -14,14 +14,14 @@ versions: * {% 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 %} 扫描对包含清单文件的默认分支的任何推送。 添加新的漏洞记录时，它会扫描所有现有仓库，并为每个存在漏洞的仓库生成警报。 {% data variables.product.prodname_dependabot_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 an alert about a vulnerable dependency in your repository. Where possible, {% data variables.product.prodname_dependabot %} creates a pull request in your repository to upgrade the vulnerable dependency to the minimum possible secure version needed to avoid the vulnerability. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)" and "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)." +* {% data variables.product.prodname_dependabot %} 扫描对包含清单文件的默认分支的任何推送。 添加新的漏洞记录时，它会扫描所有现有仓库，并为每个存在漏洞的仓库生成警报。 {% data variables.product.prodname_dependabot_alerts %} 在仓库级别汇总，而不是针对每个漏洞创建一个警报。 更多信息请参阅“[关于易受攻击的依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)”。 +* {% data variables.product.prodname_dependabot_security_updates %} 在您收到关于仓库中漏洞依赖项的警报时触发。 在可能的情况下，{% data variables.product.prodname_dependabot %} 会在您的仓库中创建拉取请求，以将易受攻击的依赖项升级到避免漏洞所需的最低安全版本。 更多信息请参阅“[关于 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)”和“[排除 {% data variables.product.prodname_dependabot %} 错误](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)”。 - {% data variables.product.prodname_dependabot %} doesn't scan repositories for vulnerable dependencies on a schedule, but rather when something changes. 例如，当新的依赖项被添加到 {% data variables.product.prodname_dotcom %} 时（对于每次推送都会进行此项检查），或者当新的漏洞被发现并添加到通告数据库时，就会触发扫描。 + {% data variables.product.prodname_dependabot %} 不会按计划扫描仓库中的漏洞依赖项，而是在发生某些变更时扫描。 例如，当新的依赖项被添加到 {% data variables.product.prodname_dotcom %} 时（对于每次推送都会进行此项检查），或者当新的漏洞被发现并添加到通告数据库时，就会触发扫描。 ### 为什么我没有收到某些生态系统的漏洞警报？ -{% data variables.product.prodname_dotcom %} 对漏洞警报的支持限于一组可提供高质量、可操作数据的生态系统。 Curated vulnerabilities in the {% data variables.product.prodname_advisory_database %}, the dependency graph, {% data variables.product.prodname_dependabot_alerts %}, and {% data variables.product.prodname_dependabot %} 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. 我们将在今后继续增加对更多生态系统的支持。 有关我们支持的包生态系统的概述，请参阅“[关于依赖项图](/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_alerts %} 和 {% data variables.product.prodname_dependabot %} 安全更新等功能适用于多个生态系统，包括 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)”。 值得注意的是，[{% data variables.product.prodname_dotcom %} 安全通告](/github/managing-security-vulnerabilities/about-github-security-advisories)可能存在于其他生态系统中。 安全通告中的信息由特定仓库的维护员提供。 此数据的整理方式与支持的生态系统整理信息的方式不同。 @@ -31,7 +31,7 @@ versions: 依赖项图包含在环境中明确声明的依赖项的信息。 也就是说，在清单或锁定文件中指定的依赖项。 依赖项图通常还包括过渡依赖项，即使它们没有在锁定文件中指定，也可以通过查看清单文件中的依赖项来实现。 -{% data variables.product.prodname_dependabot_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 %} 安全更新仅在可直接“修复”依赖项的情况下建议更改，即，在以下情况下： +{% data variables.product.prodname_dependabot_alerts %} 提醒您应更新的依赖项，包括可从清单或锁定文件确定版本的过渡依赖项。 {% data variables.product.prodname_dependabot %} 安全更新仅在可直接“修复”依赖项的情况下建议更改，即，在以下情况下： * 在清单或锁定文件中明确声明的直接依赖项 * 在锁定文件中声明的过渡依赖项 @@ -51,17 +51,17 @@ versions: 1. **处理限制** - These affect the dependency graph displayed within {% data variables.product.prodname_dotcom %} and also prevent {% data variables.product.prodname_dependabot_alerts %} being created. + 这会影响 {% data variables.product.prodname_dotcom %} 中显示的依赖项图，还会阻止 {% data variables.product.prodname_dependabot_alerts %} 的创建。 - 仅为企业帐户处理大小超过 0.5 MB 的清单。 For other accounts, manifests over 0.5 MB are ignored and will not create {% data variables.product.prodname_dependabot_alerts %}. + 仅为企业帐户处理大小超过 0.5 MB 的清单。 对于其他帐户，将忽略超过 0.5 MB 的清单，并且不会创建 {% data variables.product.prodname_dependabot_alerts %}。 - 默认情况下， {% data variables.product.prodname_dotcom %} 对每个仓库处理的清单不会超过 20 个。 {% data variables.product.prodname_dependabot_alerts %} are not be created for manifests beyond this limit. 如果您需要提高限值，请联系 {% data variables.contact.contact_support %}。 + 默认情况下， {% data variables.product.prodname_dotcom %} 对每个仓库处理的清单不会超过 20 个。 对于超出此限制的清单，不会创建 {% data variables.product.prodname_dependabot_alerts %}。 如果您需要提高限值，请联系 {% data variables.contact.contact_support %}。 2. **可视化限制** - 这会影响 {% data variables.product.prodname_dotcom %} 中依赖项图的显示内容。 However, they don't affect the {% data variables.product.prodname_dependabot_alerts %} that are created. + 这会影响 {% data variables.product.prodname_dotcom %} 中依赖项图的显示内容。 但是，它们不会影响 {% data variables.product.prodname_dependabot_alerts %} 的创建。 - 仓库依赖项图的依赖项视图只显示 100 个清单。 通常这就足够了，因为它明显高于上述处理限制。 In situations where the processing limit is over 100, {% data variables.product.prodname_dependabot_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_alerts %}。 **检查**：在超过 0.5 MB 的清单文件或包含大量清单的仓库中是否存在缺少的依赖项？ @@ -83,9 +83,9 @@ versions: 当一个依赖项有多个漏洞时，只会为该依赖项生成一个汇总警报，而不是针对每个漏洞生成一个警报。 -The {% data variables.product.prodname_dependabot_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_alerts %} 计数显示警报总数，即有漏洞的依赖项数量，而不是漏洞的数量。 -![{% data variables.product.prodname_dependabot_alerts %} view](/assets/images/help/repository/dependabot-alerts-view.png) +![{% data variables.product.prodname_dependabot_alerts %} 视图](/assets/images/help/repository/dependabot-alerts-view.png) 单击以显示警报详细信息时，您可以查看警报中包含多少个漏洞。 @@ -98,4 +98,4 @@ The {% data variables.product.prodname_dependabot_alerts %} count in {% data var - “[关于有易受攻击依赖项的警报](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)” - "[查看和更新仓库中的漏洞依赖项](/github/managing-security-vulnerabilities/viewing-and-updating-vulnerable-dependencies-in-your-repository)" - "[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" -- "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)" +- [排除 {% data variables.product.prodname_dependabot %} 错误](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)" 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 eb9553f27e2b..339016b8eab4 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 @@ -17,7 +17,7 @@ versions: ### 关于仓库中有漏洞的依赖项的更新 -{% data variables.product.product_name %} generates {% data variables.product.prodname_dependabot_alerts %} when we detect that your codebase is using dependencies with known vulnerabilities. For repositories where {% data variables.product.prodname_dependabot_security_updates %} are enabled, when {% data variables.product.product_name %} detects a vulnerable dependency in the default branch, {% data variables.product.prodname_dependabot %} creates a pull request to fix it. 拉取请求会将依赖项升级到避免漏洞所需的最低安全版本。 +{% data variables.product.product_name %} 在检测到您的代码库正在使用具有已知漏洞的依赖项时会生成 {% data variables.product.prodname_dependabot_alerts %}。 对于启用了 {% data variables.product.prodname_dependabot_security_updates %} 的仓库，当 {% data variables.product.product_name %} 在默认分支中检测到有漏洞的依赖项时，{% data variables.product.prodname_dependabot %} 会创建拉取请求来修复它。 拉取请求会将依赖项升级到避免漏洞所需的最低安全版本。 ### 查看和更新有漏洞的依赖项 @@ -36,4 +36,4 @@ versions: - "[配置 {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/configuring-dependabot-security-updates)" - "[管理仓库的安全和分析设置](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)" - "[漏洞依赖项检测疑难解答](/github/managing-security-vulnerabilities/troubleshooting-the-detection-of-vulnerable-dependencies)" -- "[Troubleshooting {% data variables.product.prodname_dependabot %} errors](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)" +- [排除 {% data variables.product.prodname_dependabot %} 错误](/github/managing-security-vulnerabilities/troubleshooting-dependabot-errors)" 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 3a76cf39214e..be621ae2689d 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 @@ -22,7 +22,7 @@ versions: - 仓库或团队讨论中的所有活动。 - CI 活动，例如仓库中使用 {% data variables.product.prodname_actions %} 设置的工作流程的状态。 {% if currentVersion == "free-pro-team@latest" %} -- Issues, pulls requests, releases and discussions (if enabled) in a repository. +- 仓库中的议题、提取请求、发行版和讨论（如有启用）。 {% endif %} {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} - 仓库中的发行版。 @@ -50,7 +50,7 @@ versions: ### 自定义通知和订阅 -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. +您可以选择通过 [https://github.com/notifications](https://github.com/notifications){% if currentVersion == "free-pro-team@latest" %} 上和 {% data variables.product.prodname_mobile %} 应用程序{% endif %}中的通知收件箱、电子邮件或这些选项的某些组合来查看通知。 要自定义您希望接收的更新类型以及将这些更新发送至何处，请配置通知设置。 更多信息请参阅“[配置通知](/github/managing-subscriptions-and-notifications-on-github/configuring-notifications)”。 @@ -59,8 +59,8 @@ You can choose to view your notifications through the notifications inbox at [ht 要自定义如何接收特定拉取请求或议题的更新，可以在议题或拉取请求中配置首选项。 更多信息请参阅“[对单个通知进行分类](/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. 更多信息请参阅“[配置通知](/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)”。 {% endif %} ### 接收通知的原因 @@ -89,7 +89,7 @@ You can enable push notifications in the ### 自定义通知收件箱 -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)”。 +要在 {% 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)”。 ### 通知保留策略 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 0898413f48ff..d5cd29ac6ca9 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 @@ -21,11 +21,11 @@ versions: ### 通知递送选项 -You can receive notifications for activity on {% data variables.product.product_name %} in the following locations. +您可以在以下位置的 {% data variables.product.product_name %} 上接收活动的通知。 - - The notifications inbox in the {% data variables.product.product_name %} web interface{% 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 %} + - {% data variables.product.product_name %} Web 界面{% if currentversion == "free-pro-team@latest" %}中的通知收件箱 + - {% data variables.product.prodname_mobile %} 上的通知收件箱，它与 {% data variables.product.product_name %} 上的收件箱同步{% endif %} + - 使用经验证电子邮件地址的电子邮件客户端，也可以与 {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} 及 {% data variables.product.prodname_mobile %}{% endif %} 上的通知收件箱同步 {% if currentVersion == "free-pro-team@latest" %} {% data reusables.notifications-v2.notifications-inbox-required-setting %} 更多信息请参阅“[选择通知设置](#choosing-your-notification-settings)”。 @@ -35,7 +35,7 @@ You can receive notifications for activity on {% data variables.product.product_ #### 通知收件箱的优点 -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: +{% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} 和 {% data variables.product.prodname_mobile %}{% endif %} 上的通知收件箱包含专为您的 {% data variables.product.product_name %} 通知流程设计的分类选项，包括： - 一次对多种通知进行分类。 - 将已完成的通知标记为**完成**并从收件箱中删除它们。 要查看标记为**完成**的所有通知，请使用 `is:done` 查询。 - 保存通知以供以后查看。 保存的通知将在收件箱中标记并无限期保留。 要查看所有已保存的通知，请使用 `is:saved` 查询。 @@ -46,8 +46,8 @@ The notifications inbox on {% data variables.product.product_name %}{% if curren - 按仓库或日期对收件箱中的通知进行分组，以快速概览通知，减少上下文切换 {% 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. 更多信息请参阅“[为移动版 GitHub 启用推送通知](#enabling-push-notifications-with-github-for-mobile)”或“[移动版 GitHub](/github/getting-started-with-github/github-for-mobile)”。 +此外， +{% data variables.product.prodname_mobile %} 上的通知收件箱允许您在黑暗模式下对通知进行分类，并接收直接提及的推送通知。 更多信息请参阅“[为移动版 GitHub 启用推送通知](#enabling-push-notifications-with-github-for-mobile)”或“[移动版 GitHub](/github/getting-started-with-github/github-for-mobile)”。 {% endif %} #### 对通知使用电子邮件客户端的优点 @@ -62,22 +62,22 @@ In addition, the notifications inbox on 关注仓库，意味着订阅该仓库中的活动更新。 同样，关注特定团队的讨论，意味着订阅该团队页面上的所有对话更新。 更多信息请参阅“[关于团队讨论](/github/building-a-strong-community/about-team-discussions)”。 -To see repositories that you're watching, go to your [watching page](https://github.com/watching). 更多信息请参阅“[在 GitHub 上管理订阅和通知](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)”。 +要查看您关注的仓库，请参阅[关注页面](https://github.com/watching)。 更多信息请参阅“[在 GitHub 上管理订阅和通知](/github/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github)”。 {% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} #### 配置通知 {% endif %} -You can configure notifications for a repository on the repository page, or on your watching page. -{% if currentVersion == "github-ae@latest" or currentVersion ver_gt "enterprise-server@2.20" %} You can choose to only receive notifications for releases in a repository, or ignore all notifications for a repository.{% endif %}{% if currentVersion == "free-pro-team@latest" %} +您可以在仓库页面上或关注页面上为仓库配置通知。 +{% if currentversion == "github-ae@latest" or currentversion ver_gt "enterprise-server@2. 0" %} 您可以选择仅接收仓库中发布的通知，或忽略仓库的所有通知。{% endif %}{% if currentversion == "free proteam@latest" %} -#### About custom notifications +#### 关于自定义通知 {% data reusables.notifications-v2.custom-notifications-beta %} -You can customize notifications for a repository, for example, you can choose to only be notified when updates to one or more types of events (issues, pull request, releases, discussions) happen within a repository, or ignore all notifications for a repository. -{% endif %} For more information, see "[Viewing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#configuring-your-watch-settings-for-an-individual-repository)." +您可以自定义仓库的通知，例如，您可以选择仅在仓库中发生一类或多类事件（议题、拉取请求、发布、讨论）的更新时收到通知，或者忽略仓库的所有通知。 +{% endif %} 更多信息请参阅“[查看订阅](/github/managing-subscriptions-and-notifications-on-github/viewing-your-subscriptions#configuring-your-watch-settings-for-an-individual-repository)”。 -#### Participating in conversations +#### 参与对话 每当您在对话中发表评论或有人 @提及您的用户名时，您都在_参与_对话。 默认情况下，当您参与对话时，会自动订阅该对话。 您可以通过单击议题或拉取请求上的 **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 %}. +对于您关注或参与的对话，您可以选择是通过电子邮件还是 {% data variables.product.product_name %}{% if currentVersion == "free-pro-team@latest" %} 和 {% data variables.product.prodname_mobile %}{% endif %} 上的收件箱接收通知。 ![参与和关注通知选项](/assets/images/help/notifications-v2/participating-and-watching-options.png) @@ -85,7 +85,7 @@ For conversations you're watching or participating in, you can choose whether yo - 如果您不希望将通知发送到您的电子邮件地址，请取消选中 **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. +如果您未对 Web{% if currentVersion == "free-pro-team@latest" %} 和移动{% endif %} 启用关注或参与通知，则您的通知收件箱不会收到任何更新。 ### 自定义电子邮件通知 @@ -109,9 +109,9 @@ If you do not enable watching or participating notifications for web{% if curren - 拉取请求推送。 - 您自己的更新，例如当您打开、评论或关闭议题或拉取请求时。 -Depending on the organization that owns the repository, you can also send notifications to different email addresses. 您的组织可能要求验证特定域的电子邮件地址。 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)”。 -You can also send notifications for a specific repository to an email address. 更多信息请参阅“[关于推送到仓库的电子邮件通知](/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository)。” +您也可以将特定仓库的通知发送到电子邮件地址。 更多信息请参阅“[关于推送到仓库的电子邮件通知](/github/administering-a-repository/about-email-notifications-for-pushes-to-your-repository)。” {% data reusables.notifications-v2.email-notification-caveats %} @@ -125,8 +125,8 @@ You can also send notifications for a specific repository to an email address. | 标头 | 信息 | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `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` 字段 | This field connects directly to the thread.{% if currentVersion != "github-ae@latest" %} If you reply to the email, you'll add a new comment to the conversation.{% endif %} +| `From` 地址 | 此地址始终是 {% if currentVersion == "free-pro-team@latest" %}'`notifications@github.com`'{% else %}'网站管理员配置的无需回复电子邮件地址'{% endif %}。 | +| `To` 字段 | 此字段直接连接到线程。{% if currentVersion != "github-ae@latest" %} 如果您回复电子邮件，将在对话中添加一个新的评论。{% endif %} | `Cc` 地址 | 如果您订阅了对话，{% data variables.product.product_name %} 将会 `Cc` 给您。 第二个 `Cc` 电子邮件地址与通知原因匹配。 这些通知原因的后缀是 {% data variables.notifications.cc_address %}。 可能的通知原因包括：
    • `assign`：您被分配到议题或拉取请求。
    • `author`：您创建了议题或拉取请求。
    • `comment`：您评论了议题或拉取请求。
    • `manual`：您手动订阅的议题或拉取请求有更新。
    • `mention`：您提及了议题或拉取请求。
    • `push`：有人提交了您订阅的拉取请求。
    • `review_requested`：您或您所在的团队已请求审查拉取请求。
      • {% if currentVersion != "github-ae@latest" %}
    • `security_alert`：{% data variables.product.prodname_dotcom %} 检测到您要接收其漏洞警报的仓库中存在漏洞。
      • {% endif %}
    • `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 %} @@ -137,9 +137,9 @@ You can also send notifications for a specific repository to an email address. {% data reusables.notifications-v2.manage-notifications %} 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" %} + - 您获得了新仓库的访问权限或加入了新团队。 更多信息请参阅“[自动关注](#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 %} 通知选项](#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" %} + - 您的仓库中有新的安全警报。 更多信息请参阅“[安全警报通知选项](#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 %} ### 自动关注 @@ -164,7 +164,7 @@ You can also send notifications for a specific repository to an email address. #### 自定义每个组织的电子邮件路由 -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 currentVersion == "free-pro-team@latest" %} 您已验证的电子邮件地址{% else %}您已添加到 {% data variables.product.product_name %} 帐户的电子邮件地址{% endif %}。 {% if currentVersion == "free-pro-team@latest" %} 更多信息请参阅“[验证电子邮件地址](/articles/verifying-your-email-address)”。{% endif %} {% data reusables.notifications.access_notifications %} {% data reusables.notifications-v2.manage-notifications %} @@ -178,14 +178,14 @@ If you are a member of more than one organization, you can configure each one to {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} ### {% data variables.product.prodname_dependabot_alerts %} 通知选项 {% else %} -### Security alert notification options +### 安全警报通知选项 {% endif %} {% data reusables.notifications.vulnerable-dependency-notification-delivery-method-customization %} {% data reusables.notifications.vulnerable-dependency-notification-options %} -For more information about the notification delivery methods available to you, and advice on optimizing your 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 %}, see "[Configuring notifications for vulnerable dependencies](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)." +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}安全警报{% endif %}通知干扰的信息，请参阅“[配置漏洞依赖项的通知](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)”。 {% endif %} {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %} 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 96f4efcb9e34..2f8865ec2146 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: 'Use your inbox to quickly triage and sync your notifications across email{% if currentVersion == "free-pro-team@latest" %} and mobile{% endif %}.' +intro: '使用收件箱快速分类并在电子邮件{% if currentVersion == "free-pro-team@latest" %} 与手机{% endif %} 之间同步您的通知。' redirect_from: - /articles/marking-notifications-as-read - /articles/saving-notifications-for-later @@ -82,7 +82,7 @@ versions: - 区分 `is:issue`、`is:pr` 及 `is:pull-request` 查询过滤器。 这些查询将返回议题和拉取请求。 - 创建超过 15 个自定义过滤器。 - 更改默认过滤器或其顺序。 - - Search [exclusion](/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results) using `NOT` or `-QUALIFIER`. + - 使用 `NOT` 或 `-QUALIFIER` 进行[排除](/github/searching-for-information-on-github/understanding-the-search-syntax#exclude-certain-results)搜索。 ### 支持的自定义过滤器查询 @@ -97,24 +97,24 @@ versions: 要根据收到更新的原因过滤通知，您可以使用 `reason:` 查询。 例如，要查看当您（或您所属团队）被请求审查拉取请求时的通知，请使用 `reason:review-requested`。 更多信息请参阅“[关于通知](/github/managing-subscriptions-and-notifications-on-github/about-notifications#reasons-for-receiving-notifications)”。 -| 查询 | 描述 | -| ------------------------- | ------------------------------------------------------------------------------------------------------------------ | -| `reason:assign` | 分配给您的议题或拉取请求有更新时。 | -| `reason:author` | 当您打开拉取请求或议题并且有更新或新评论时。 | -| `reason:comment` | 当您评论了议题、拉取请求或团队讨论时。 | -| `reason:participating` | 当您评论了议题、拉取请求或团队讨论或者被@提及时。 | -| `reason:invitation` | 当您被邀请加入团队、组织或仓库时。 | -| `reason:manual` | 当您在尚未订阅的议题或拉取请求上单击 **Subscribe（订阅）**时。 | -| `reason:mention` | 您被直接@提及。 | -| `reason:review-requested` | You or a team you're on have been requested to review a pull request.{% if currentVersion != "github-ae@latest" %} -| `reason:security-alert` | When a security alert is issued for a repository.{% endif %} -| `reason:state-change` | 当拉取请求或议题的状态改变时。 例如，议题已关闭或拉取请求合并时。 | -| `reason:team-mention` | 您所在的团队被@提及时。 | -| `reason:ci-activity` | 当仓库有 CI 更新时，例如新的工作流程运行状态。 | +| 查询 | 描述 | +| ------------------------- | --------------------------------------------------------------- | +| `reason:assign` | 分配给您的议题或拉取请求有更新时。 | +| `reason:author` | 当您打开拉取请求或议题并且有更新或新评论时。 | +| `reason:comment` | 当您评论了议题、拉取请求或团队讨论时。 | +| `reason:participating` | 当您评论了议题、拉取请求或团队讨论或者被@提及时。 | +| `reason:invitation` | 当您被邀请加入团队、组织或仓库时。 | +| `reason:manual` | 当您在尚未订阅的议题或拉取请求上单击 **Subscribe（订阅）**时。 | +| `reason:mention` | 您被直接@提及。 | +| `reason:review-requested` | 您或您所属的团队被请求审查拉取请求。{% if currentVersion != "github-ae@latest" %} +| `reason:security-alert` | 为仓库发出安全警报时。{% endif %} +| `reason:state-change` | 当拉取请求或议题的状态改变时。 例如，议题已关闭或拉取请求合并时。 | +| `reason:team-mention` | 您所在的团队被@提及时。 | +| `reason:ci-activity` | 当仓库有 CI 更新时，例如新的工作流程运行状态。 | #### 支持的 `is:` 查询 -要在 {% data variables.product.product_name %} 上过滤特定活动的通知，您可以使用 `is` 查询。 For example, to only see repository invitation updates, use `is:repository-invitation`{% if currentVersion != "github-ae@latest" %}, and to only see {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %} security{% endif %} alerts, use `is:repository-vulnerability-alert`.{% endif %} +要在 {% data variables.product.product_name %} 上过滤特定活动的通知，您可以使用 `is` 查询。 例如，要仅查看仓库邀请更新，则使用 `is:repository-invitation`{% if currentVersion != "github-ae@latest" %}，要仅查看 {% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot %}{% else %} 安全{% endif %}警报，则使用 `is:repository-vulnerability-alert`。{% endif %} - `is:check-suite` - `is:commit` @@ -128,8 +128,8 @@ versions: - `is:discussions`{% endif %} {% if currentVersion != "github-ae@latest" %} -For information about reducing noise from 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 %}, see "[Configuring notifications for vulnerable dependencies](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)." +有关减少 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" %}{% data variables.product.prodname_dependabot_alerts %}{% else %}安全警报{% endif %}通知干扰的信息，请参阅“[配置漏洞依赖项的通知](/github/managing-security-vulnerabilities/configuring-notifications-for-vulnerable-dependencies)”。 {% endif %} 您还可以使用 `is:` 查询来描述如何对通知进行分类。 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 bc261baf49a5..13c2ce2702e7 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 @@ -11,7 +11,7 @@ versions: {% note %} -**注：**您可以选择忽略仓库，而不取消订阅。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% 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" %}如果您遇到滥用并且想忽略某个仓库，请联系 {% data variables.contact.contact_support %} 获取帮助。 {% data reusables.policies.abuse %}{% endif %} {% endnote %} @@ -39,7 +39,7 @@ versions: {% data reusables.notifications.access_notifications %} 1. 从通知收件箱中选择您想要取消订阅的通知。 -2. Use the **selected** {% octicon "triangle-down" aria-label="The down triangle icon" %} drop-down to click **Unsubscribe.** ![主收件箱中的取消订阅选项](/assets/images/help/notifications-v2/unsubscribe-from-main-inbox.png) +2. 使用 **selected（已选择）** {% octicon "triangle-down" aria-label="The down triangle icon" %} 下拉列表单击 **Unsubscribe（取消订阅）**。 ![主收件箱中的取消订阅选项](/assets/images/help/notifications-v2/unsubscribe-from-main-inbox.png) ### 从订阅页面取消订阅通知 @@ -63,5 +63,5 @@ versions: {% if currentVersion == "free-pro-team@latest" %} - 取消关注仓库 - 忽略某仓库的所有通知 - - customize the types of event you receive notifications for (issues, pull requests, releases or discussions, if enabled) + - 自定义接收通知的事件类型（议题、拉取请求、发布或讨论，如有启用） {% endif %} \ No newline at end of file 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 0f50e7d21519..426e97cbeeb8 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 @@ -36,12 +36,12 @@ To see an overview of your repository subscriptions, see "[Reviewing repositorie {% if currentVersion == "free-pro-team@latest" %} {% tip %} -**Tip:** You can select the types of event to be notified of by using the **Custom** option of the **Watch/Unwatch** dropdown list in your [watching page](https://github.com/watching) or on any repository page on {% data variables.product.prodname_dotcom_the_website %}. For more information, see "[Configuring your watch settings for an individual repository](#configuring-your-watch-settings-for-an-individual-repository)" below. +**提示：**您可以在[关注页面](https://github.com/watching)或 {% data variables.product.prodname_dotcom_the_website %} 上的任何仓库页面，使用 **Watch/Unwatch（关注/取消关注）**下拉列表中的 **Custom（自定义）**选项选择要通知的事件类型。 更多信息请参阅下面的“[配置单个仓库的关注设置](#configuring-your-watch-settings-for-an-individual-repository)”。 {% endtip %} {% endif %} -许多人忘记了他们过去选择关注的仓库。 从“Watched repositories（已关注仓库）”页面，您可以快速取消关注仓库。 For more information on ways to unsubscribe, see "[Unwatch recommendations](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)" on {% data variables.product.prodname_blog %} and "[Managing your subscriptions](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)." You can also create a triage workflow to help with the notifications you receive. For guidance on triage workflows, see "[Customizing a workflow for triaging your notifications](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)." +许多人忘记了他们过去选择关注的仓库。 从“Watched repositories（已关注仓库）”页面，您可以快速取消关注仓库。 有关取消订阅的方式的更多信息，请参阅 {% data variables.product.prodname_blog %} 上的“[取消关注建议](https://github.blog/changelog/2020-11-10-unwatch-recommendations/)”和“[管理订阅](/github/managing-subscriptions-and-notifications-on-github/managing-your-subscriptions)”。 您也可以创建分类工作流程来帮助整理收到的通知。 有关分类工作流程的指导，请参阅“[自定义对通知分类的工作流程](/github/managing-subscriptions-and-notifications-on-github/customizing-a-workflow-for-triaging-your-notifications)”。 ### 查看所有订阅 @@ -74,15 +74,15 @@ To see an overview of your repository subscriptions, see "[Reviewing repositorie {% tip %} - **Tip:** Instead of watching a repository, consider only receiving notifications {% if currentVersion == "free-pro-team@latest" %}when there are updates to issues, pull requests, releases or discussions (if enabled for the repository), or any combination of these options,{% else %}for releases in a repository,{% endif %} or completely unwatching a repository. + **提示：**不关注仓库， 而是考虑仅{% if currentversion == "free-proteam@latest" %}在议题、拉取请求、版本或讨论（如已对仓库启用）或其任何组合有更新时，{% else %}仓库中有发布，{% endif %} 或完全取消关注仓库时才接收通知。 - 取消关注仓库后，当您被@提及或参与帖子时仍然会收到通知。 When you configure to receive notifications for certain event types, you're only notified when there are updates to these event types in the repository, you're participating in a thread, or you or a team you're on is @mentioned. + 取消关注仓库后，当您被@提及或参与帖子时仍然会收到通知。 当您配置接收某些事件类型的通知时，仅在仓库中有这些事件类型的更新、您参与了线程或者您或您所在团队被 @提及时才收到通知。 {% endtip %} ### 配置单个仓库的关注设置 -您可以选择关注还是取消关注单个仓库。 You can also choose to only be notified of {% if currentVersion == "free-pro-team@latest" %}certain event types such as issues, pull requests, discussions (if enabled for the repository) and {% endif %}new releases, or completely ignore an individual repository. +您可以选择关注还是取消关注单个仓库。 您也可以选择接收{% if currentVersion == "free-pro-team@latest" %}特定事件类型，如议题、拉取请求、讨论（如已对仓库启用）以及{% endif %}新版本的通知，或者完全忽略单个仓库。 {% data reusables.repositories.navigate-to-repo %} 2. 在右上角，单击“Watch（关注）”下拉菜单选择关注选项。 @@ -92,10 +92,10 @@ To see an overview of your repository subscriptions, see "[Reviewing repositorie {% if currentVersion == "free-pro-team@latest" %} ![仓库下拉菜单中的关注选项](/assets/images/help/notifications-v2/watch-repository-options-custom.png) {% data reusables.notifications-v2.custom-notifications-beta %} -The **Custom** option allows you to further customize notifications so that you're only notified when specific events happen in the repository, in addition to participating and @mentions. +**Custom（自定义）** 选项可用于进一步自定义通知，以便除了参与和 @提及之外，您仅在仓库中发生特定事件时才收到通知。 - ![Custom watch options in a drop-down menu for a repository](/assets/images/help/notifications-v2/watch-repository-options-custom2.png) + ![仓库下拉菜单中的自定义关注选项](/assets/images/help/notifications-v2/watch-repository-options-custom2.png) -If you select "Issues", you will be notified about, and subscribed to, updates on every issue (including those that existed prior to you selecting this option) in the repository. If you're @mentioned in a pull request in this repository, you'll receive notifications for that too, and you'll be subscribed to updates on that specific pull request, in addition to being notified about issues. +如果选择“Issues（议题）”，您将收到仓库中每个议题（包括在您选择此选项之前存在的议题）的更新通知并订阅它们。 如果您被此仓库中的拉取请求 @提及，则除了收到有关议题的通知外，您还将收到有关该特定拉取请求更新的通知并订阅它们。 {% endif %} 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 8050ab61dc60..cb82f8e3c542 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 @@ -23,15 +23,15 @@ versions: ### 支持的查询参数 -| 查询参数 | 示例 | -| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `正文` | `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。 | +| 查询参数 | 示例 | +| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `正文` | `https://github.com/octo-org/octo-repo/compare/main...pull-request-test?quick_pull=1&body=Fixes+the+problem.` 创建拉取请求，比较分支 `main` 与 `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/main...pull-request-test?quick_pull=1&labels=bug` 创建拉取请求，比较分支 `main` 与 `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。 | ### 使用自定义模板填写议题和拉取请求 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 05b28451a607..c60c408a05c2 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 @@ -31,10 +31,10 @@ versions: ### 项目进度跟踪 -You can track the progress on your project board. Cards in the "To do", "In progress", or "Done" columns count toward the overall project progress. {% data reusables.project-management.project-progress-locations %} +您可以跟踪项目板上的进度。 "To do"（待处理）、"In progress"（进行中）或 "Done"（完成）列中的卡计入总体项目进度。 {% data reusables.project-management.project-progress-locations %} -For more information, see "[Tracking progress on your project board](/github/managing-your-work-on-github/tracking-progress-on-your-project-board)." +更多信息请参阅“[跟踪项目板上的进度](/github/managing-your-work-on-github/tracking-progress-on-your-project-board)”。 ### 延伸阅读 -- "[Configuring automation for project boards](/articles/configuring-automation-for-project-boards)"{% if currentVersion == "free-pro-team@latest" %} +- “[配置项目板的自动化](/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 1c14a9bbb22b..d854252bf9c2 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 @@ -14,7 +14,7 @@ versions: 您可以在仓库中使用议题收集用户反馈，报告软件漏洞，并且组织要完成的任务。 议题不只是一个报告软件漏洞的地方。 -Other conversations are more suitable for discussions. {% data reusables.discussions.you-can-use-discussions %} +其他对话更适合讨论。 {% data reusables.discussions.you-can-use-discussions %} {% data reusables.discussions.you-cannot-convert-a-discussion %} 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 3e0782f53096..266a22ec4c91 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 @@ -60,7 +60,7 @@ versions: ### 延伸阅读 - "[创建项目板](/articles/creating-a-project-board)" -- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} +- “[编辑项目板](/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 912a684a8561..34697350f2c0 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 @@ -55,7 +55,7 @@ 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. Select one or more project boards where you want to add the issue or pull request. ![选择的项目板](/assets/images/help/projects/sidebar-select-project.png) +4. 选择要添加议题或拉取请求的一个或多个项目板。 ![选择的项目板](/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/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 f045777e8ca0..d7768ebc0f7b 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 @@ -11,7 +11,7 @@ versions: 对仓库有写入权限的任何人都可以分配议题和拉取请求。 -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)”。 +每个议题和拉取请求最多可分配给 10 个人，包括您自己、 任何评论了议题或拉取请求的人、任何对仓库有写入权限的人以及对仓库有读取权限的组织成员 。 更多信息请参阅“[{% 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/creating-a-project-board.md b/translations/zh-CN/content/github/managing-your-work-on-github/creating-a-project-board.md index d28df6c9e3ce..3aeca6a1431f 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 @@ -83,7 +83,7 @@ versions: ### 延伸阅读 - "[关于项目板](/articles/about-project-boards)" -- "[Editing a project board](/articles/editing-a-project-board)"{% if currentVersion == "free-pro-team@latest" %} +- “[编辑项目板](/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 3e06c4df51a2..b816018813e8 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,7 +1,7 @@ --- title: 创建议题 intro: '议题可用于跟踪漏洞、增强功能或其他请求。' -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: '具有读取权限的人可以在启用了议题的仓库中创建议题。' redirect_from: - /articles/creating-an-issue versions: 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 a942893a8db1..6ede1368a7a8 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 @@ -18,9 +18,9 @@ versions: {% if currentVersion == "free-pro-team@latest" %} {% tip %} -Please contact +请联系 -{% data variables.contact.contact_support %} if you want to turn off issues because of abuse from strangers. +{% data variables.contact.contact_support %}，如果因陌生人滥用而需要关闭议题。 {% data reusables.policies.abuse %} {% endtip %} 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 3e7db0dcf438..e29c623db70e 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 @@ -12,7 +12,7 @@ versions: {% warning %} -**警告：**如果您在拉取请求或议题评论中添加了图像，则任何人都可以查看匿名图像 URL，无需身份验证，即使该拉取请求位于私有仓库中{% if enterpriseServerVersions contains currentVersion %}或者启用了私有模式{% endif %}。 要对敏感图像保密，请从需要身份验证的私有网络或服务器提供它们。 {% if currentVersion == "free-pro-team@latest" %}For more information on anonymized URLs see "[About anonymized image URLs](/articles/about-anonymized-image-urls)".{% endif %} +**警告：**如果您在拉取请求或议题评论中添加了图像，则任何人都可以查看匿名图像 URL，无需身份验证，即使该拉取请求位于私有仓库中{% if enterpriseServerVersions contains currentVersion %}或者启用了私有模式{% endif %}。 要对敏感图像保密，请从需要身份验证的私有网络或服务器提供它们。 {% if currentVersion == "free-pro-team@latest" %}有关匿名 URL 的更多信息，请参阅“[关于匿名图像 URL](/articles/about-anonymized-image-urls)”。{% endif %} {% endwarning %} @@ -22,7 +22,7 @@ versions: {% tip %} -**Tip:** In many browsers, you can copy-and-paste images directly into the box. +**提示：**在许多浏览器中，您可以将图像直接复制并粘贴到该框中。 {% endtip %} 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 efadfe82f1ef..3fbcc3e4d555 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 @@ -9,20 +9,20 @@ versions: github-ae: '*' --- -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` 按受理人过滤卡 -- Filter cards by label using `label:LABEL`, `label:"MULTI-WORD LABEL NAME"`, or `no:label` +- 使用 `label:LABEL`、`label:"MULTI-WORD LABEL NAME"` 或 `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` 按状态和类型过滤卡 -- 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" or currentVersion == "github-ae@latest" %} +- 使用 `linked:pr`，按通过结束引用链接到拉取请求的议题过滤卡。{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.20" or currentVersion == "github-ae@latest" %} - 使用 `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 6064c4f7a479..482a4f66da6d 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 @@ -15,7 +15,7 @@ versions: - 如果要使用搜索栏过滤议题和拉取请求，您可以使用里程碑搜索语法。 对于名为 My Milestone 的里程碑，搜索语法为：`milestone:"My Milestone"`。 - 要清除过滤器选择，请单击 **Clear current search query, filters, and sorts（清除当前搜索查询、过滤和排序）**。 -- 还可以使用 {% 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 %} 过滤议题或拉取请求。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的 "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" 或 "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)"。 {% endtip %} 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 40b9445af274..4c283386f055 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: 'You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when the pull request is merged.' +intro: '您可以将拉取请求链接到议题，以显示修复正在进行中，并在合并拉取请求时自动关闭该议题。' redirect_from: - /articles/closing-issues-via-commit-message/ - /articles/closing-issues-via-commit-messages/ diff --git a/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md b/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md index 828cf2b2dbb5..9b171862fd34 100644 --- a/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md +++ b/translations/zh-CN/content/github/managing-your-work-on-github/opening-an-issue-from-a-comment.md @@ -1,7 +1,7 @@ --- title: 从评论打开议题 intro: 您可以从议题或拉取请求中的特定评论行打开新议题。 -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: '具有读取权限的人可以在启用了议题的仓库中创建议题。' versions: free-pro-team: '*' enterprise-server: '*' 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 c8cd2a0f86bc..6d4d7793d2bf 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 @@ -1,7 +1,7 @@ --- title: 从代码打开议题 intro: 您可以从文件或拉取请求的特定代码行打开新议题。 -permissions: 'People with read permissions can create an issue in a repository where issues are enabled.' +permissions: '具有读取权限的人可以在启用了议题的仓库中创建议题。' redirect_from: - /articles/opening-an-issue-from-code versions: 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 24d368664adf..7d30fc693cbb 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 @@ -33,7 +33,7 @@ versions: {% note %} -**注：**您也可以选择忽略仓库。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% 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 %} +**注：**您也可以选择忽略仓库。 如果忽略仓库，将不会收到任何通知。 我们不建议忽略仓库，因为这样您被@提及时将不会收到通知。 {% if currentVersion == "free-pro-team@latest" %}If you experiencing abuse and want to ignore a repository, please contact {% data variables.contact.contact_support %} so we can help. {% data reusables.policies.abuse %}{% endif %} {% endnote %} 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 c67da3691eee..5428cd4ccca9 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 @@ -27,7 +27,8 @@ versions: - 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 个文件的仓库可搜索。 +- Only repositories with fewer than 500,000 files are searchable.{% if currentVersion == "free-pro-team@latest" %} +- Only repositories that have had activity or have been returned in search results in the last year are searchable.{% endif %} - 除了 [`filename`](#search-by-filename) 搜索以外，搜索源代码时必须始终包括至少一个搜索词。 例如，搜索 [`language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=language%3Ajavascript&type=Code&ref=searchresults) 无效，而搜索 [`amazing language:javascript`](https://github.com/search?utf8=%E2%9C%93&q=amazing+language%3Ajavascript&type=Code&ref=searchresults) 有效。 - 搜索结果最多可显示同一文件的两个分段，但文件内可能有更多结果。 - 您无法使用以下通配符作为搜索查询的一部分：. , : ; / \ ` ' " = * ! ? # $ & + ^ | ~ < > ( ) { } [ ]. 搜索只会忽略这些符号。 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 ba9ba67bc106..0bb43e1db2b8 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 @@ -39,6 +39,7 @@ Organization members can have *owner*{% if currentVersion == "free-pro-team@late | 访问组织审核日志 | **X** | | | | 编辑组织的资料页面（详细信息请参阅“[关于组织的资料](/articles/about-your-organization-s-profile)”） | **X** | | | | 验证组织的域（详细信息请参阅“[验证组织的域](/articles/verifying-your-organization-s-domain)”） | **X** | | | +| Restrict email notifications to verified domains (see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)" for details) | **X** | | | | 删除**所有团队** | **X** | | | | 删除组织帐户，包括所有仓库 | **X** | | | | 创建团队（详细信息请参阅“[在组织中设置团队创建权限](/articles/setting-team-creation-permissions-in-your-organization)”） | **X** | **X** | | 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 409dd31a026f..3991182fce69 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 @@ -60,7 +60,8 @@ versions: | [举报滥用或垃圾内容](/articles/reporting-abuse-or-spam) | **X** | **X** | **X** | **X** | **X** |{% endif %} | 应用标签 | | **X** | **X** | **X** | **X** | | Create, edit, delete labels | | | **X** | **X** | **X** | -| 关闭、重新打开和分配所有议题与拉取请求 | | **X** | **X** | **X** | **X** | +| 关闭、重新打开和分配所有议题与拉取请求 | | **X** | **X** | **X** | **X** |{% if currentVersion == "free-pro-team@latest" %} +| [Enable and disable auto-merge on a pull request](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository) | | | **X** | **X** | **X** |{% endif %} | 应用里程碑 | | **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** | 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 f2ecc5cff69c..4b53c88b98ac 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 @@ -9,13 +9,19 @@ versions: free-pro-team: '*' --- -在组织中启用受限制的电子邮件通知后，成员只能在与组织经验证域关联的电子邮件地址接收有关组织活动的电子邮件通知。 更多信息请参阅“[验证组织的域](/articles/verifying-your-organization-s-domain)”。 +### About email restrictions + +When restricted email notifications are enabled in an organization, members can only use an email address associated with the organization's verified domains to receive email notifications about organization activity. 更多信息请参阅“[验证组织的域](/articles/verifying-your-organization-s-domain)”。 外部协作者不受限于已验证域的电子邮件通知。 有关外部协作者的更多信息，请参阅“[组织的权限级别](/github/setting-up-and-managing-organizations-and-teams/permission-levels-for-an-organization#outside-collaborators)”。 +If your organization is owned by an enterprise account, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +### 将电子邮件通知限于已批准的域 + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} -5. 在“Enforcement preferences（强制执行首选项）”下，选择 **Restrict email notifications to domain email（将电子邮件通知限制为域电子邮件）**。 ![将电子邮件通知限制为经验证域电子邮件的复选框](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) +{% data reusables.organizations.restrict-email-notifications %} 6. 单击 **Save（保存）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md index c5bcff4d8dd2..939656ed0d73 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain.md @@ -8,39 +8,31 @@ versions: free-pro-team: '*' --- +### About domain verification + 要在 {% data variables.product.product_name %} 上验证域，您必须拥有组织中的所有者权限。 更多信息请参阅“[组织的权限级别](/articles/permission-levels-for-an-organization)”。 您还需要访问权限以使用您的域托管服务修改域记录。 验证组织域的所有权后，将在组织的资料中显示“Verified（已验证）”徽章。 如果您的组织位于 {% data variables.product.prodname_ghe_cloud %} 上并且已同意公司服务条款，则组织所有者将能够通过查看验证域内每个成员的电子邮件地址来验证组织成员的身份。 更多信息请参阅“[关于组织的资料页面](/articles/about-your-organization-s-profile/)”和“[升级到公司服务条款](/articles/upgrading-to-the-corporate-terms-of-service)”。 -要显示“Verified（已验证）”徽章，组织资料中显示的网站和电子邮件信息必须匹配经验证的一个或多个域。 如果组织资料中显示的网站和电子邮件地址在不同的域中托管，则必须验证两个域。 - -{% note %} - -**注：**如果组织资料中显示的电子邮件地址和网站使用同一个域的变体，则必须验证两种变体。 例如，如果组织的资料显示网站 `www.example.com` 和电子邮件地址 `info@example.com`，您需要验证 `www.example.com` 和 `example.com`。 +If your organization is owned by an enterprise account, a "Verified" badge will display on your organization's profile for any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." -{% endnote %} +{% data reusables.organizations.verified-domains-details %} 在 {% data variables.product.prodname_ghe_cloud %} 上，验证组织域的所有权后，您可以将组织的电子邮件通知限制为该域。 更多信息请参阅“[将电子邮件通知限于经批准的域](/articles/restricting-email-notifications-to-an-approved-domain)”。 +### 验证组织的域 + {% data reusables.profile.access_profile %} {% data reusables.profile.access_org %} {% data reusables.organizations.org_settings %} {% data reusables.organizations.verified-domains %} 5. 单击 **Add a domain（添加域）**。 ![添加域按钮](/assets/images/help/organizations/add-a-domain-button.png) -6. 在域字段中，输入您想要验证的域，然后单击 **Add domain（添加域）**。 ![添加域字段](/assets/images/help/organizations/add-domain-field.png) -7. 按照 **Add a DNS TXT record（添加 DNS TXT 记录）**下的说明操作，使用您的域托管服务创建 DNS TXT 记录。 您的 DNS 配置可能需要 72 小时才能更改。 DNS 配置更改后，继续下一步。 ![创建 DNS txt 记录的说明](/assets/images/help/organizations/create-dns-txt-record-instructions.png) - - {% tip %} - - **提示：**您可通过在命令行中运行 `dig` 命令来确认 DNS 配置已更改。 在示例命令中，将 `ORGANIZATION` 替换为您组织的名称，将 `example.com` 替换为您想要验证的域。 您应看到命令输出中列出的新 TXT 记录。 - +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ORGANIZATION` with the name of your organization and `example.com` with the domain you'd like to verify. 您应看到命令输出中列出的新 TXT 记录。 ```shell $ dig _github-challenge-ORGANIZATION.example.com +nostats +nocomments +nocmd TXT ``` - - {% endtip %} - 8. 确认您的 TXT 记录添加到 DNS 后，导航到组织设置中的 Verified domains（已验证的域）选项卡。 您可以按照上面的步骤 1 至 4 操作找到 Verified domains（已验证的域）选项卡。 ![验证含有待定域的域设置页面](/assets/images/help/organizations/pending-domain-verification.png) -9. 在待验证的域旁边，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}，然后单击 **Continue verifying（继续验证）**。 ![继续验证域按钮](/assets/images/help/organizations/continue-verifying-domain.png) -10. 单击 **Verify domain（验证域）**。 ![验证域按钮](/assets/images/help/organizations/verify-domain-final-button.png) +{% data reusables.organizations.continue-verifying-domain %} 11. （可选）组织的资料页面中显示“Verified（已验证）”徽章后，您可以从域托管服务的 DNS 记录中删除 TXT 条目。 ![已验证徽章](/assets/images/help/organizations/verified-badge.png) diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/index.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/index.md index 000f7dc05906..4fab6a88285d 100644 --- a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/index.md +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/index.md @@ -34,6 +34,8 @@ versions: {% link_in_list /enforcing-team-policies-in-your-enterprise-account %} {% link_in_list /enforcing-security-settings-in-your-enterprise-account %} {% link_in_list /configuring-saml-single-sign-on-and-scim-for-your-enterprise-account-using-okta %} + {% link_in_list /verifying-your-enterprise-accounts-domain %} + {% link_in_list /restricting-email-notifications-for-your-enterprise-account-to-approved-domains %} {% 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/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md new file mode 100644 index 000000000000..a6e3e46cd673 --- /dev/null +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains.md @@ -0,0 +1,26 @@ +--- +title: Restricting email notifications for your enterprise account to approved domains +intro: "You can prevent your enterprise's information from leaking into personal accounts by restricting email notifications about activity in organizations owned by your enterprise account to verified domains." +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can restrict email notifications for an enterprise account. +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About email restrictions for your enterprise account + +When you restrict email notifications to verified domains, enterprise members can only use an email address associated with a verified domain to receive email notifications about activity in organizations owned by your enterprise account. The domains can be inherited from the enterprise account or configured for the specific organization. For more information about email restrictions for organizations, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +If email restrictions are enabled for an enterprise account, organization owners cannot disable email restrictions for any organization owned by the enterprise account. If changes occur that result in an organization having no verified domains, either inherited from an enterprise account that owns the organization or for the specific organization, email restrictions will be disabled for the organization. + +### Restricting email notifications for your enterprise account + +Before you can restrict email notifications for your enterprise account, you must verify at least one domain for the enterprise account. For more information, see "[Verifying your enterprise account's domain](/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain)." + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +{% data reusables.organizations.restrict-email-notifications %} +1. 单击 **Save（保存）**。 diff --git a/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md new file mode 100644 index 000000000000..83b1e856f71c --- /dev/null +++ b/translations/zh-CN/content/github/setting-up-and-managing-your-enterprise/verifying-your-enterprise-accounts-domain.md @@ -0,0 +1,42 @@ +--- +title: Verifying your enterprise account's domain +intro: 'You can confirm the identity of organizations owned by your enterprise account by verifying ownership of your domain names with {% data variables.product.company_short %}.' +product: '{% data reusables.gated-features.enterprise-accounts %}' +versions: + free-pro-team: '*' +permissions: Enterprise owners can verify an enterprise account's domain. +redirect_from: + - /github/articles/verifying-your-enterprise-accounts-domain + - /early-access/github/articles/verifying-your-enterprise-accounts-domain +--- + +{% data reusables.enterprise-accounts.verifying-domains-release-phase %} + +### About domain verification + +You can confirm that the websites and email addresses listed on the profiles of any organization owned by your enterprise account are controlled by your enterprise by verifying the domains. Verified domains for an enterprise account apply to every organization owned by the enterprise account, and organization owners can verify additional domains for their organizations. 更多信息请参阅“[验证组织的域](/github/setting-up-and-managing-organizations-and-teams/verifying-your-organizations-domain)”。 + +After you verify ownership of your enterprise account's domains, a "Verified" badge will display on the profile of each organization that has the domain listed on its profile. {% data reusables.organizations.verified-domains-details %} + +Organization owners will be able to verify the identity of organization members by viewing each member's email address within the verified domain. + +After you verify domains for your enterprise account, you can restrict email notifications to verified domains for all the organizations owned by your enterprise account. For more information, see "[Restricting email notifications for your enterprise account to approved domains](/github/setting-up-and-managing-your-enterprise/restricting-email-notifications-for-your-enterprise-account-to-approved-domains)." + +Even if you don't restrict email notifications for the enterprise account, if an organization owner has restricted email notifications for the organization, organization members will be able to receive notifications from any domains verified for the enterprise account, in addition to any domains verified for the organization. For more information about restricting notifications for an organization, see "[Restricting email notifications to an approved domain](/github/setting-up-and-managing-organizations-and-teams/restricting-email-notifications-to-an-approved-domain)." + +### Verifying your enterprise account's domain + +To verify your enterprise account's domain, you must have access to modify domain records with your domain hosting service. + +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.settings-tab %} +{% data reusables.enterprise-accounts.verified-domains-tab %} +1. 单击 **Add a domain（添加域）**。 ![添加域按钮](/assets/images/help/enterprises/add-a-domain-button.png) +{% data reusables.organizations.add-domain %} +{% data reusables.organizations.add-dns-txt-record %} +1. Wait for your DNS configuration to change, which may take up to 72 hours. You can confirm your DNS configuration has changed by running the `dig` command on the command line, replacing `ENTERPRISE-ACCOUNT` with the name of your enterprise account, and `example.com` with the domain you'd like to verify. 您应看到命令输出中列出的新 TXT 记录。 + ```shell + dig _github-challenge-ENTERPRISE-ACCOUNT.example.com +nostats +nocomments +nocmd TXT + ``` +{% data reusables.organizations.continue-verifying-domain %} +1. Optionally, after the "Verified" badge is visible on your organizations' profiles, delete the TXT entry from the DNS record at your domain hosting service. ![已验证徽章](/assets/images/help/organizations/verified-badge.png) \ No newline at end of file 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 ce484af5e468..a72ea5c42b1d 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 @@ -46,7 +46,8 @@ You can also {% if currentVersion == "free-pro-team@latest" %}invite{% else %}ad | 定义仓库的代码所有者 | "[关于代码所有者](/github/creating-cloning-and-archiving-repositories/about-code-owners)" | | Archive the repository | "[About archiving repositories](/github/creating-cloning-and-archiving-repositories/about-archiving-repositories)" |{% if currentVersion == "free-pro-team@latest" %} | Create security advisories | "[关于 {% data variables.product.prodname_security_advisories %}](/github/managing-security-vulnerabilities/about-github-security-advisories)" | -| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" |{% endif %} +| Display a sponsor button | "[Displaying a sponsor button in your repository](/github/administering-a-repository/displaying-a-sponsor-button-in-your-repository)" | +| Allow or disallow auto-merge for pull requests | "[Managing auto-merge for pull requests in your repository](/github/administering-a-repository/managing-auto-merge-for-pull-requests-in-your-repository)" | {% endif %} ### Collaborator access for a repository owned by a user account @@ -60,23 +61,24 @@ Collaborators on a personal repository can pull (read) the contents of the repos Collaborators can also perform the following actions. -| 操作 | 更多信息 | -|:----------------------------------------------------------------------------------------- |:------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| Fork the repository | "[关于复刻](/github/collaborating-with-issues-and-pull-requests/about-forks)" | -| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | -| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | -| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | -| Manage milestones for issues and pull requests in the repository | "[创建和编辑议题及拉取请求的里程碑](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | -| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | -| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" | -| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | -| Create a pull request from a fork of the repository | "[从复刻创建拉取请求](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | -| Submit a review on a pull request that affects the mergeability of the pull request | "[审查拉取请求中提议的更改](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | -| Create and edit a wiki for the repository | "[关于 wikis](/github/building-a-strong-community/about-wikis)" | -| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | +| 操作 | 更多信息 | +|:----------------------------------------------------------------------------------------- |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Fork the repository | "[关于复刻](/github/collaborating-with-issues-and-pull-requests/about-forks)" | +| Create, edit, and delete comments on commits, pull requests, and issues in the repository |
    • "[About issues](/github/managing-your-work-on-github/about-issues)"
    • "[Commenting on a pull request](/github/collaborating-with-issues-and-pull-requests/commenting-on-a-pull-request)"
    • "[Managing disruptive comments](/github/building-a-strong-community/managing-disruptive-comments)"
    | +| Create, assign, close, and re-open issues in the repository | "[Managing your work with issues](/github/managing-your-work-on-github/managing-your-work-with-issues)" | +| Manage labels for issues and pull requests in the repository | "[Labeling issues and pull requests](/github/managing-your-work-on-github/labeling-issues-and-pull-requests)" | +| Manage milestones for issues and pull requests in the repository | "[创建和编辑议题及拉取请求的里程碑](/github/managing-your-work-on-github/creating-and-editing-milestones-for-issues-and-pull-requests)" | +| Mark an issue or pull request in the repository as a duplicate | "[About duplicate issues and pull requests](/github/managing-your-work-on-github/about-duplicate-issues-and-pull-requests)" | +| Create, merge, and close pull requests in the repository | "[Proposing changes to your work with pull requests](/github/collaborating-with-issues-and-pull-requests/proposing-changes-to-your-work-with-pull-requests)" |{% if currentVersion == "free-pro-team@latest" %} +| Enable and disable auto-merge for a pull request | "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)"{% endif %} +| Apply suggested changes to pull requests in the repository | "[Incorporating feedback in your pull request](/github/collaborating-with-issues-and-pull-requests/incorporating-feedback-in-your-pull-request)" | +| Create a pull request from a fork of the repository | "[从复刻创建拉取请求](/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork)" | +| Submit a review on a pull request that affects the mergeability of the pull request | "[审查拉取请求中提议的更改](/github/collaborating-with-issues-and-pull-requests/reviewing-proposed-changes-in-a-pull-request)" | +| Create and edit a wiki for the repository | "[关于 wikis](/github/building-a-strong-community/about-wikis)" | +| Create and edit releases for the repository | "[Managing releases in a repository](/github/administering-a-repository/managing-releases-in-a-repository)" | | Act as a code owner for the repository | "[About code owners](/articles/about-code-owners)" |{% if currentVersion == "free-pro-team@latest" %} | Publish, view, or install packages | "[Publishing and managing packages](/github/managing-packages-with-github-packages/publishing-and-managing-packages)" |{% endif %} -| 作为仓库协作者删除自己 | "[从协作者的仓库删除您自己](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | +| 作为仓库协作者删除自己 | "[从协作者的仓库删除您自己](/github/setting-up-and-managing-your-github-user-account/removing-yourself-from-a-collaborators-repository)" | ### 延伸阅读 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 12ed80f01522..0bcef73a25b6 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 @@ -4,8 +4,11 @@ intro: '{% data variables.product.prodname_insights %} 会分析您的 {% data v product: '{% data reusables.gated-features.github-insights %}' redirect_from: - /github/installing-and-configuring-github-insights/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.22/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.21/github/site-policy/github-insights-and-data-protection-for-your-organization + - /enterprise-server@2.20/github/site-policy/github-insights-and-data-protection-for-your-organization versions: - enterprise-server: '*' + free-pro-team: '*' --- 有关 {% data variables.product.prodname_insights %} 管制条款的更多信息，请参阅您的 {% data variables.product.prodname_ghe_one %} 订阅协议。 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 4659faf96b38..1e2cd74a254f 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（我接受）”，即表示您确认自己理解本协议，并接受其所有条款和条件。 如果您代表公司或其他法律实体签订本协议，则表示您拥有让该实体受本协议约束的法律权限，在这种情况下，“您”即表示您所代表的实体。** -生效日期：2020 年 7 月 21 日。 +Effective Date: January 1, 2021 ### 1. 定义 @@ -143,7 +143,7 @@ GitHub 可能：阻止该产品推介在 Marketplace 上展示；从 Marketplace **6.1** GitHub 是最终用户通过 Marketplace 购买开发者产品的记录商。 -**6.2** 开发者应用程序在 Marketplace 清单上的价格应设置为美元 (USD)。 开发者对于每个上架产品的定价设置有完全控制权，但一旦设定，就无法更改。 您可以撤销现有上架产品的定价计划，然后为其添加新的定价计划，前提是新的定价计划对现有最终客户没有不利影响。 您为开发者产品设置的价格将决定您将收到的付款金额。 GitHub 将以美元汇出 75% 的销售价格，不扣除税款，但适用法律要求的任何预扣税款除外。 其余 25% 的销售价格将分配给 GitHub 并由 GitHub 保留。 每个月底，在达到最低值 500 美元后，GitHub 将汇出您的应得款项。 +**6.2** 开发者应用程序在 Marketplace 清单上的价格应设置为美元 (USD)。 开发者对于每个上架产品的定价设置有完全控制权，但一旦设定，就无法更改。 您可以撤销现有上架产品的定价计划，然后为其添加新的定价计划，前提是新的定价计划对现有最终客户没有不利影响。 您为开发者产品设置的价格将决定您将收到的付款金额。 GitHub 将以美元汇出 95% 的销售价格，不扣除税款，但适用法律要求的任何预扣税款除外。 其余 5% 的销售价格将分配给 GitHub 并由 GitHub 保留。 每个月底，在达到最低值 500 美元后，GitHub 将汇出您的应得款项。 **6.3** 退款要求。 您将负责制定关于向最终客户退款的条款和条件。 在任何情况下，GitHub 都不负责为退款提供任何支持，GitHub 也没有义务支付任何退款。 @@ -169,7 +169,7 @@ GitHub 可能：阻止该产品推介在 Marketplace 上展示；从 Marketplace **10.3** GitHub 在 (a) 您违反了本协议的任何规定或 (b) 法律要求 GitHub 终止协议时可随时终止本协议。 -**10.4** 开发者终止的影响。 在收到开发者的四十五 (45) 天提前书面终止通知后，将被禁止开发者通过 Marketplace 吸收新客户。 在 Marketplace 中终止并删除开发者产品时，将向您支付任何未付款项。 如果终止是因 GitHub 修改这些条款（第 11 条）而发起的，则在此类修改之前有效的条款适用于 45 天通知期至实际终止之日的期间。 +**10.4** 开发者终止的影响。 在收到开发者的四十五 (45) 天提前书面终止通知后，将被禁止开发者通过 Marketplace 吸收新客户。 在 Marketplace 中终止并删除开发者产品时，将向您支付任何未付款项。 If termination is initiated as a result of a GitHub modification to these terms (Section 11), the terms in effect immediately prior to such modification shall govern for the duration of the 45-day notice period until the date of actual termination. **10.5** 第 2、3、4、5、8、9 以及 第12-18 条规定的义务在本协议到期或终止后仍然有效。 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 05337c081e90..1cdcb8a6fa5b 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 @@ -11,7 +11,7 @@ versions: free-pro-team: '*' --- -生效日期：2020 年 11 月 16 日 +Effective date: December 19, 2020 感谢您将自己的源代码、项目和个人信息交托给 GitHub Inc. （“GitHub”、“我们”）。 保管您的私人信息是一项重大责任，我们希望您了解我们的处理方式。 @@ -26,24 +26,24 @@ versions: ### 摘要 -| 节 | 说明 | -| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | -| [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 收集哪些信息](#what-information-github-collects) | GitHub 直接从您的注册、付款、交易和用户个人资料中收集信息。 We also automatically collect from you your usage information, cookies, and device information, subject, where necessary, to your consent. 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) | We only use strictly necessary cookies to provide, secure and improve our service. 我们提供了一个非常透明地说明此技术的网页。 请参阅本节了解更多信息。 | +| [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 隐私声明 @@ -74,8 +74,8 @@ versions: ##### 使用信息 如果您访问我们的服务或网站，我们将与大多数服务商一样自动收集一些基本信息，但在必要时会征得您的同意。 这包括有关您如何使用服务的信息，例如您查看的页面、推荐站点、您的 IP 地址和会话信息，以及每个请求的日期和时间。 这是我们针对网站的每个访客收集的信息，无论他们是否有帐户。 此类信息可能包括用户个人信息。 -##### Cookie 和类似技术的信息 -如下所述，在必要时会征得您的同意，我们通过 cookie 和类似技术自动收集信息（例如 cookie ID 和设置）以保持您的登录状态、记住您的首选项以及识别您和您的设备 。 +##### Cookie +As further described below, we automatically collect information from cookies (such as cookie ID and settings) to keep you logged in, to remember your preferences, to identify you and your device and to analyze your use of our service. ##### 设备信息 我们可能会收集有关您设备的某些信息，例如其 IP 地址、浏览器或客户端应用程序信息、语言首选项、操作系统和应用程序版本、设备类型和 ID 以及设备型号和制造商。 此类信息可能包括用户个人信息。 @@ -235,15 +235,17 @@ If you would like to compile GitHub data, you must comply with our Terms of Serv #### Cookie -GitHub uses cookies and similar technologies (e.g., HTML5 localStorage) to make interactions with our service easy and meaningful. Cookie 是网站通常存储在访客的计算机硬盘或移动设备上的小型文本文件。 We use cookies and similar technologies (hereafter collectively "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. 使用我们的网站，即表示您同意我们将这些类型的 cookie 放在您的计算机或设备上。 如果您禁止浏览器或设备接受这些 cookie，则将无法登录或使用 GitHub 的服务。 +GitHub only uses strictly necessary cookies. Cookie 是网站通常存储在访客的计算机硬盘或移动设备上的小型文本文件。 -我们提供了一个有关 [cookie 和跟踪技术](/github/site-policy/github-subprocessors-and-cookies)的网页，介绍我们设置的 cookie、对这些 cookie 的需求以及它们的类型（临时或永久）。 它还列出了我们的第三方分析提供商和其他服务提供商，并明确说明了允许他们跟踪我们网站的哪些部分。 +We use cookies solely to provide, secure, and improve our service. For example, we use them to keep you logged in, remember your preferences, identify your device for security purposes, analyze your use of our service, compile statistical reports, and provide information for future development of GitHub. We use our own cookies for analytics purposes, but do not use any third-party analytics service providers. -#### 跟踪和分析 +By using our service, 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 our service. -我们使用许多第三方分析和服务提供商来帮助我们评估用户对 GitHub的使用； 汇编有关活动的统计报告；以及改善我们的内容和网站性能。 我们仅在网站的某些区域使用这些第三方分析提供商，他们全部与我们签署了数据保护协议，这些协议限制了他们可以收集的用户个人信息类型以及他们处理信息的目的。 此外，我们使用自己的内部分析软件来提供功能并改善我们的内容和性能。 +我们提供了一个有关 [cookie 和跟踪技术](/github/site-policy/github-subprocessors-and-cookies)的网页，介绍我们设置的 cookie、对这些 cookie 的需求以及它们的类型（临时或永久）。 -有些浏览器纳入了“别跟踪”(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. +#### DNT + +"[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/)。 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. 还有一些很适合阻止在线跟踪的应用程序，例如 [Privacy Badger](https://privacybadger.org/)。 ### 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 51b4e729a722..3e7c4454a96c 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 @@ -10,88 +10,73 @@ versions: free-pro-team: '*' --- -Effective date: **October 2, 2020** +Effective date: **December 30, 2020** -GitHub 在如何使用您的数据、如何收集您的数据以及与谁分享您的数据方面提供很大的透明度。 为此，我们制作了本页面，详细介绍[我们的子处理商](#github-subprocessors)、我们如何使用 [cookie](#cookies-on-github)、在何处进行跟踪以及如何[在 GitHub 上执行跟踪](#tracking-on-github)。 +GitHub 在如何使用您的数据、如何收集您的数据以及与谁分享您的数据方面提供很大的透明度。 To that end, we provide this page, which details [our subprocessors](#github-subprocessors), and how we use [cookies](#cookies-on-github). ### GitHub 子处理商 我们与第三方子处理商（例如我们的供应商和服务提供商）分享您的信息时，我们仍对您的信息负责。 我们在引入新供应商时，会竭尽所能保持您的信任，并且要求所有供应商与我们签订数据保护协议，以约束他们对用户个人信息（定义见[隐私声明](/articles/github-privacy-statement/)）的处理。 -| 子处理商名称 | 处理说明 | 处理地点 | 公司地点 | -|:------------------ |:------------------------- |:---- |:---- | -| Automattic | 博客服务 | 美国 | 美国 | -| AWS Amazon | 数据托管 | 美国 | 美国 | -| Braintree (PayPal) | 订阅费用信用卡支付处理商 | 美国 | 美国 | -| Clearbit | 营销数据充实服务 | 美国 | 美国 | -| Discourse | 社区论坛软件提供商 | 美国 | 美国 | -| DiscoverOrg | 营销数据充实服务 | 美国 | 美国 | -| Eloqua | 营销活动自动化 | 美国 | 美国 | -| Google Apps | 公司内部基础设施 | 美国 | 美国 | -| Google Analytics | Analytics and performance | 美国 | 美国 | -| LinkedIn Navigator | 营销数据充实服务 | 美国 | 美国 | -| Magic Robot | 活动报告（Salesforce 加载项） | 美国 | 美国 | -| MailChimp | 客户事件单邮件服务提供商 | 美国 | 美国 | -| Mailgun | 交易邮件服务提供商 | 美国 | 美国 | -| Microsoft | Microsoft 服务 | 美国 | 美国 | -| Monday.com | 团队协作和项目管理平台 | 美国 | 以色列 | -| Nexmo | 短信通知提供商 | 美国 | 美国 | -| Oracle | 公司财务系统 | 美国 | 美国 | -| Salesforce.com | 客户关系管理 | 美国 | 美国 | -| Sendgrid | 交易邮件服务提供商 | 美国 | 美国 | -| Sentry.io | 应用程序监控提供商 | 美国 | 美国 | -| Stripe | 支付服务提供商 | 美国 | 美国 | -| Twilio | 短信通知提供商 | 美国 | 美国 | -| Zendesk | 客户支持事件单系统 | 美国 | 美国 | -| Zuora | 公司计费系统 | 美国 | 美国 | +| 子处理商名称 | 处理说明 | 处理地点 | 公司地点 | +|:------------------ |:----------------------- |:---- |:---- | +| Automattic | 博客服务 | 美国 | 美国 | +| AWS Amazon | 数据托管 | 美国 | 美国 | +| Braintree (PayPal) | 订阅费用信用卡支付处理商 | 美国 | 美国 | +| Clearbit | 营销数据充实服务 | 美国 | 美国 | +| Discourse | 社区论坛软件提供商 | 美国 | 美国 | +| DiscoverOrg | 营销数据充实服务 | 美国 | 美国 | +| Eloqua | 营销活动自动化 | 美国 | 美国 | +| Google Apps | 公司内部基础设施 | 美国 | 美国 | +| Google Analytics | 网站分析和性能 | 美国 | 美国 | +| LinkedIn Navigator | Data enrichment service | 美国 | 美国 | +| Magic Robot | 活动报告（Salesforce 加载项） | 美国 | 美国 | +| MailChimp | 客户事件单邮件服务提供商 | 美国 | 美国 | +| Mailgun | 交易邮件服务提供商 | 美国 | 美国 | +| Microsoft | Microsoft 服务 | 美国 | 美国 | +| Monday.com | 团队协作和项目管理平台 | 美国 | 以色列 | +| Nexmo | 短信通知提供商 | 美国 | 美国 | +| Salesforce.com | 客户关系管理 | 美国 | 美国 | +| Sendgrid | 交易邮件服务提供商 | 美国 | 美国 | +| Sentry.io | 应用程序监控提供商 | 美国 | 美国 | +| Stripe | 支付服务提供商 | 美国 | 美国 | +| Twilio | 短信通知提供商 | 美国 | 美国 | +| Zendesk | 客户支持事件单系统 | 美国 | 美国 | +| Zuora | 公司计费系统 | 美国 | 美国 | 在我们引入新的子处理商来处理用户个人信息、删除子处理商或更改使用子处理商的方式时，我们将更新本页面。 如果您对新的子处理商有疑问或疑虑，我们乐意提供帮助。 请通过 {% data variables.contact.contact_privacy %} 联系我们。 ### GitHub 上的 Cookie -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. +GitHub uses 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. 为此，我们制作了本页面，详细介绍[我们的子处理商](#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. -| 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. - -### 在 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 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/)。 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. +| Cookie 名称 | 原因 | 描述 | Expiration* | +|:--------- |:------------------------------------ |:----------------------------------------------------------------------------------------------------------------------------------------------------------------- |:------------------------------------------------------------- | +| GitHub | `app_manifest_token` | 此 cookie 用于表明页面之间的临时应用程序和框架状态，例如用户在多步骤表单中处于哪一步。 | five minutes | +| GitHub | `_device_id` | This cookie is used to track recognized devices for security purposes. | 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` | This cookie is used for session management including caching of dynamic content, conditional feature access, support request metadata, and first party analytics. | 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` | This cookie allows us to customize timestamps to your time zone. | 会话 | +| GitHub | `user_session` | 此 cookie 用于您的登录。 | two weeks | + +_*_ GitHub 出于以下原因在用户设备上放置以下 cookie： + +(!) Please note while we limit our use of third party cookies to those necessary to provide external functionality when rendering external content, certain pages on our website may set other third party cookies. 例如，我们可能会嵌入来自其他网站的内容（例如视频），而该网站可能放置 cookie。 虽然我们尽可能减少这些第三方 cookie，但我们无法始终控制这些第三方内容放置哪些 cookie。 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 e8977f114aba..d723d4476ea8 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 @@ -163,8 +163,6 @@ c/o Corporation Service Company Sacramento, CA 95833-3505 ``` -您也可以发送一份副本到 legal@support.github.com。 - 请求请尽可能具体，包含以下信息： - 关于发出信息请求的机构的完整信息 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 70a93622d261..1af04888d2d4 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 @@ -39,12 +39,6 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea 在仓库的清单或锁定文件中指定的任何直接或间接依赖项按生态系统分组列出。 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 %} 的通知。 -{% note %} - -**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 - -{% endnote %} - ![依赖关系图](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -58,12 +52,6 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea {% if enterpriseServerVersions contains currentVersion and currentVersion ver_lt "enterprise-server@2.22" %} 在仓库的清单或锁定文件中指定的任何直接或间接依赖项按生态系统分组列出。 如果在仓库中检测到漏洞，这些漏洞将显示在视图顶部，供有权访问安全警报的用户查看。 -{% note %} - -**注：**{% data variables.product.prodname_ghe_server %} 不会填充 **Dependents（依赖项）**视图。 - -{% endnote %} - ![依赖关系图](/assets/images/help/graphs/dependencies_graph_server.png) {% note %} @@ -93,9 +81,27 @@ The dependency graph shows the dependencies{% if currentVersion == "free-pro-tea 4. 阅读有关授予 {% data variables.product.product_name %} 只读访问仓库数据的消息，以启用依赖关系图，然后在“Dependency Graph（依赖关系图）”旁边单击 **Enable（启用）**。 ![依赖关系图的"启用"按钮](/assets/images/help/repository/dependency-graph-enable-button.png) 您可以随时单击 Security & analysis（安全性和分析）选项卡上“Dependency Graph（依赖关系图）”旁边的 **Disable（禁用）**来禁用依赖关系图。 + +### Changing the "Used by" package + +If the dependency graph is enabled, and your repository contains a package that's published on a supported package ecosystem, {% data variables.product.prodname_dotcom %} displays a "Used by" section in the sidebar of the **Code** tab of your repository. For more information about the supported package ecosystems, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#supported-package-ecosystems)." + +The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects. + +!["Used by" sidebar section](/assets/images/help/repository/used-by-section.png) + +Clicking any item in this section takes you to the **Dependents** tab of the dependency graph. + +The "Used by" section represents a single package from the repository. If you have admin permissions to a repository that contains multiple packages, you can choose which package the "Used by" section represents. + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +{% data reusables.repositories.navigate-to-security-and-analysis %} +4. Under "Configure security and analysis features", click the drop-down menu in the "Used by counter" section and choose a package. ![Choose a "Used by" package](/assets/images/help/repository/choose-used-by-package.png) + {% endif %} -### 依赖关系图疑难排解 +### 依赖项图疑难排解 如果依赖关系图为空，则包含依赖项的文件可能有问题。 检查该文件以确保其格式对文件类型是正确的。 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 a715d5909500..567524f08013 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,8 +40,9 @@ 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`。 如果要对您的组织站点使用子域 `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 %} +5. 导航到您的 DNS 提供程序并创建 `CNAME` 记录，使子域指向您站点的默认域。 例如，如果要对您的用户站点使用子域 `www.example.com`，您可以创建 `CNAME` 记录，使 `www.example.com` 指向 `.github.io`。 如果要对您的组织站点使用子域 `www.anotherexample.com`，您可以创建 `CNAME` 记录，使 `www.anotherexample.com` 指向 `.github.io`。 The `CNAME` record 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 %} + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. 要确认您的 DNS 记录配置正确，请使用 `dig` 命令，将 _WWW.EXAM.COM_ 替换为您的子域。 ```shell @@ -72,6 +73,8 @@ versions: 185.199.110.153 185.199.111.153 ``` + +{% indented_data_reference site.data.reusables.pages.wildcard-dns-warning spaces=3 %} {% data reusables.command_line.open_the_multi_os_terminal %} 6. 要确认您的 DNS 记录配置正确，请使用 `dig` 命令，将 _EXAM.COM_ 替换为您的 apex 域。 确认结果与上面 {% data variables.product.prodname_pages %} 的 IP 地址相匹配。 ```shell diff --git a/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md b/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md index 0b5ddf6f8fc5..0dc06af59359 100644 --- a/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md +++ b/translations/zh-CN/content/github/working-with-github-pages/troubleshooting-custom-domains-and-github-pages.md @@ -39,11 +39,7 @@ versions: - 使用多个 `www` 子域。 例如，同时使用 `www.example.com` 和 `www.anotherexample.com`。 - 同时使用 apex 域和自定义子域。 例如，同时使用 `example.com` 和 `docs.example.com`。 -{% warning %} - -**警告：**我们强烈建议不要使用通配符 DNS 记录，例如 `*.example.com`。 通配符 DNS 记录将允许任何人在您的其中一个子域上托管 {% data variables.product.prodname_pages %} 站点。 - -{% endwarning %} +{% data reusables.pages.wildcard-dns-warning %} 有关支持的自定义域列表，请参阅“[关于自定义域和 {% data variables.product.prodname_pages %}](/articles/about-custom-domains-and-github-pages/#supported-custom-domains)”。 diff --git a/translations/zh-CN/content/graphql/overview/resource-limitations.md b/translations/zh-CN/content/graphql/overview/resource-limitations.md index 6c0fafa51269..426772e330ef 100644 --- a/translations/zh-CN/content/graphql/overview/resource-limitations.md +++ b/translations/zh-CN/content/graphql/overview/resource-limitations.md @@ -117,7 +117,7 @@ versions: = 22,060 total nodes -### 速率限制 +## 速率限制 GraphQL API v4 限制不同于 REST API v3 的 [速率限制](/rest/overview/resources-in-the-rest-api#rate-limiting)。 @@ -130,12 +130,6 @@ API 速率限制为什么不同？ 使用 [GraphQL](/graphql)，一个 GraphQL GraphQL API v4 的速率限制为 **5,000 points per hour（每小时 5,000 点）**。 -{% if currentVersion == "free-pro-team@latest" %} - -对于属于 {% data variables.product.prodname_ghe_cloud %} 帐户的 {% data variables.product.prodname_github_apps %} 或 {% data variables.product.prodname_oauth_app %}，对相同 {% data variables.product.prodname_ghe_cloud %} 帐户拥有的资源的请求上限已提升至每小时 15,000 点。 - -{% endif %} - 请注意，每小时 5,000 点与每小时 5,000 个调用不同：GraphQL API v4 和 REST API v3 使用的速率限制不同。 {% note %} diff --git a/translations/zh-CN/content/graphql/reference/enums.md b/translations/zh-CN/content/graphql/reference/enums.md index 099abbb4be85..1f358d0019c4 100644 --- a/translations/zh-CN/content/graphql/reference/enums.md +++ b/translations/zh-CN/content/graphql/reference/enums.md @@ -2,6 +2,7 @@ title: 枚举 redirect_from: - /v4/enum + - /v4/reference/enum versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/input-objects.md b/translations/zh-CN/content/graphql/reference/input-objects.md index 6c91a83eab9f..f3a45e42f533 100644 --- a/translations/zh-CN/content/graphql/reference/input-objects.md +++ b/translations/zh-CN/content/graphql/reference/input-objects.md @@ -2,6 +2,7 @@ title: 输入对象 redirect_from: - /v4/input_object + - /v4/reference/input_object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/interfaces.md b/translations/zh-CN/content/graphql/reference/interfaces.md index 0e8cae2b94d4..43204400a52e 100644 --- a/translations/zh-CN/content/graphql/reference/interfaces.md +++ b/translations/zh-CN/content/graphql/reference/interfaces.md @@ -2,6 +2,7 @@ title: 接口 redirect_from: - /v4/interface + - /v4/reference/interface versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/mutations.md b/translations/zh-CN/content/graphql/reference/mutations.md index 8cfdfa57b412..4711f8027d21 100644 --- a/translations/zh-CN/content/graphql/reference/mutations.md +++ b/translations/zh-CN/content/graphql/reference/mutations.md @@ -2,6 +2,7 @@ title: 突变 redirect_from: - /v4/mutation + - /v4/reference/mutation versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/objects.md b/translations/zh-CN/content/graphql/reference/objects.md index a34c610ae04d..66805cb7d006 100644 --- a/translations/zh-CN/content/graphql/reference/objects.md +++ b/translations/zh-CN/content/graphql/reference/objects.md @@ -2,6 +2,7 @@ title: 对象 redirect_from: - /v4/object + - /v4/reference/object versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/queries.md b/translations/zh-CN/content/graphql/reference/queries.md index 268b503da1cd..e72af2bee62c 100644 --- a/translations/zh-CN/content/graphql/reference/queries.md +++ b/translations/zh-CN/content/graphql/reference/queries.md @@ -3,6 +3,7 @@ title: 查询 miniTocMaxHeadingLevel: 2 redirect_from: - /v4/query + - /v4/reference/query versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/scalars.md b/translations/zh-CN/content/graphql/reference/scalars.md index 22e32bd3b994..33a0cdf480de 100644 --- a/translations/zh-CN/content/graphql/reference/scalars.md +++ b/translations/zh-CN/content/graphql/reference/scalars.md @@ -2,6 +2,7 @@ title: 标量 redirect_from: - /v4/scalar + - /v4/reference/scalar versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/graphql/reference/unions.md b/translations/zh-CN/content/graphql/reference/unions.md index 5aa7af30292d..37ce8a72459e 100644 --- a/translations/zh-CN/content/graphql/reference/unions.md +++ b/translations/zh-CN/content/graphql/reference/unions.md @@ -2,6 +2,7 @@ title: 并集 redirect_from: - /v4/union + - /v4/reference/union versions: free-pro-team: '*' enterprise-server: '*' diff --git a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md index 41c840fe55f5..90a366dce91c 100644 --- a/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md +++ b/translations/zh-CN/content/insights/installing-and-configuring-github-insights/about-data-in-github-insights.md @@ -19,4 +19,4 @@ versions: ### 延伸阅读 - "[可用于 {% data variables.product.prodname_insights %} 的指标](/insights/exploring-your-usage-of-github-enterprise/metrics-available-with-github-insights)" -- [{% data variables.product.prodname_insights %} 和组织的数据保护](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- {% data variables.product.prodname_insights %} 和组织的数据保护" \ No newline at end of file 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 5690ee418e64..9dfb222ad9b0 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 @@ -99,4 +99,4 @@ versions: ### 延伸阅读 - "[管理仓库](/insights/installing-and-configuring-github-insights/managing-repositories)" -- [{% data variables.product.prodname_insights %} 和组织的数据保护](/github/site-policy/github-insights-and-data-protection-for-your-organization)" +- {% data variables.product.prodname_insights %} 和组织的数据保护" diff --git a/translations/zh-CN/content/packages/guides/configuring-npm-for-use-with-github-packages.md b/translations/zh-CN/content/packages/guides/configuring-npm-for-use-with-github-packages.md index 105d242f9002..baf86f41d851 100644 --- a/translations/zh-CN/content/packages/guides/configuring-npm-for-use-with-github-packages.md +++ b/translations/zh-CN/content/packages/guides/configuring-npm-for-use-with-github-packages.md @@ -16,6 +16,17 @@ versions: **注：**安装或发布 Docker 映像时，{% data variables.product.prodname_registry %} 当前不支持外部图层，如 Windows 映像。 +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.22" %} +### 已发布 npm 版本的限制 + +如果您发布超过 1,000npm 软件包版本到 {% data variables.product.prodname_registry %}，在使用过程中可能会出现性能问题和超时。 + +要减少为 npm 包发布的版本数，请考虑删除包版本。 更多信息请参阅“[删除包](/packages/manage-packages/deleting-a-package)”。 + +将来，{% data variables.product.company_short %} 将对发布超过 1,000 个版本 npm 包实施硬性限制。 当我们开始对 {% data variables.product.prodname_registry %} 上托管的每个 npm 包实施 1,000 个版本限制时，我们将提供有关如何管理包版本的更多指导。 + +{% endif %} + ### 向 {% data variables.product.prodname_registry %} 验证 {% data reusables.package_registry.authenticate-packages %} diff --git a/translations/zh-CN/content/packages/guides/deleting-a-container-image.md b/translations/zh-CN/content/packages/guides/deleting-a-container-image.md index 2130feae9bbd..6e7aa6b44799 100644 --- a/translations/zh-CN/content/packages/guides/deleting-a-container-image.md +++ b/translations/zh-CN/content/packages/guides/deleting-a-container-image.md @@ -1,6 +1,6 @@ --- title: 删除容器映像 -intro: '您可以使用 GraphQL 或在 {% data variables.product.prodname_dotcom %} 上删除私有容器映像的版本。' +intro: '您可以在 {% data variables.product.prodname_dotcom %} 中删除一个特定版本或所有版本的私有或公共容器映像。' product: '{% data reusables.gated-features.packages %}' redirect_from: - /packages/managing-container-images-with-github-container-registry/deleting-a-container-image @@ -20,14 +20,34 @@ versions: ### 删除 {% data variables.product.prodname_dotcom %} 上用户拥有的容器映像版本 +要只删除容器映像的特定版本，您可以使用以下步骤。 要删除整个包，请参阅“[删除 {% data variables.product.prodname_dotcom %} 上所有版本的用户自有容器映像](#deleting-all-versions-of-a-user-owned-container-image-on-github)”。 + {% data reusables.package_registry.package-settings-from-user-level %} 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) +6. （可选）为确保看到您的软件包的所有版本，请使用“Type（类型）”下拉菜单并选择 **All（所有）**。 ![包版本类型下拉菜单显示列出所有版本的选项](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. 在要删除的版本的右侧，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 并选择 **Delete version（删除版本）**。 ![删除包版本按钮](/assets/images/help/package-registry/delete-container-package-version.png) +6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this version（我明白后果，删除此版本）**。 ![确认包删除按钮](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) ### 删除 {% data variables.product.prodname_dotcom %} 上组织拥有的容器映像版本 +要只删除您具有管理员权限的容器映像的特定版本，可以使用以下步骤。 要删除整个包，请参阅“[删除 {% data variables.product.prodname_dotcom %} 上所有版本的组织自有容器映像](#deleting-all-versions-of-an-organization-owned-container-image-on-github)”。 + {% data reusables.package_registry.package-settings-from-org-level %} 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) +6. （可选）为确保看到您的软件包的所有版本，请使用“Type（类型）”下拉菜单并选择 **All（所有）**。 ![包版本类型下拉菜单显示列出所有版本的选项](/assets/images/help/package-registry/make-all-container-versions-visible.png) +5. 在要删除的版本的右侧，单击 {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %} 并选择 **Delete version（删除版本）**。 ![删除包版本按钮](/assets/images/help/package-registry/delete-container-package-version.png) +6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this version（我明白后果，删除此版本）**。 ![确认包版本删除按钮](/assets/images/help/package-registry/confirm-container-package-version-deletion.png) + +### 删除 {% data variables.product.prodname_dotcom %} 上用户拥有的容器映像的所有版本 + +{% data reusables.package_registry.package-settings-from-user-level %} +5. 在左侧，单击 **Options（选项）**。 !["选项"菜单选项](/assets/images/help/package-registry/options-for-container-settings.png) +6. 在“Danger Zone（危险区域）”下，单击**Delete this package（删除此包）**。 ![删除包版本按钮](/assets/images/help/package-registry/delete-container-package-button.png) +6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this package（我明白后果，删除此包）**。 ![确认包版本删除按钮](/assets/images/help/package-registry/confirm-container-package-deletion.png) + +### 删除 {% data variables.product.prodname_dotcom %} 上组织拥有的容器映像的所有版本 + +{% data reusables.package_registry.package-settings-from-org-level %} +5. 在左侧，单击 **Options（选项）**。 !["选项"菜单选项](/assets/images/help/package-registry/options-for-container-settings.png) +6. 在“Danger Zone（危险区域）”下，单击**Delete this package（删除此包）**。 ![删除包按钮](/assets/images/help/package-registry/delete-container-package-button.png) +6. 要确认删除，请输入包名称，然后单击 **I understand the consequences, delete this package（我明白后果，删除此包）**。 ![确认包删除按钮](/assets/images/help/package-registry/confirm-container-package-deletion.png) diff --git a/translations/zh-CN/content/packages/index.md b/translations/zh-CN/content/packages/index.md index a3468dcc4a93..7894a8d27bba 100644 --- a/translations/zh-CN/content/packages/index.md +++ b/translations/zh-CN/content/packages/index.md @@ -19,18 +19,18 @@ featuredLinks: - /packages/guides/enabling-improved-container-support - /packages/guides/configuring-rubygems-for-use-with-github-packages changelog: + - + title: ghcr.io 容器名称重定向到容器页 + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-ghcr-io-container-names-redirect-to-the-container-page/ + - + title: 过滤已标记和未标记的容器 + date: '2020-12-14' + href: https://github.blog/changelog/2020-12-14-packages-can-filter-for-tagged-and-untagged-containers/ - title: 包容器支持是一个选择性测试版 date: '2020-11-17' href: https://docs.github.com/packages/getting-started-with-github-container-registry/enabling-improved-container-support - - - title: 组织管理员对容器的访问 - date: '2020-11-16' - href: https://github.blog/changelog/2020-11-16-packages-organization-admins-access-to-containers/ - - - title: 包现在遵守 IP 允许列表设置 - date: '2020-11-12' - href: https://github.blog/changelog/2020-11-12-packages-now-respects-ip-allow-list-settings/ redirect_from: - /github/managing-packages-with-github-packages - /categories/managing-packages-with-github-package-registry diff --git a/translations/zh-CN/content/rest/overview/libraries.md b/translations/zh-CN/content/rest/overview/libraries.md index 9a52655193b3..82e03b01ad4f 100644 --- a/translations/zh-CN/content/rest/overview/libraries.md +++ b/translations/zh-CN/content/rest/overview/libraries.md @@ -7,6 +7,7 @@ redirect_from: versions: free-pro-team: '*' enterprise-server: '*' + github-ae: '*' ---
    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 0f2bd8f8a8e4..f19f8ebf4caa 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 @@ -41,8 +41,9 @@ $ curl -i {% data variables.product.api_url_pre %}/users/octocat/orgs > X-GitHub-Media-Type: github.v3 > X-RateLimit-Limit: 5000 > X-RateLimit-Remaining: 4987 -> X-RateLimit-Reset: 1350085394{% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} -> X-GitHub-Enterprise-Version: {{ currentVersion }}.0{% endif %} +> X-RateLimit-Reset: 1350085394{% if enterpriseServerVersions contains currentVersion %} +> X-GitHub-Enterprise-Version: {{ currentVersion | remove: "enterprise-server@" }}.0{% elsif currentVersion == "github-ae@latest" %} +> X-GitHub-Enterprise-Version: GitHub AE{% endif %} > Content-Length: 5 > Cache-Control: max-age=0, private, must-revalidate > X-Content-Type-Options: nosniff @@ -235,14 +236,14 @@ API v3 酌情使用 HTTP 重定向。 客户端应假定任何请求都可能会 API v3 尽可能对每个操作使用适当的 HTTP 请求方法。 -| 请求方法 | 描述 | -| -------- | --------------------------------------------------------------------------------------------------------------------------------- | -| `HEAD` | 可以针对任何资源发出以仅获取 HTTP 标头信息。 | -| `GET` | 用于检索资源。 | -| `POST` | 用于创建资源。 | -| `PATCH` | 用于通过部分 JSON 数据更新资源。 例如，议题资源具有 `title` 和 `body` 属性。 PATCH 请求可以接受一个或多个属性来更新资源。 PATCH 是一个相对较新且不常见的 HTTP 请求方法，因此资源端点也接受 `POST` 请求。 | -| `PUT` | 用于替换资源或集合。 对于没有 `body` 属性的 `PUT` 请求，请确保将 `Content-Length` 标头设置为零。 | -| `DELETE` | 用于删除资源。 | +| 请求方法 | 描述 | +| -------- | ------------------------------------------------------------------------------ | +| `HEAD` | 可以针对任何资源发出以仅获取 HTTP 标头信息。 | +| `GET` | 用于检索资源。 | +| `POST` | 用于创建资源。 | +| `PATCH` | 用于通过部分 JSON 数据更新资源。 例如，议题资源具有 `title` 和 `body` 属性。 `PATCH` 请求可以接受一个或多个属性来更新资源。 | +| `PUT` | 用于替换资源或集合。 对于没有 `body` 属性的 `PUT` 请求，请确保将 `Content-Length` 标头设置为零。 | +| `DELETE` | 用于删除资源。 | ### 超媒体 diff --git a/translations/zh-CN/content/rest/reference/enterprise-admin.md b/translations/zh-CN/content/rest/reference/enterprise-admin.md index 178a87a9d3a0..c8abfe19a5e3 100644 --- a/translations/zh-CN/content/rest/reference/enterprise-admin.md +++ b/translations/zh-CN/content/rest/reference/enterprise-admin.md @@ -40,7 +40,7 @@ http(s)://hostname/ {% if currentVersion == "github-ae@latest" or enterpriseServerVersions contains currentVersion %} ### 身份验证 -{% data variables.product.product_name %} 安装设施的 API 端点接受与 GitHub.com [相同的身份验证方法](/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) 创建）或**[基本身份验证](/rest/overview/resources-in-the-rest-api#basic-authentication)**来验证自己。 {% if enterpriseServerVersions contains currentVersion %} OAuth 令牌用于企业特定的端点时必须具有 `site_admin` [OAuth 作用域](/developers/apps/scopes-for-oauth-apps#available-scopes)。{% endif %} +{% data variables.product.product_name %} 安装设施的 API 端点接受与 GitHub.com [相同的身份验证方法](/rest/overview/resources-in-the-rest-api#authentication)。 您可以使用 **[OAuth 令牌](/apps/building-integrations/setting-up-and-registering-oauth-apps/)**{% if enterpriseServerVersions contains currentVersion %}（可使用[授权 API](/rest/reference/oauth-authorizations#create-a-new-authorization) 创建）{% endif %}或**[基本身份验证](/rest/overview/resources-in-the-rest-api#basic-authentication)**来验证自己。 {% if enterpriseServerVersions contains currentVersion %} OAuth 令牌用于企业特定的端点时必须具有 `site_admin` [OAuth 作用域](/developers/apps/scopes-for-oauth-apps#available-scopes)。{% endif %} 企业管理 API 端点只有经过身份验证的 {% data variables.product.product_name %} 站点管理员可以访问{% if enterpriseServerVersions contains currentVersion %}，但[管理控制台](#management-console) API 例外，它需要[管理控制台密码](/enterprise/admin/articles/accessing-the-management-console/){% endif %}。 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 af95c2692ba6..31af63699892 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 @@ -135,12 +135,12 @@ _搜索_ - [`PATCH /repos/:owner/:repo`](/rest/reference/repos#update-a-repository) (:write) - [`DELETE /repos/:owner/:repo`](/rest/reference/repos#delete-a-repository) (:write) {% if currentVersion == "free-pro-team@latest" %} -- [`Get GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) +- [`GET /repos/:owner/:repo/actions/runners/downloads`](/rest/reference/actions#list-runner-applications-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners`](/rest/reference/actions#list-self-hosted-runners-for-a-repository) (:read) - [`GET /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#get-a-self-hosted-runner-for-a-repository) (:read) - [`DELETE /repos/:owner/:repo/actions/runners/:runner_id`](/rest/reference/actions#delete-a-self-hosted-runner-from-a-repository) (:write) - [`POST /repos/:owner/:repo/actions/runners/registration-token`](/rest/reference/actions#create-a-registration-token-for-a-repository) (:write) -- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write)git +- [`POST /repos/:owner/:repo/actions/runners/remove-token`](/rest/reference/actions#create-a-remove-token-for-a-repository) (:write) {% endif %} {% if currentVersion == "free-pro-team@latest" %} - [`PUT /repos/:owner/:repo/automated-security-fixes`](/rest/reference/repos#enable-automated-security-fixes) (:write) @@ -472,7 +472,7 @@ _受理人_ _事件_ - [`GET /repos/:owner/:repo/issues/:issue_number/events`](/rest/reference/issues#list-issue-events) (:read) -- [Get an issue event](/rest/reference/issues#get-an-issue-event) (:read) +- [`GET /repos/:owner/:repo/issues/events/:event_id`](/rest/reference/issues#get-an-issue-event) (:read) _标签_ - [`GET /repos/:owner/:repo/issues/:issue_number/labels`](/rest/reference/issues#list-labels-for-an-issue) (:read) diff --git a/translations/zh-CN/data/glossaries/external.yml b/translations/zh-CN/data/glossaries/external.yml index c0848ab578fa..2428be2110fd 100644 --- a/translations/zh-CN/data/glossaries/external.yml +++ b/translations/zh-CN/data/glossaries/external.yml @@ -390,7 +390,7 @@ - term: main description: >- - The default development branch. Whenever you create a Git repository, a branch named `main` is created, and becomes the active branch. In most cases, this contains the local development, though that is purely by convention and is not required. + 默认开发分支。只要创建 Git 仓库，就会创建一个名为 "main" 的分支，并且它会变为活动的分支。大多数情况下，这包含本地开发，但纯属惯例，而非必需。 - term: master description: >- diff --git a/translations/zh-CN/data/products.yml b/translations/zh-CN/data/products.yml index 70673aae608c..e32c28b47eea 100644 --- a/translations/zh-CN/data/products.yml +++ b/translations/zh-CN/data/products.yml @@ -12,5 +12,5 @@ productsInOrder: - rest - graphql - insights - - education + - 教育版 - desktop diff --git a/translations/zh-CN/data/release-notes/2-20/0.yml b/translations/zh-CN/data/release-notes/2-20/0.yml index 56231233549b..fc3327a11075 100644 --- a/translations/zh-CN/data/release-notes/2-20/0.yml +++ b/translations/zh-CN/data/release-notes/2-20/0.yml @@ -2,43 +2,43 @@ date: '2020-02-11' sections: features: - - 'On a repository branch, repository administrators can reject any push that contains a merge commit by enabling `Require linear history` using [branch protection rules](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions). {% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/ {% endcomment %}' - - 'Repository administrators can grant all users with push access the ability to force-push to a protected branch by enabling `Allow force pushes` using [branch protection rules](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions). {% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/, https://github.com/github/ce-oss-happiness/issues/42, https://github.com/github/github/pull/125950 {% endcomment %}' - - 'Repository administrators can grant all users with push access the ability to delete a protected branch by enabling `Allow deletions` using [branch protection rules](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions). {% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/ {% endcomment %}' - - 'Administrators can set a `maxobjectsize` limit on repositories, [limiting the size of push commits](https://help.github.com/en/enterprise/admin/installation/setting-git-push-limits) to a repository that are not in [Git LFS](https://help.github.com/en/enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server). {% comment %} https://github.com/github/babeld/pull/864, https://team.githubapp.com/posts/33519, https://github.com/githubcustomers/Slack/issues/27 {% endcomment %}' - - 'Organization owners can create a set of default labels when creating a new repository.{% comment %} https://github.com/github/issues-projects/issues/237, https://github.com/github/issues-projects/issues/179 {% endcomment %}' + - '在仓库分支上，仓库管理员可以使用 [分支保护规则](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions) 启用"需要线性历史记录"，从而拒绝包含合并提交的任何推送。{% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/ {% endcomment %}' + - '仓库管理员可以使用 [分支保护规则](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions) 启用“允许强制推送”，从而授予所有用户强制推送到受保护的分支的能力。 {% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/, https://github.com/github/ce-oss-happiness/issues/42, https://github.com/github/github/pull/125950 {% endcomment %}' + - '仓库管理员可以使用 [分支保护规则](https://help.github.com/en/github/administering-a-repository/enabling-branch-restrictions) 启用“允许删除”，从而授予所有具有推送权限的用户删除受保护分支的能力。{% comment %} https://github.blog/changelog/2019-12-04-expanded-branch-protection-rules/ {% endcomment %}' + - '管理员可以在仓库上设置 `maxobjectsize` 限制、对不在 [Git LFS](https://help.github.com/en/enterprise/admin/installation/configuring-git-large-file-storage-on-github-enterprise-server) 中的仓库 [限制推送提交的大小](https://help.github.com/en/enterprise/admin/installation/setting-git-push-limits)。{% comment %} https://github.com/github/babeld/pull/864, https://team.githubapp.com/posts/33519, https://github.com/githubcustomers/Slack/issues/27 {% endcomment %}' + - '组织所有者在创建新仓库时可以创建一组默认标签。{% comment %} https://github.com/github/issues-projects/issues/237, https://github.com/github/issues-projects/issues/179 {% endcomment %}' security_fixes: - - Packages have been updated to the latest security versions. + - 包已更新到最新的安全版本。 bugs: - - 'When a member of an organization tried to view a public repository in that organization, an SSO prompt could break the page display. {% comment %} https://github.com/github/github/issues/126677, https://github.com/github/github/pull/127501 {% endcomment %}' - - "When viewing a users' profile, the links to that users' teams could be broken. {% comment %} https://github.com/github/github/issues/131771, https://github.com/github/github/pull/131865 {% endcomment %}" - - 'Users with the `maintain` role were unable to edit repository topics. {% comment %} https://github.com/github/github/pull/129503, https://github.com/github/github/issues/119456 {% endcomment %}' - - "A user who isn't an administrator for an organization would receive a 500 error when attempting to access the sign up page. {% comment %} https://github.com/github/github/pull/129213, https://github.com/github/github/issues/129210, https://github.com/github/github/issues/129212 {% endcomment %}" - - 'The edit history popup would not display on gist comments. {% comment %} https://github.com/github/github/pull/129134, https://github.com/github/github/issues/128496 {% endcomment %}' - - 'A new account could be registered with an email that was already registered. {% comment %} https://github.com/github/github/pull/127905, https://github.com/github/github/issues/127858 {% endcomment %}' - - 'A storage service was hitting a file descriptor limit and causing kernel hanging and other services to log errors. {% comment %} https://github.com/github/enterprise2/pull/18775 {% endcomment %}' - - 'When an autolink reference was part of a url, the hyperlink could be removed. {% comment %} https://github.com/github/github/pull/126776 {% endcomment %}' - - 'When adding a comment to a pull request, the `Linked Issues` section from the sidebar could disappear. {% comment %} https://github.com/github/issues-projects/issues/384, https://github.com/github/github/pull/130514 {% endcomment %}' - - 'When editing an existing organization invitation for a user, a duplicate header could be appear on the `Teams` table. {% comment %} https://github.com/github/github/issues/120381, https://github.com/github/github/pull/128939 {% endcomment %}' - - 'The `resqued` service could stop logging events when the queues became too large. {% comment %} https://github.com/github/github/pull/130087, https://github.com/github/business-support/issues/2696 {% endcomment %}' - - 'Self-signed certificates are not automatically generated when running the `ghe-config-apply` command for cluster and high-availability configurations. {% comment %} https://github.com/github/enterprise2/pull/18773 {% endcomment %}' + - '当组织的成员尝试查看该组织的公共仓库时，SSO 提示可能会中断页面显示。 {% comment %} https://github.com/github/github/issues/126677， https://github.com/github/github/pull/127501 {% endcomment %}' + - "查看用户配置文件时，指向该用户团队的链接可能会断开。 {% comment %} https://github.com/github/github/issues/131771, https://github.com/github/github/pull/131865 {% endcomment %}" + - '具有“维护”角色的用户无法编辑存储库主题。 {% comment %} https://github.com/github/github/pull/129503, https://github.com/github/github/issues/119456 {% endcomment %}' + - "不是组织管理员的用户在尝试访问注册页面时将收到 500 个错误。{% comment %} https://github.com/github/github/pull/129213, https://github.com/github/github/issues/129210, https://github.com/github/github/issues/129212 {% endcomment %}" + - '编辑历史记录弹出窗口不会显示在 Gist 注释上。 {% comment %} https://github.com/github/github/pull/129134, https://github.com/github/github/issues/128496 {% endcomment %}' + - '使用已注册的电子邮件可以注册新帐户。 {% comment %} https://github.com/github/github/pull/127905, https://github.com/github/github/issues/127858 {% endcomment %}' + - '存储服务达到文件描述符限制，并导致内核挂起和其他服务记录错误。 {% comment %} https://github.com/github/enterprise2/pull/18775 {% endcomment %}' + - '当自动链接引用是 Url 的一部分时，可以删除超链接。 {% comment %} https://github.com/github/github/pull/126776 {% endcomment %}' + - '向拉取请求添加注释时，侧边栏中的“链接的议题”部分可能会消失。 {% comment %} https://github.com/github/issues-projects/issues/384, https://github.com/github/github/pull/130514 {% endcomment %}' + - '编辑用户的现有组织邀请时，“团队”表格上可能会显示重复的标头。 {% comment %} https://github.com/github/github/issues/120381, https://github.com/github/github/pull/128939 {% endcomment %}' + - '当队列变得太大时，`resqued` 服务可能会停止记录事件。 {% comment %} https://github.com/github/github/pull/130087, https://github.com/github/business-support/issues/2696 {% endcomment %}' + - '对于群集和高可用性配置运行 "ghe-config-apply" 命令时，不会自动生成自签名证书。 {% comment %} https://github.com/github/enterprise2/pull/18773 {% endcomment %}' changes: - - 'No logo will be displayed for a topic if one has not been uploaded. {% comment %} https://github.com/github/github/issues/130513, https://github.com/github/github/pull/130515 {% endcomment %}' - - 'When viewing an issue on a mobile browser, the issue metadata is listed at the top of the page. {% comment %} https://github.com/github/github/pull/127560 {% endcomment %}' - - 'Consul''s top-level domain has changed from ".consul" to ".ghe.local". {% comment %} https://github.com/github/enterprise2/pull/17443, https://github.com/github/enterprise2/issues/17701 {% endcomment %}' - - 'The hookshot service no longer relies on ElasticSearch and only uses MySQL as a database store. {% comment %} https://github.com/github/enterprise2/pull/18158, https://github.com/github/hookshot/pull/1128, https://github.com/github/enterprise2/pull/15898 {% endcomment %}' - - 'Improved visual distinction between issue, project and discussion has been implemented on project note cards. {% comment %} https://github.com/github/github/pull/132038 {% endcomment %}' - - 'On a pull request review, a notice is displayed if a multi-line comment is truncated. {% comment %} https://github.com/github/github/issues/125948, https://github.com/github/github/pull/128677 {% endcomment %}' - - 'Users can view their audit log on the `Security Log` tab of their personal settings page. {% comment %} https://github.com/github/github/pull/123041{% endcomment %}' + - '如果尚未上载主题，则不会显示徽标。{% comment %} https://github.com/github/github/issues/130513, https://github.com/github/github/pull/130515 {% endcomment %}' + - '在移动浏览器上查看议题时，议题元数据将列在页面顶部。 {% comment %} https://github.com/github/github/pull/127560 {% endcomment %}' + - 'Consul 的顶级域名从 ".consul" 改为 ".ghe.local"。 {% comment %} https://github.com/github/enterprise2/pull/17443, https://github.com/github/enterprise2/issues/17701 {% endcomment %}' + - 'Hookshot 服务不再依赖 ElasticSearch ，只能使用 MySQL 作为数据库存储。{% comment %} https://github.com/github/enterprise2/pull/18158, https://github.com/github/hookshot/pull/1128, https://github.com/github/enterprise2/pull/15898 {% endcomment %}' + - '在项目说明卡上改进了议题、项目及讨论之间的视觉区分。 {% comment %} https://github.com/github/github/pull/132038 {% endcomment %}' + - '在拉取请求审阅中，如果多行注释被截断，将显示通知。{% comment %} https://github.com/github/github/issues/125948, https://github.com/github/github/pull/128677 {% endcomment %}' + - '用户可以在个人设置页面的“Security Log（安全日志）”选项卡上查看其审核日志。{% comment %} https://github.com/github/github/pull/123041{% endcomment %}' known_issues: - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - - Duplicate webhook entries in the database can cause upgrades from previous versions to fail. (updated 2020-02-26) - - 'Upgrades and settings updates will fail if background worker configurations have been customised. {% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - 数据库中重复的 web 挂钩条目可能会导致从早期版本的升级失败。（更新时间：2020-02-26） + - '如果自定义了后台工作人员配置，则升级和设置更新将失败。{% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. (updated 2020-04-07) {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '当升级到以前的版本时，背景作业工人可能无法生成，从而阻止基本功能，例如合并拉取请求。（更新时间：2020-04-07）{% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/1.yml b/translations/zh-CN/data/release-notes/2-20/1.yml index e303f5525e5e..4c978af3e468 100644 --- a/translations/zh-CN/data/release-notes/2-20/1.yml +++ b/translations/zh-CN/data/release-notes/2-20/1.yml @@ -13,9 +13,9 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - - 'Upgrades and settings updates will fail if background worker configurations have been customised. {% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '如果自定义了后台工作人员配置，则升级和设置更新将失败。{% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. (updated 2020-04-07) {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '当升级到以前的版本时，背景作业工人可能无法生成，从而阻止基本功能，例如合并拉取请求。（更新时间：2020-04-07）{% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/2.yml b/translations/zh-CN/data/release-notes/2-20/2.yml index 78e2faa7e14c..65211fc0bf82 100644 --- a/translations/zh-CN/data/release-notes/2-20/2.yml +++ b/translations/zh-CN/data/release-notes/2-20/2.yml @@ -2,27 +2,27 @@ date: '2020-03-10' sections: security_fixes: - - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/19204, https://github.com/github/enterprise2/pull/19187 {% endcomment %}' + - '包已更新到最新的安全版本。{% comment %} https://github.com/github/enterprise2/pull/19204, https://github.com/github/enterprise2/pull/19187 {% endcomment %}' bugs: - - 'In some cases the forwarded log entries, mainly for audit.log were getting truncated. {% comment %} https://github.com/github/enterprise2/pull/19244, https://github.com/github/enterprise2/pull/19192, https://github.com/github/enterprise2/issues/16655 {% endcomment %}' - - 'The `ghe-license-check` command-line utility returned an "Invalid license file" error for some valid licenses, causing configuration changes to fail. {% comment %} https://github.com/github/enterprise2/pull/19249, https://github.com/github/enterprise2/pull/19185, https://github.zendesk.com/agent/tickets/549903 {% endcomment %}' - - 'Alambic exception logs were not forwarded by syslog. {% comment %} https://github.com/github/enterprise2/pull/19263, https://github.com/github/enterprise2/pull/19123, https://github.com/github/enterprise2/issues/18734 {% endcomment %}' - - 'The [`org_block event`](https://developer.github.com/v3/activity/events/types/#orgblockevent) is not unavailable but was appearing for GitHub Apps on GitHub Enterprise Server. {% comment %} https://github.com/github/github/pull/136227, https://github.com/github/github/pull/135640, https://github.com/github/ecosystem-apps/issues/693 {% endcomment %}' - - 'GraphQL query responses sometimes returned unmatched node identifiers for `ProtectedBranch` objects. {% comment %} https://github.com/github/github/pull/136376, https://github.com/github/github/pull/136214, https://github.com/github/github/issues/135407 {% endcomment %}' - - 'The GitHub App credential used by GitHub Connect failed to refresh immediately after expiry. {% comment %} https://github.com/github/github/pull/136384, https://github.com/github/github/pull/136259 {% endcomment %}' - - 'Leaving a comment in reply to a pull request comment was intermittently creating a pending pull request review. {% comment %} https://github.com/github/github/pull/136454, https://github.com/github/github/pull/133697, https://github.com/github/github/issues/127401 {% endcomment %}' - - 'Using ghe-migrator or exporting from GitHub.com, an export would silently fail to export non-image attachments. {% comment %} https://github.com/github/github/pull/136487, https://github.com/github/github/pull/134524, https://github.com/github/github/issues/134358 {% endcomment %}' - - 'Pre-receive hook returned 500 error on web UI when UTF-8 characters were encountered. {% comment %} https://github.com/github/github/pull/136699, https://github.com/github/github/pull/136014, https://github.com/github/github/issues/133501 {% endcomment %}' + - '在某些情况下，转发的日志条目（主要用于audit.log）被截断。{% comment %} https://github.com/github/enterprise2/pull/19244, https://github.com/github/enterprise2/pull/19192, https://github.com/github/enterprise2/issues/16655 {% endcomment %}' + - '`ghe-license-check` 命令行实用程序对某些有效的许可返回“无效的许可文件”错误，导致配置更改失败。 {% comment %} https://github.com/github/enterprise2/pull/19249, https://github.com/github/enterprise2/pull/19185, https://github.zendesk.com/agent/tickets/549903 {% endcomment %}' + - 'Alambic 异常日志没有被 syslog 转发。 {% comment %} https://github.com/github/enterprise2/pull/19263, https://github.com/github/enterprise2/pull/19123, https://github.com/github/enterprise2/issues/18734 {% endcomment %}' + - '[`org_block event`](https://developer.github.com/v3/activity/events/types/#orgblockevent) 并非不可用，但在 GitHub Enterprise Server 上对 GitHub Apps 显示。{% comment %} https://github.com/github/github/pull/136227, https://github.com/github/github/pull/135640, https://github.com/github/ecosystem-apps/issues/693 {% endcomment %}' + - 'GraphQL 查询响应有时返回 `ProtectedBranch` 对象的不匹配节点标识符。{% comment %} https://github.com/github/github/pull/136376, https://github.com/github/github/pull/136214, https://github.com/github/github/issues/135407 {% endcomment %}' + - 'GitHub Connect 使用的 GitHub 应用程序凭据在过期后立即刷新。{% comment %} https://github.com/github/github/pull/136384, https://github.com/github/github/pull/136259 {% endcomment %}' + - '在回复拉请求评论时留下评论是间歇性地创建挂起拉请求审查。 {% comment %} https://github.com/github/github/pull/136454, https://github.com/github/github/pull/133697, https://github.com/github/github/issues/127401 {% endcomment %}' + - '使用 GitHub.com 中的 ghe-migrator 或 exporting 时，导出无法导出非图像附件，并且没有提示。{% comment %} https://github.com/github/github/pull/136487, https://github.com/github/github/pull/134524, https://github.com/github/github/issues/134358 {% endcomment %}' + - '预接收挂钩在遇到 UTF-8 字符时返回 500 错误。{% comment %} https://github.com/github/github/pull/136699, https://github.com/github/github/pull/136014, https://github.com/github/github/issues/133501 {% endcomment %}' changes: - - 'The ` ghe-license-usage ` command-line utility includes a new `--unencrypted` option to provide visibility into the exported license usage file. {% comment %} https://github.com/github/github/pull/136134, https://github.com/github/github/pull/136000 {% endcomment %}' + - '` ghe-license-usage ` 命令行实用程序新增了 `--unencrypted` 选项，用于查看导出的许可使用文件。{% comment %} https://github.com/github/github/pull/136134, https://github.com/github/github/pull/136000 {% endcomment %}' known_issues: - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - - 'Upgrades and settings updates will fail if background worker configurations have been customised. {% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '如果自定义了后台工作人员配置，则升级和设置更新将失败。{% comment %} https://github.com/github/enterprise2/issues/19119 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. (updated 2020-04-07) {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '当升级到以前的版本时，背景作业工人可能无法生成，从而阻止基本功能，例如合并拉取请求。（更新时间：2020-04-07）{% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/23.yml b/translations/zh-CN/data/release-notes/2-20/23.yml new file mode 100644 index 000000000000..bde9f73982f7 --- /dev/null +++ b/translations/zh-CN/data/release-notes/2-20/23.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1020, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24351, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/3.yml b/translations/zh-CN/data/release-notes/2-20/3.yml index 23c25312e517..2f0a6f7d3c4b 100644 --- a/translations/zh-CN/data/release-notes/2-20/3.yml +++ b/translations/zh-CN/data/release-notes/2-20/3.yml @@ -8,8 +8,8 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. (updated 2020-04-07) {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '当升级到以前的版本时，背景作业工人可能无法生成，从而阻止基本功能，例如合并拉取请求。（更新时间：2020-04-07）{% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/4.yml b/translations/zh-CN/data/release-notes/2-20/4.yml index 0f06a203cd98..cba82a501d5d 100644 --- a/translations/zh-CN/data/release-notes/2-20/4.yml +++ b/translations/zh-CN/data/release-notes/2-20/4.yml @@ -11,8 +11,8 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. (updated 2020-04-07) {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '当升级到以前的版本时，背景作业工人可能无法生成，从而阻止基本功能，例如合并拉取请求。（更新时间：2020-04-07）{% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/5.yml b/translations/zh-CN/data/release-notes/2-20/5.yml index 44115fdc71a1..fe4ea42d89e9 100644 --- a/translations/zh-CN/data/release-notes/2-20/5.yml +++ b/translations/zh-CN/data/release-notes/2-20/5.yml @@ -13,8 +13,8 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - 'When upgrading from previous versions, background job workers may not be spawned, preventing essential features such as merging pull requests. {% comment %} https://github.com/github/enterprise2/issues/19232 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/6.yml b/translations/zh-CN/data/release-notes/2-20/6.yml index 568f19954f1a..131b12785526 100644 --- a/translations/zh-CN/data/release-notes/2-20/6.yml +++ b/translations/zh-CN/data/release-notes/2-20/6.yml @@ -21,7 +21,7 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/7.yml b/translations/zh-CN/data/release-notes/2-20/7.yml index b377d90b668f..cffb081e8fa2 100644 --- a/translations/zh-CN/data/release-notes/2-20/7.yml +++ b/translations/zh-CN/data/release-notes/2-20/7.yml @@ -15,7 +15,7 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/8.yml b/translations/zh-CN/data/release-notes/2-20/8.yml index 510bf779fb0b..a489484d3244 100644 --- a/translations/zh-CN/data/release-notes/2-20/8.yml +++ b/translations/zh-CN/data/release-notes/2-20/8.yml @@ -14,7 +14,7 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-20/9.yml b/translations/zh-CN/data/release-notes/2-20/9.yml index 326818d7116f..3d0872511210 100644 --- a/translations/zh-CN/data/release-notes/2-20/9.yml +++ b/translations/zh-CN/data/release-notes/2-20/9.yml @@ -11,7 +11,7 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Dependency graph is not detecting dependencies when deployed in a cluster configuration with multiple Redis nodes. (updated 2020-06-30) {% comment %} https://github.com/github/dependency-graph/issues/81 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-21/0.yml b/translations/zh-CN/data/release-notes/2-21/0.yml index cfd8a069f8b1..ff49deab480c 100644 --- a/translations/zh-CN/data/release-notes/2-21/0.yml +++ b/translations/zh-CN/data/release-notes/2-21/0.yml @@ -66,7 +66,7 @@ sections: - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' - - 'When pushing to a gist, an exception could be triggered during the post-receive hook. {% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' + - '推送到 gist 时，可能会在后接收挂钩时触发异常。{% comment %} https://github.com/github/github/issues/129091 {% endcomment %}' - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' - - 'Security alerts are not reported when pushing to a repository on the command line. (updated 2020-06-23) {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' + - '推送到命令行上的仓库时，不会报告安全警报。（更新时间：2020-06-23）{% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' - 'Audit logs may be attributed to 127.0.0.1 instead of the actual source IP address. (updated 2020-11-02) {% comment %} https://github.com/github/enterprise2/issues/21514 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-21/14.yml b/translations/zh-CN/data/release-notes/2-21/14.yml new file mode 100644 index 000000000000..97d5bac00ab3 --- /dev/null +++ b/translations/zh-CN/data/release-notes/2-21/14.yml @@ -0,0 +1,13 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1021, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24352, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' + - 'Security alerts are not reported when pushing to a repository on the command line. {% comment %} https://github.com/github/github/issues/143190 {% endcomment %}' diff --git a/translations/zh-CN/data/release-notes/2-22/6.yml b/translations/zh-CN/data/release-notes/2-22/6.yml new file mode 100644 index 000000000000..971924052fb5 --- /dev/null +++ b/translations/zh-CN/data/release-notes/2-22/6.yml @@ -0,0 +1,18 @@ +--- +date: '2020-12-17' +sections: + security_fixes: + - '**LOW:** High CPU usage could be triggered by a specially crafted request to the SVN bridge resulting in Denial of Service (DoS). {% comment %} https://github.com/github/slumlord/pull/1022, https://github.com/github/slumlord/pull/1017 {% endcomment %}' + - 'Packages have been updated to the latest security versions. {% comment %} https://github.com/github/enterprise2/pull/24353, https://github.com/github/enterprise2/pull/23866 {% endcomment %}' + bugs: + - 'Requests for some file resources like a zip archive or raw file could enter a redirection loop. {% comment %} https://github.com/github/enterprise2/pull/24193, https://github.com/github/enterprise2/pull/24075 {% endcomment %}' + - 'A timeout could prevent some Issues and Pull Requests searches from providing complete search results. {% comment %} https://github.com/github/github/pull/164155, https://github.com/github/github/pull/163845 {% endcomment %}' + - 'Custom tabs with non-alphabetic characters in small screens did not render correctly. {% comment %} https://github.com/github/github/pull/164310, https://github.com/github/github/pull/164159 {% endcomment %}' + - 'An underlying behavior was causing failures when pushing content to a Git LFS-enabled repository. {% comment %} https://github.com/github/github/pull/164663, https://github.com/github/github/pull/150179 {% endcomment %}' + - 'In some rare cases issues could cause a 500 error when accessed via the web interface. {% comment %} https://github.com/github/github/pull/165298, https://github.com/github/github/pull/159674 {% endcomment %}' + known_issues: + - 'On a freshly set up GitHub Enterprise Server without any users, an attacker could create the first admin user. {% comment %} https://github.com/github/enterprise2/issues/1889 {% endcomment %}' + - 'Custom firewall rules are not maintained during an upgrade. {% comment %} https://github.com/github/enterprise2/issues/2823 {% endcomment %}' + - 'Git LFS tracked files [uploaded through the web interface](https://github.com/blog/2105-upload-files-to-your-repositories) are incorrectly added directly to the repository. {% comment %} https://github.com/github/github/issues/54684 {% endcomment %}' + - 'Issues cannot be closed if they contain a permalink to a blob in the same repository where the file path is longer than 255 characters. {% comment %} https://github.com/github/github/issues/107731 {% endcomment %}' + - 'When "Users can search GitHub.com" is enabled with GitHub Connect, issues in private and internal repositories are not included in GitHub.com search results. {% comment %} https://github.com/github/admin-experience/issues/571 {% endcomment %}' diff --git a/translations/zh-CN/data/reusables/actions/environments-beta.md b/translations/zh-CN/data/reusables/actions/environments-beta.md new file mode 100644 index 000000000000..5fe1386417b5 --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/environments-beta.md @@ -0,0 +1,9 @@ +{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@3.0" %} + +{% note %} + +**Note:** Environments, environment protection rules, and environment secrets are currently in beta and subject to change. + +{% endnote %} + +{% endif %} diff --git a/translations/zh-CN/data/reusables/actions/forked-secrets.md b/translations/zh-CN/data/reusables/actions/forked-secrets.md new file mode 100644 index 000000000000..b294a32b2f31 --- /dev/null +++ b/translations/zh-CN/data/reusables/actions/forked-secrets.md @@ -0,0 +1 @@ +除了 `GITHUB_TOKEN` 以外，从复刻的仓库触发工作流程时密码不会传递给运行程序。 diff --git a/translations/zh-CN/data/reusables/classroom/assignments-classroom-prerequisite.md b/translations/zh-CN/data/reusables/classroom/assignments-classroom-prerequisite.md index 06284dad51ae..fec0ecbfe98e 100644 --- a/translations/zh-CN/data/reusables/classroom/assignments-classroom-prerequisite.md +++ b/translations/zh-CN/data/reusables/classroom/assignments-classroom-prerequisite.md @@ -1 +1 @@ -You must create a classroom before you can create an assignment. For more information, see "[Manage classrooms](/education/manage-coursework-with-github-classroom/manage-classrooms)." +You must create a classroom before you can create an assignment. 更多信息请参阅“[管理教室](/education/manage-coursework-with-github-classroom/manage-classrooms)”。 diff --git a/translations/zh-CN/data/reusables/classroom/click-classroom-in-list.md b/translations/zh-CN/data/reusables/classroom/click-classroom-in-list.md index fe7d091cdc72..894359947511 100644 --- a/translations/zh-CN/data/reusables/classroom/click-classroom-in-list.md +++ b/translations/zh-CN/data/reusables/classroom/click-classroom-in-list.md @@ -1 +1 @@ -1. In the list of classrooms, click the classroom you want to view. ![Classroom in list of classrooms for an organization](/assets/images/help/classroom/click-classroom-in-list.png) +1. In the list of classrooms, click the classroom you want to view. ![组织教室列表中的教室](/assets/images/help/classroom/click-classroom-in-list.png) diff --git a/translations/zh-CN/data/reusables/classroom/for-more-information-about-assignment-creation.md b/translations/zh-CN/data/reusables/classroom/for-more-information-about-assignment-creation.md index 8fd113d76353..d84d4b3473f1 100644 --- a/translations/zh-CN/data/reusables/classroom/for-more-information-about-assignment-creation.md +++ b/translations/zh-CN/data/reusables/classroom/for-more-information-about-assignment-creation.md @@ -1 +1 @@ -For more information, see "[Create an individual assignment](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)" or "[Create a group assignment](/education/manage-coursework-with-github-classroom/create-a-group-assignment)." +更多信息请参阅“[创建个人作业](/education/manage-coursework-with-github-classroom/create-an-individual-assignment)”或“[创建小组作业](/education/manage-coursework-with-github-classroom/create-a-group-assignment)”。 diff --git a/translations/zh-CN/data/reusables/cli/filter-issues-and-pull-requests-tip.md b/translations/zh-CN/data/reusables/cli/filter-issues-and-pull-requests-tip.md index d4bd8f1d7f5d..41c7bd066edc 100644 --- a/translations/zh-CN/data/reusables/cli/filter-issues-and-pull-requests-tip.md +++ b/translations/zh-CN/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" or currentVersion == "github-ae@latest" %} {% tip %} -**提示**：您也可以使用 {% 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 %} 过滤议题或拉取请求。 更多信息请参阅 {% data variables.product.prodname_cli %} 文档中的 "[`gh issue list`](https://cli.github.com/manual/gh_issue_list)" 或 "[`gh pr list`](https://cli.github.com/manual/gh_pr_list)"。 {% endtip %} {% endif %} 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 4164cef0885c..e13cb3f19d07 100644 --- a/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md +++ b/translations/zh-CN/data/reusables/dependabot/supported-package-managers.md @@ -25,6 +25,8 @@ The following table shows, for each package manager, whether {% data variables.p -`yarn`（仅限 v1）（指定 `npm`） +-`.gradle.kts` files, for Kotlin projects (specify `gradle`) + -`pipenv`、`pip-compile` 和 `poetry`（指定 `pip`） 例如，如果您使用 `poetry` 来管理 Python 依赖项，并且希望 {% data variables.product.prodname_dependabot %} 监控新版本的依赖项清单文件，请在 *dependabot.yml* 文件中使用 `package-ecosystem: "pip"`。 diff --git a/translations/zh-CN/data/reusables/developer-site/pull_request_forked_repos_link.md b/translations/zh-CN/data/reusables/developer-site/pull_request_forked_repos_link.md index 87ddc620facb..a3e76b2d0598 100644 --- a/translations/zh-CN/data/reusables/developer-site/pull_request_forked_repos_link.md +++ b/translations/zh-CN/data/reusables/developer-site/pull_request_forked_repos_link.md @@ -10,4 +10,4 @@ 默认情况下，工作流程不在复刻仓库上运行。 您必须在复刻仓库的 **Actions（操作）**选项卡中启用 GitHub 操作。 -对复刻的仓库中 `GITHUB_TOKEN` 的权限为只读。 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 +{% data reusables.actions.forked-secrets %} The permissions for the `GITHUB_TOKEN` in forked repositories is read-only. 更多信息请参阅“[使用 GITHUB_TOKEN 验证身份](/actions/configuring-and-managing-workflows/authenticating-with-the-github_token)”。 diff --git a/translations/zh-CN/data/reusables/discussions/click-discussion-in-list.md b/translations/zh-CN/data/reusables/discussions/click-discussion-in-list.md index 8156c86331db..1fc74494bea0 100644 --- a/translations/zh-CN/data/reusables/discussions/click-discussion-in-list.md +++ b/translations/zh-CN/data/reusables/discussions/click-discussion-in-list.md @@ -1 +1 @@ -1. In the list of discussions, click the discussion you want to view. ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) +1. 在讨论列表中，单击要查看的讨论。 ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png) diff --git a/translations/zh-CN/data/reusables/discussions/edit-category-details.md b/translations/zh-CN/data/reusables/discussions/edit-category-details.md index 8004b70314c3..a655564c9c80 100644 --- a/translations/zh-CN/data/reusables/discussions/edit-category-details.md +++ b/translations/zh-CN/data/reusables/discussions/edit-category-details.md @@ -1 +1 @@ -Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." +编辑类别的表情符号、标题、说明和讨论格式。 For more information about discussion formats, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." diff --git a/translations/zh-CN/data/reusables/discussions/marking-a-comment-as-an-answer.md b/translations/zh-CN/data/reusables/discussions/marking-a-comment-as-an-answer.md index bdefffdea0d8..7b59b0c5cc22 100644 --- a/translations/zh-CN/data/reusables/discussions/marking-a-comment-as-an-answer.md +++ b/translations/zh-CN/data/reusables/discussions/marking-a-comment-as-an-answer.md @@ -1,4 +1,4 @@ -You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)." +You can mark a comment in the discussion as an answer to the discussion if a discussion is within a category that accepts answers. 更多信息请参阅“[关于讨论](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)”。 When you mark a question as an answer, {% data variables.product.product_name %} will highlight the comment and replies to the comment to help visitors quickly find the answer. diff --git a/translations/zh-CN/data/reusables/education/apply-for-team.md b/translations/zh-CN/data/reusables/education/apply-for-team.md index 85c543c340af..3e298c49a75f 100644 --- a/translations/zh-CN/data/reusables/education/apply-for-team.md +++ b/translations/zh-CN/data/reusables/education/apply-for-team.md @@ -1 +1 @@ -- 申请免费 [{% data variables.product.prodname_team %}](/articles/github-s-products)，允许无限制的用户和私有仓库。 For more information, see "[Apply for an educator or researcher discount](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)." +- 申请免费 [{% data variables.product.prodname_team %}](/articles/github-s-products)，允许无限制的用户和私有仓库。 更多信息请参阅“[申请教育者或研究人员折扣](/education/teach-and-learn-with-github-education/apply-for-an-educator-or-researcher-discount)”。 diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/verified-domains-tab.md b/translations/zh-CN/data/reusables/enterprise-accounts/verified-domains-tab.md new file mode 100644 index 000000000000..35420a6888e3 --- /dev/null +++ b/translations/zh-CN/data/reusables/enterprise-accounts/verified-domains-tab.md @@ -0,0 +1 @@ +1. Under "Settings", click **Verified domains**. !["Verified domains" tab](/assets/images/help/enterprises/verified-domains-tab.png) \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/enterprise-accounts/verifying-domains-release-phase.md b/translations/zh-CN/data/reusables/enterprise-accounts/verifying-domains-release-phase.md new file mode 100644 index 000000000000..331fb63c15e0 --- /dev/null +++ b/translations/zh-CN/data/reusables/enterprise-accounts/verifying-domains-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Verifying an enterprise account's domain is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/gated-features/actions-shared.md b/translations/zh-CN/data/reusables/gated-features/actions-shared.md new file mode 100644 index 000000000000..4fe8fa43b17f --- /dev/null +++ b/translations/zh-CN/data/reusables/gated-features/actions-shared.md @@ -0,0 +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 %} 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 diff --git a/translations/zh-CN/data/reusables/gated-features/actions.md b/translations/zh-CN/data/reusables/gated-features/actions.md index 1bceb3c7bd53..bafbe8fae92d 100644 --- a/translations/zh-CN/data/reusables/gated-features/actions.md +++ b/translations/zh-CN/data/reusables/gated-features/actions.md @@ -1 +1 @@ -{{ 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 %} +{% data reusables.gated-features.actions-shared %} {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/zh-CN/data/reusables/gated-features/auto-merge.md b/translations/zh-CN/data/reusables/gated-features/auto-merge.md new file mode 100644 index 000000000000..72a58ba07dd8 --- /dev/null +++ b/translations/zh-CN/data/reusables/gated-features/auto-merge.md @@ -0,0 +1 @@ +Auto-merge for pull requests 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" %}{% data reusables.gated-features.more-info %}{% endif %} \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/gated-features/environments.md b/translations/zh-CN/data/reusables/gated-features/environments.md new file mode 100644 index 000000000000..77cd45f6aa02 --- /dev/null +++ b/translations/zh-CN/data/reusables/gated-features/environments.md @@ -0,0 +1 @@ +{% data reusables.gated-features.actions-shared %} Environments, environment protection rules, and environment secrets are available in public repositories for all products and in private repositories for {% data variables.product.prodname_ghe_server %}. {% if currentVersion == "free-pro-team@latest" %}{% data reusables.gated-features.more-info %}{% endif %} diff --git a/translations/zh-CN/data/reusables/github-actions/permissions-statement-environment.md b/translations/zh-CN/data/reusables/github-actions/permissions-statement-environment.md new file mode 100644 index 000000000000..8dfdbb1403cd --- /dev/null +++ b/translations/zh-CN/data/reusables/github-actions/permissions-statement-environment.md @@ -0,0 +1 @@ +To configure an environment in a user account repository, you must be the repository owner. To configure an environment in an organization repository, you must have `admin` access. diff --git a/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-environment.md b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-environment.md new file mode 100644 index 000000000000..c9445ab95e91 --- /dev/null +++ b/translations/zh-CN/data/reusables/github-actions/permissions-statement-secrets-environment.md @@ -0,0 +1 @@ +To create secrets for an environment in a user account repository, you must be the repository owner. To create secrets for an environment in an organization repository, you must have `admin` access. diff --git a/translations/zh-CN/data/reusables/github-actions/sidebar-environment.md b/translations/zh-CN/data/reusables/github-actions/sidebar-environment.md new file mode 100644 index 000000000000..26955b2ce475 --- /dev/null +++ b/translations/zh-CN/data/reusables/github-actions/sidebar-environment.md @@ -0,0 +1 @@ +1. In the left sidebar, click **Environments**. 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 5ac15f6c4408..02fb50c857e6 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 @@ -1,10 +1,10 @@ -| 名称 | 类型 | 描述 | -| ------------ | ----- | ------------------------------------------------------------------------- | -| `id` | `整数` | The unique identifier of the event. | -| `node_id` | `字符串` | The [Global Node ID](/graphql/guides/using-global-node-ids) of the event. | -| `url` | `字符串` | 用于提取事件的 REST API URL。 | -| `actor` | `对象` | The person who generated the event. | -| `event` | `字符串` | 识别所发生事件的实际类型。 | -| `commit_id` | `字符串` | 引用此议题的提交的 SHA。 | -| `commit_url` | `字符串` | 指向引用此议题的提交的 GitHub REST API 链接。 | -| `created_at` | `字符串` | 指示事件发生时间的时间戳。 | +| 名称 | 类型 | 描述 | +| ------------ | ----- | ---------------------------------------------------- | +| `id` | `整数` | 事件的唯一标识符。 | +| `node_id` | `字符串` | 事件的[全局节点 ID](/graphql/guides/using-global-node-ids)。 | +| `url` | `字符串` | 用于提取事件的 REST API URL。 | +| `actor` | `对象` | 生成事件的人。 | +| `event` | `字符串` | 识别所发生事件的实际类型。 | +| `commit_id` | `字符串` | 引用此议题的提交的 SHA。 | +| `commit_url` | `字符串` | 指向引用此议题的提交的 GitHub REST API 链接。 | +| `created_at` | `字符串` | 指示事件发生时间的时间戳。 | diff --git a/translations/zh-CN/data/reusables/notifications/outbound_email_tip.md b/translations/zh-CN/data/reusables/notifications/outbound_email_tip.md index 843ea8a8e066..732a48aff354 100644 --- a/translations/zh-CN/data/reusables/notifications/outbound_email_tip.md +++ b/translations/zh-CN/data/reusables/notifications/outbound_email_tip.md @@ -1,9 +1,7 @@ -{% if enterpriseServerVersions contains currentVersion %} - +{% if enterpriseServerVersions contains currentVersion or currentVersion == "github-ae@latest" %} {% note %} **Note**: You'll only receive email notifications if outbound email support is enabled on {% data variables.product.product_location %}. 更多信息请联系站点管理员。 {% endnote %} - {% endif %} diff --git a/translations/zh-CN/data/reusables/organizations/add-dns-txt-record.md b/translations/zh-CN/data/reusables/organizations/add-dns-txt-record.md new file mode 100644 index 000000000000..e43fe2031608 --- /dev/null +++ b/translations/zh-CN/data/reusables/organizations/add-dns-txt-record.md @@ -0,0 +1 @@ +1. 按照 **Add a DNS TXT record（添加 DNS TXT 记录）**下的说明操作，使用您的域托管服务创建 DNS TXT 记录。 ![创建 DNS txt 记录的说明](/assets/images/help/organizations/create-dns-txt-record-instructions.png) \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/organizations/add-domain.md b/translations/zh-CN/data/reusables/organizations/add-domain.md new file mode 100644 index 000000000000..9fdb36d978ac --- /dev/null +++ b/translations/zh-CN/data/reusables/organizations/add-domain.md @@ -0,0 +1 @@ +1. 在域字段中，输入您想要验证的域，然后单击 **Add domain（添加域）**。 ![添加域字段](/assets/images/help/organizations/add-domain-field.png) \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/organizations/continue-verifying-domain.md b/translations/zh-CN/data/reusables/organizations/continue-verifying-domain.md new file mode 100644 index 000000000000..5ede5bf7021a --- /dev/null +++ b/translations/zh-CN/data/reusables/organizations/continue-verifying-domain.md @@ -0,0 +1,2 @@ +9. To the right of the domain that's pending verification, click {% octicon "kebab-horizontal" aria-label="The horizontal kebab icon" %}, then click **Continue verifying**. ![继续验证域按钮](/assets/images/help/organizations/continue-verifying-domain.png) +10. 单击 **Verify domain（验证域）**。 ![验证域按钮](/assets/images/help/organizations/verify-domain-final-button.png) \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/organizations/restrict-email-notifications.md b/translations/zh-CN/data/reusables/organizations/restrict-email-notifications.md new file mode 100644 index 000000000000..8ade4a0278bb --- /dev/null +++ b/translations/zh-CN/data/reusables/organizations/restrict-email-notifications.md @@ -0,0 +1 @@ +1. 在“Enforcement preferences（强制执行首选项）”下，选择 **Restrict email notifications to domain email（将电子邮件通知限制为域电子邮件）**。 ![将电子邮件通知限制为经验证域电子邮件的复选框](/assets/images/help/organizations/restrict-email-notifications-to-domain.png) \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/organizations/verified-domains-details.md b/translations/zh-CN/data/reusables/organizations/verified-domains-details.md new file mode 100644 index 000000000000..a7a2d93ab1bb --- /dev/null +++ b/translations/zh-CN/data/reusables/organizations/verified-domains-details.md @@ -0,0 +1 @@ +To display a "Verified" badge, the website and email information shown on an organization's profile must match the verified domain or domains. 如果组织资料中显示的网站和电子邮件地址在不同的域中托管，则必须验证两个域。 If the website and email address use variants of the same domain, you must verify both variants. For example, if the profile shows the website `www.example.com` and the email address `info@example.com`, you would need to verify both `www.example.com` and `example.com`. \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/pages/wildcard-dns-warning.md b/translations/zh-CN/data/reusables/pages/wildcard-dns-warning.md new file mode 100644 index 000000000000..fffdfe91321d --- /dev/null +++ b/translations/zh-CN/data/reusables/pages/wildcard-dns-warning.md @@ -0,0 +1,5 @@ +{% warning %} + +**警告：**我们强烈建议不要使用通配符 DNS 记录，例如 `*.example.com`。 通配符 DNS 记录将允许任何人在您的其中一个子域上托管 {% data variables.product.prodname_pages %} 站点。 + +{% endwarning %} 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 35f0aabf4c3d..2a94ae254476 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,5 +1 @@ -{% if currentVersion == "free-pro-team@latest" or currentVersion ver_gt "enterprise-server@2.21" or currentVersion == "github-ae@latest" %} -挂起 -{% data variables.product.prodname_github_app %} 安装目前处于测试阶段，可能会有变化。 在可以挂起 {% data variables.product.prodname_github_app %} 之前，应用程序所有者必须通过选择加入测试版来启用挂起应用程序的安装。 要选择加入挂起安装测试版功能，请参阅“[激活应用程序的测试版功能](/developers/apps/activating-beta-features-for-apps)”。 - -{% endif %} +Suspending a {% data variables.product.prodname_github_app %} installation is currently in beta and subject to change. 在可以挂起 {% data variables.product.prodname_github_app %} 之前，应用程序所有者必须通过选择加入测试版来启用挂起应用程序的安装。 要选择加入挂起安装测试版功能，请参阅“[激活应用程序的测试版功能](/developers/apps/activating-beta-features-for-apps)”。 diff --git a/translations/zh-CN/data/reusables/pull_requests/auto-merge-release-phase.md b/translations/zh-CN/data/reusables/pull_requests/auto-merge-release-phase.md new file mode 100644 index 000000000000..1dd38f1187d0 --- /dev/null +++ b/translations/zh-CN/data/reusables/pull_requests/auto-merge-release-phase.md @@ -0,0 +1,5 @@ +{% note %} + +**Note:** Auto-merge for pull requests is currently in beta and subject to change. + +{% endnote %} \ No newline at end of file diff --git a/translations/zh-CN/data/reusables/pull_requests/you-can-auto-merge.md b/translations/zh-CN/data/reusables/pull_requests/you-can-auto-merge.md new file mode 100644 index 000000000000..410aec2a8ee8 --- /dev/null +++ b/translations/zh-CN/data/reusables/pull_requests/you-can-auto-merge.md @@ -0,0 +1,3 @@ +{% if currentVersion == "free-pro-team@latest" %} +You can configure a pull request to merge automatically when all merge requirements are met. For more information, see "[Automatically merging a pull request](/github/collaborating-with-issues-and-pull-requests/automatically-merging-a-pull-request)." +{% endif %} \ No newline at end of file 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 32521de0a846..b739c0f92f7e 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. 选择您要修改的 GitHub 应用程序。 ![App selection](/assets/images/github-apps/github_apps_select-app.png) +1. 选择您要修改的 GitHub 应用程序。 ![应用程序选择](/assets/images/github-apps/github_apps_select-app.png) diff --git a/translations/zh-CN/data/reusables/user-settings/modify_oauth_app.md b/translations/zh-CN/data/reusables/user-settings/modify_oauth_app.md index 0d8071a37ad4..23b67f175800 100644 --- a/translations/zh-CN/data/reusables/user-settings/modify_oauth_app.md +++ b/translations/zh-CN/data/reusables/user-settings/modify_oauth_app.md @@ -1 +1 @@ -1. Select the {% data variables.product.prodname_oauth_app %} you want to modify. ![App selection](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png) +1. 选择要修改的 {% data variables.product.prodname_oauth_app %} 。 ![应用程序选择](/assets/images/oauth-apps/oauth_apps_choose_app_post2dot12.png)