diff --git a/translations/es-ES/content/actions/learn-github-actions/contexts.md b/translations/es-ES/content/actions/learn-github-actions/contexts.md index 0ba85ebbd1..a4fdab860d 100644 --- a/translations/es-ES/content/actions/learn-github-actions/contexts.md +++ b/translations/es-ES/content/actions/learn-github-actions/contexts.md @@ -214,6 +214,9 @@ The `github` context contains information about the workflow run and the event t {%- ifversion fpt or ghec or ghes > 3.5 or ghae > 3.4 %} | `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. | {%- endif %} +{%- ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %} +| `github.secret_source` | `string` | The source of a secret used in a workflow. Possible values are `None`, `Actions`, `Dependabot`, or `Codespaces`. | +{%- endif %} | `github.server_url` | `string` | The URL of the GitHub server. For example: `https://github.com`. | | `github.sha` | `string` | {% data reusables.actions.github_sha_description %} | | `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)."
Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |{% ifversion actions-stable-actor-ids %} diff --git a/translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md b/translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md index ef9385001a..fa49ebc9f5 100644 --- a/translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md +++ b/translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Habilitación de Dependabot para la empresa -intro: 'Puedes permitir que los usuarios de {% data variables.product.product_location %} busquen y corrijan vulnerabilidades en sus dependencias de código mediante la habilitación de {% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} y {% data variables.product.prodname_dependabot_updates %}{% endif %}.' +title: Enabling Dependabot for your enterprise +intro: 'You can allow users of {% data variables.product.product_location %} to find and fix vulnerabilities in code dependencies by enabling {% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} and {% data variables.product.prodname_dependabot_updates %}{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Dependabot redirect_from: @@ -22,107 +22,112 @@ topics: - Security - Dependency graph - Dependabot -ms.openlocfilehash: 271e0ad3a81ea8c8cefac9c4a4db6e18ecad5069 -ms.sourcegitcommit: fb047f9450b41b24afc43d9512a5db2a2b750a2a -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '146455577' --- -## Acerca de {% data variables.product.prodname_dependabot %} para {% data variables.product.product_name %} -{% data variables.product.prodname_dependabot %} ayuda a que los usuarios de {% data variables.product.product_location %} busquen y corrijan vulnerabilidades en sus dependencias.{% ifversion ghes > 3.2 %} Puede habilitar {% data variables.product.prodname_dependabot_alerts %} para notificar a los usuarios las dependencias vulnerables y {% data variables.product.prodname_dependabot_updates %} para corregir las vulnerabilidades y mantener actualizadas las dependencias a la versión más reciente. +## About {% data variables.product.prodname_dependabot %} for {% data variables.product.product_name %} -### Acerca de {% data variables.product.prodname_dependabot_alerts %} +{% data variables.product.prodname_dependabot %} helps users of {% data variables.product.product_location %} find and fix vulnerabilities in their dependencies.{% ifversion ghes > 3.2 %} You can enable {% data variables.product.prodname_dependabot_alerts %} to notify users about vulnerable dependencies and {% data variables.product.prodname_dependabot_updates %} to fix the vulnerabilities and keep dependencies updated to the latest version. + +### About {% data variables.product.prodname_dependabot_alerts %} {% endif %} {% data reusables.dependabot.dependabot-alerts-beta %} -Con {% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dotcom %} identifica las dependencias no seguras en los repositorios y crea alertas sobre {% data variables.product.product_location %} mediante el uso de datos de {% data variables.product.prodname_advisory_database %} y el servicio de gráfico de dependencias. +With {% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dotcom %} identifies insecure dependencies in repositories and creates alerts on {% data variables.product.product_location %}, using data from the {% data variables.product.prodname_advisory_database %} and the dependency graph service. {% data reusables.repositories.tracks-vulnerabilities %} -Después de habilitar {% data variables.product.prodname_dependabot_alerts %} para la empresa, los datos de vulnerabilidad se sincronizan desde {% data variables.product.prodname_advisory_database %} con la instancia una vez cada hora. Únicamente se sincronizan las asesorías que revisa {% data variables.product.company_short %}. {% data reusables.security-advisory.link-browsing-advisory-db %} +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, vulnerability data is synced from the {% data variables.product.prodname_advisory_database %} to your instance once every hour. Only {% data variables.product.company_short %}-reviewed advisories are synchronized. {% data reusables.security-advisory.link-browsing-advisory-db %} -También puedes elegir sincronizar manualmente los datos de vulnerabilidad en cualquier momento. Para más información, vea "[Visualización de los datos de vulnerabilidad de la empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)". +You can also choose to manually sync vulnerability data at any time. For more information, see "[Viewing the vulnerability data for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)." {% note %} -**Nota**: Al habilitar {% data variables.product.prodname_dependabot_alerts %}, no se carga ningún código ni información sobre el código de {% data variables.product.product_location %} en {% data variables.product.prodname_dotcom_the_website %}. +**Note:** When you enable {% data variables.product.prodname_dependabot_alerts %}, no code or information about code from {% data variables.product.product_location %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. {% endnote %} -Cuando {% data variables.product.product_location %} recibe información sobre una vulnerabilidad, identifica los repositorios de {% data variables.product.product_location %} en los que se usa la versión afectada de la dependencia y genera {% data variables.product.prodname_dependabot_alerts %}. Puedes elegir si quieres notificar a los usuarios automáticamente acerca de las {% data variables.product.prodname_dependabot_alerts %} nuevas o no. +When {% data variables.product.product_location %} receives information about a vulnerability, it identifies repositories in {% data variables.product.product_location %} that use the affected version of the dependency and generates {% data variables.product.prodname_dependabot_alerts %}. You can choose whether or not to notify users automatically about new {% data variables.product.prodname_dependabot_alerts %}. -Para los repositorios que cuenten con las {% data variables.product.prodname_dependabot_alerts %} habilitadas, el escaneo se activa en cualquier subida a la rama predeterminada. Además, cuando se agrega un nuevo registro de vulnerabilidad a {% data variables.product.product_location %}, {% data variables.product.product_name %} examina todos los repositorios existentes en {% data variables.product.product_location %} y genera alertas para cualquier repositorio vulnerable. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". +For repositories with {% data variables.product.prodname_dependabot_alerts %} enabled, scanning is triggered on any push to the default branch that contains a manifest file or lock file. Additionally, when a new vulnerability record is added to {% data variables.product.product_location %}, {% data variables.product.product_name %} scans all existing repositories on {% data variables.product.product_location %} and generates alerts for any repository that is vulnerable. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." {% ifversion ghes > 3.2 %} -### Acerca de {% data variables.product.prodname_dependabot_updates %} +### About {% data variables.product.prodname_dependabot_updates %} {% data reusables.dependabot.beta-security-and-version-updates %} -Después de habilitar {% data variables.product.prodname_dependabot_alerts %}, puede habilitar {% data variables.product.prodname_dependabot_updates %}. Cuando se habilitan {% data variables.product.prodname_dependabot_updates %} para {% data variables.product.product_location %}, los usuarios pueden configurar los repositorios para que sus dependencias se actualicen y se mantengan seguras de forma automática. +After you enable {% data variables.product.prodname_dependabot_alerts %}, you can choose to enable {% data variables.product.prodname_dependabot_updates %}. When {% data variables.product.prodname_dependabot_updates %} are enabled for {% data variables.product.product_location %}, users can configure repositories so that their dependencies are updated and kept secure automatically. {% note %} -**Nota:** {% data variables.product.prodname_dependabot_updates %} en {% data variables.product.product_name %} necesita {% data variables.product.prodname_actions %} con ejecutores autohospedados. +**Note:** {% data variables.product.prodname_dependabot_updates %} on {% data variables.product.product_name %} requires {% data variables.product.prodname_actions %} with self-hosted runners. {% endnote %} -De forma predeterminada, los ejecutores de {% data variables.product.prodname_actions %} que usa {% data variables.product.prodname_dependabot %} necesitan acceso a Internet para descargar paquetes actualizados de administradores de paquetes ascendentes. Para {% data variables.product.prodname_dependabot_updates %} con tecnología de {% data variables.product.prodname_github_connect %}, el acceso a Internet proporciona a los ejecutores un token que permite el acceso a dependencias y avisos hospedados en {% data variables.product.prodname_dotcom_the_website %}. +By default, {% data variables.product.prodname_actions %} runners used by {% data variables.product.prodname_dependabot %} need access to the internet, to download updated packages from upstream package managers. For {% data variables.product.prodname_dependabot_updates %} powered by {% data variables.product.prodname_github_connect %}, internet access provides your runners with a token that allows access to dependencies and advisories hosted on {% data variables.product.prodname_dotcom_the_website %}. -Con {% data variables.product.prodname_dependabot_updates %}, {% data variables.product.company_short %} crea automáticamente solicitudes de incorporación de cambios para actualizar las dependencias de dos maneras. +With {% data variables.product.prodname_dependabot_updates %}, {% data variables.product.company_short %} automatically creates pull requests to update dependencies in two ways. -- **{% data variables.product.prodname_dependabot_version_updates %}** : los usuarios agregan un archivo de configuración de {% data variables.product.prodname_dependabot %} al repositorio a fin de habilitar {% data variables.product.prodname_dependabot %} para crear solicitudes de incorporación de cambios cuando se publique una versión nueva de una dependencia de la que se realiza el seguimiento. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)". -- **{% data variables.product.prodname_dependabot_security_updates %}** : los usuarios pueden alternar un valor del repositorio a fin de habilitar {% data variables.product.prodname_dependabot %} para crear solicitudes de incorporación de cambios cuando {% data variables.product.prodname_dotcom %} detecte una vulnerabilidad en una de las dependencias del gráfico de dependencias del repositorio. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)" y "[Acerca de {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)". +- **{% data variables.product.prodname_dependabot_version_updates %}**: Users add a {% data variables.product.prodname_dependabot %} configuration file to the repository to enable {% data variables.product.prodname_dependabot %} to create pull requests when a new version of a tracked dependency is released. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +- **{% data variables.product.prodname_dependabot_security_updates %}**: Users toggle a repository setting to enable {% data variables.product.prodname_dependabot %} to create pull requests when {% data variables.product.prodname_dotcom %} detects a vulnerability in one of the dependencies of the dependency graph for the repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)" and "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)." {% endif %} -## Habilitación de {% data variables.product.prodname_dependabot_alerts %} +## Enabling {% data variables.product.prodname_dependabot_alerts %} -Antes de poder habilitar {% data variables.product.prodname_dependabot_alerts %}: -- Debe habilitar {% data variables.product.prodname_github_connect %}. Para más información, vea "[Administración de {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/managing-github-connect)".{% ifversion ghes %} -- Debes conectar la gráfica de dependencias. Para más información, vea "[Habilitación del gráfico de dependencias para la empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)".{% endif %} +Before you can enable {% data variables.product.prodname_dependabot_alerts %}: +- You must enable {% data variables.product.prodname_github_connect %}. For more information, see "[Managing {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/managing-github-connect)."{% ifversion ghes %} +- You must enable the dependency graph. For more information, see "[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)."{% endif %} -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} {%- ifversion dependabot-updates-github-connect %} -1. En "{% data variables.product.prodname_dependabot %}", a la derecha de "Los usuarios pueden recibir alertas de vulnerabilidad para dependencias de código abierto", seleccione el menú desplegable y haga clic en **Habilitado sin notificaciones**. Opcionalmente, para habilitar las alertas con notificaciones, haga clic en **Habilitado con notificaciones**. +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +{%- ifversion dependabot-updates-github-connect %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can receive vulnerability alerts for open source code dependencies", select the dropdown menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. - ![Captura de pantalla del menú desplegable a fin de habilitar el examen de repositorios para detectar vulnerabilidades](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) + ![Screenshot of the dropdown menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) {%- else %} -1. En "Los repositorios se pueden examinar para buscar vulnerabilidades", seleccione el menú desplegable y haga clic en **Habilitado sin notificaciones**. Opcionalmente, para habilitar las alertas con notificaciones, haga clic en **Habilitado con notificaciones**. - ![Menú desplegable para habilitar el examen de repositorios para buscar vulnerabilidades](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) {%- endif %} {% tip %} +1. Under "Repositories can be scanned for vulnerabilities", select the drop-down menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. + ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) +{%- endif %} + {% tip %} - **Sugerencia**: Le recomendamos configurar {% data variables.product.prodname_dependabot_alerts %} sin notificaciones durante los primeros días para evitar una sobrecarga de correos electrónicos. Después de varios días, puede habilitar las notificaciones para recibir {% data variables.product.prodname_dependabot_alerts %} de la forma habitual. + **Tip**: We recommend configuring {% data variables.product.prodname_dependabot_alerts %} without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_alerts %} as usual. {% endtip %} {% ifversion dependabot-updates-github-connect %} -## Habilitación de {% data variables.product.prodname_dependabot_updates %} +## Enabling {% data variables.product.prodname_dependabot_updates %} -Después de habilitar {% data variables.product.prodname_dependabot_alerts %} para la empresa, puede habilitar {% data variables.product.prodname_dependabot_updates %}. +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, you can enable {% data variables.product.prodname_dependabot_updates %}. -{% ifversion ghes %} Antes de habilitar {% data variables.product.prodname_dependabot_updates %}, debe configurar {% data variables.product.product_location %} para usar {% data variables.product.prodname_actions %} con ejecutores autohospedados. Para más información, vea "[Introducción a {% data variables.product.prodname_actions %} para GitHub Enterprise Server](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)". +{% ifversion ghes %} +{% data reusables.dependabot.enabling-actions-for-ghes %} For more information, see "[Getting started with {% data variables.product.prodname_actions %} for GitHub Enterprise Server](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)." -{% data variables.product.prodname_dependabot_updates %} no se admiten en los datos {% data variables.product.product_name %} si en la empresa se usa la agrupación en clústeres. +{% data variables.product.prodname_dependabot_updates %} are not supported on {% data variables.product.product_name %} if your enterprise uses clustering. {% endif %} -{% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. En "Seguridad", seleccione **{% data variables.product.prodname_dependabot_security_updates %}** . +{% data reusables.enterprise_site_admin_settings.sign-in %} +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.advanced-security-tab %} +1. Under "Security", select **{% data variables.product.prodname_dependabot_security_updates %}**. - ![Captura de pantalla de la casilla para habilitar o deshabilitar {% data variables.product.prodname_dependabot_security_updates %}](/assets/images/enterprise/management-console/enable-dependabot-updates.png) + ![Screenshot of the checkbox to enable or disable {% data variables.product.prodname_dependabot_security_updates %}](/assets/images/enterprise/management-console/enable-dependabot-updates.png) {% data reusables.enterprise_management_console.save-settings %} -1. Haga clic en **Visitar la instancia**. -1. Configure ejecutores autohospedados para crear las solicitudes de incorporación de cambios que actualizarán las dependencias. Para más información, vea "[Administración de ejecutores autohospedados para {% data variables.product.prodname_dependabot_updates %} en la empresa](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)". -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} -1. En "{% data variables.product.prodname_dependabot %}", a la derecha de "Los usuarios pueden actualizar fácilmente a dependencias de código abierto no vulnerables", haga clic en **Habilitar**. +1. Click **Visit your instance**. +1. Configure self-hosted runners to create the pull requests that will update dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can easily upgrade to non-vulnerable open source code dependencies", click **Enable**. - ![Captura de pantalla del menú desplegable para habilitar la actualización de dependencias vulnerables](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) - -{% endif %} {% ifversion ghes > 3.2 %} - -Cuando habilitas las {% data variables.product.prodname_dependabot_alerts %}, deberías considerar también configurar las {% data variables.product.prodname_actions %} para {% data variables.product.prodname_dependabot_security_updates %}. Esta característica permite que los desarrolladores arreglen las vulnerabilidades en sus dependencias. Para más información, vea "[Administración de ejecutores autohospedados para {% data variables.product.prodname_dependabot_updates %} en la empresa](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)". - -Si necesitas una seguridad mejorada, te recomendamos que configures {% data variables.product.prodname_dependabot %} para usar registros privados. Para obtener más información, consulta "[Administración de secretos cifrados para {% data variables.product.prodname_dependabot %}](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)". + ![Screenshot of the dropdown menu to enable updating vulnerable dependencies](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) + +{% endif %} +{% ifversion ghes > 3.2 %} + +When you enable {% data variables.product.prodname_dependabot_alerts %}, you should consider also setting up {% data variables.product.prodname_actions %} for {% data variables.product.prodname_dependabot_security_updates %}. This feature allows developers to fix vulnerabilities in their dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." + +If you need enhanced security, we recommend configuring {% data variables.product.prodname_dependabot %} to use private registries. For more information, see "[Managing encrypted secrets for {% data variables.product.prodname_dependabot %}](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)." {% endif %} diff --git a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md index e4c5db0a41..5ec3ef3506 100644 --- a/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/es-ES/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md @@ -108,9 +108,12 @@ If you allow members to create repositories in your organizations, you can choos ![Screenshot showing the list of disabled options from forking policy](/assets/images/help/business-accounts/restrict-personal-namespace-enabled-setting.png){% endif %} ## Enforcing a policy for forking private or internal repositories - Across all organizations owned by your enterprise, you can allow people with access to a private or internal repository to fork the repository, never allow forking of private or internal repositories, or allow owners to administer the setting on the organization level. +{% ifversion org-owners-limit-forks-creation %} +People with admin permissions can set a more granular forking policy. For more information, see "[Managing the forking policy for your organization](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization)." +{% endif %} + {% ifversion enterprise-namespace-repo-setting %} {% note %} @@ -122,8 +125,8 @@ Across all organizations owned by your enterprise, you can allow people with acc {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -3. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -4. Under "Repository forking", use the drop-down menu and choose a policy. +1. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +2. Under "Repository forking", use the dropdown menu and choose a policy. ![Drop-down menu with repository forking policy options](/assets/images/help/business-accounts/repository-forking-policy-drop-down.png){% ifversion innersource-fork-policies %} 5. If forking is enabled, you can specify where users are allowed to fork repositories. Review the information about changing the setting and choose a policy. diff --git a/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md b/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md index c653fba912..1885e6d052 100644 --- a/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md +++ b/translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md @@ -37,6 +37,7 @@ topics: The {% data variables.product.prodname_dependabot_security_updates %} feature is available for repositories where you have enabled the dependency graph and {% data variables.product.prodname_dependabot_alerts %}. You will see a {% data variables.product.prodname_dependabot %} alert for every vulnerable dependency identified in your full dependency graph. However, security updates are triggered only for dependencies that are specified in a manifest or lock file. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#dependencies-included)." {% ifversion dependabot-security-updates-unlock-transitive-dependencies %} + {% note %} **Note**: For npm, {% data variables.product.prodname_dependabot %} will raise a pull request to update an explicitly defined dependency to a secure version, even if it means updating the parent dependency or dependencies{% ifversion dependabot-security-updates-npm %}, or even removing a sub-dependency that is no longer needed by the parent{% endif %}. For other ecosystems, {% data variables.product.prodname_dependabot %} is unable to update an indirect or transitive dependency if it would also require an update to the parent dependency. For more information, see "[Dependabot tries to update dependencies without an alert](/en/code-security/dependabot/working-with-dependabot/troubleshooting-dependabot-errors#dependabot-tries-to-update-dependencies-without-an-alert)." @@ -47,6 +48,8 @@ You can enable a related feature, {% data variables.product.prodname_dependabot_ {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + ## About pull requests for security updates Each pull request contains everything you need to quickly and safely review and merge a proposed fix into your project. This includes information about the vulnerability like release notes, changelog entries, and commit details. Details of which vulnerability a pull request resolves are hidden from anyone who does not have access to {% data variables.product.prodname_dependabot_alerts %} for the repository. diff --git a/translations/es-ES/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md b/translations/es-ES/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md index d13417e957..7620498058 100644 --- a/translations/es-ES/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md +++ b/translations/es-ES/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md @@ -1,6 +1,6 @@ --- -title: Acerca de las actualizaciones a la versión del Dependabot -intro: 'Puede utilizar el {% data variables.product.prodname_dependabot %} para mantener los paquetes que utilizas actualizados a su versión más reciente.' +title: About Dependabot version updates +intro: 'You can use {% data variables.product.prodname_dependabot %} to keep the packages you use updated to the latest versions.' redirect_from: - /github/administering-a-repository/about-dependabot - /github/administering-a-repository/about-github-dependabot @@ -21,53 +21,51 @@ topics: - Dependencies - Pull requests shortTitle: Dependabot version updates -ms.openlocfilehash: 56bac2fbf2fb42a418cffbd478aa526803b124d9 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '145186088' --- -{% data reusables.dependabot.beta-security-and-version-updates %} {% data reusables.dependabot.enterprise-enable-dependabot %} -## Acerca de {% data variables.product.prodname_dependabot_version_updates %} +{% data reusables.dependabot.beta-security-and-version-updates %} +{% data reusables.dependabot.enterprise-enable-dependabot %} -El {% data variables.product.prodname_dependabot %} hace el esfuerzo de mantener tus dependencias. Puedes utilizarlo para garantizar que tu repositorio se mantenga automáticamente con los últimos lanzamientos de los paquetes y aplicaciones de los que depende. +## About {% data variables.product.prodname_dependabot_version_updates %} -Para habilitar {% data variables.product.prodname_dependabot_version_updates %}, comprueba un archivo de configuración `dependabot.yml` en el repositorio. Este archivo de configuración especifica la ubicación del manifiesto o de otros archivos de definición de paquetes almacenados en tu repositorio. {% data variables.product.prodname_dependabot %} usa esta información para comprobar si hay aplicaciones y paquetes obsoletos. {% data variables.product.prodname_dependabot %} determina si hay una versión nueva de una dependencia buscando el control de versiones semántico ([SemVer](https://semver.org/)) de la dependencia para decidir si debería actualizarla a esa versión. Para ciertos administradores de paquetes, {% data variables.product.prodname_dependabot_version_updates %} también es compatible con su delegación a proveedores. Las dependencias delegadas (o almacenadas en caché) son aquellas que se registran en un directorio específico en un repositorio en vez de que se referencien en un manifiesto. Las dependencias delegadas a proveedores están disponibles desde el momento de su creación, incluso si los servidores de paquetes no se encuentran disponibles. Las {% data variables.product.prodname_dependabot_version_updates %} pueden configurarse para verificar las dependencias delegadas a proveedores para las nuevas versiones y también pueden actualizarse de ser necesario. +{% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -Cuando {% data variables.product.prodname_dependabot %} identifica una dependencia obsoleta, genera una solicitud de incorporación de cambios para actualizar el manifiesto a la versión más reciente de la dependencia. Lara las dependencias delegadas a proveedores, el {% data variables.product.prodname_dependabot %} levanta una solicitud de cambios para reemplazar la dependencia desactualizada directamente con la versión nueva. Verificas que tu prueba pase, revisas el registro de cambios y notas de lanzamiento que se incluyan en el resumen de la solicitud de extracción y, posteriormente, lo fusionas. Para más información, vea "[Configuración de las actualizaciones de la versión de {% data variables.product.prodname_dependabot %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)". +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a `dependabot.yml` configuration file into your repository. The configuration file specifies the location of the manifest, or of other package definition files, stored in your repository. {% data variables.product.prodname_dependabot %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. -Si habilita las _actualizaciones de seguridad_, {% data variables.product.prodname_dependabot %} también generará solicitudes de incorporación de cambios para actualizar las dependencias vulnerables. Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)". +When {% data variables.product.prodname_dependabot %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot %} raises a pull request to replace the outdated dependency with the new version directly. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Configuring {% data variables.product.prodname_dependabot %} version updates](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)." + +If you enable _security updates_, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + {% data reusables.dependabot.dependabot-tos %} -## Frecuencia de las solicitudes de extracción del {% data variables.product.prodname_dependabot %} +## Frequency of {% data variables.product.prodname_dependabot %} pull requests -Tú eres quien especifica qué tan a menudo se revisa cada ecosistema para encontrar nuevas versiones en el archivo de configuración: diario, semanalmente, o mensualmente. +You specify how often to check each ecosystem for new versions in the configuration file: daily, weekly, or monthly. {% data reusables.dependabot.initial-updates %} -Si habilitaste las actualizaciones de seguridad, algunas veces verás solicitudes de extracción adicionales para actualizaciones de seguridad. Estas se desencadenan mediante una alerta {% data variables.product.prodname_dependabot %} para una dependencia de la rama predeterminada. El {% data variables.product.prodname_dependabot %} levanta automáticamente una solicitud de extracción para actualizar la dependencia vulnerable. +If you've enabled security updates, you'll sometimes see extra pull requests for security updates. These are triggered by a {% data variables.product.prodname_dependabot %} alert for a dependency on your default branch. {% data variables.product.prodname_dependabot %} automatically raises a pull request to update the vulnerable dependency. -## Repositorios y ecosistemas compatibles +## Supported repositories and ecosystems -Puedes configurar las actualizaciones de versión para los repositorios que contengan un manifiesto de dependencias o un archivo fijado para alguno de los administradores de paquetes compatibles. Para algunos administradores de paquetes, también puedes configurar la delegación a proveedores para las dependencias. Para más información, vea "[Opciones de configuración para el archivo dependabot.yml](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)". +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for the dependabot.yml file](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)." {% note %} {% data reusables.dependabot.private-dependencies-note %} -El {% data variables.product.prodname_dependabot %} no es compatible con dependencias privadas de {% data variables.product.prodname_dotcom %} para todos los administradores de paquetes. Consulta los detalles en la tabla a continuación. +{% 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. {% endnote %} {% data reusables.dependabot.supported-package-managers %} -Si tu repositorio ya utiliza una integración para la administración de dependencias, necesitarás inhabilitarlo antes de habilitar el {% data variables.product.prodname_dependabot %}. {% ifversion fpt or ghec %}Para obtener más información, vea "[Acerca de las integraciones](/github/customizing-your-github-workflow/about-integrations)".{% endif %} +If your repository already uses an integration for dependency management, you will need to disable this before enabling {% data variables.product.prodname_dependabot %}. {% ifversion fpt or ghec %}For more information, see "[About integrations](/github/customizing-your-github-workflow/about-integrations)."{% endif %} -## Acerca de las notificaciones para las actualizaciones de versión del {% data variables.product.prodname_dependabot %} +## About notifications for {% data variables.product.prodname_dependabot %} version updates -Puedes filtrar tus notificaciones en {% data variables.product.company_short %} para mostrar notificaciones para las solicitudes de cambios que creó el {% data variables.product.prodname_dependabot %}. Para obtener más información, consulte "[Administración de notificaciones de la bandeja de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)". +You can filter your notifications on {% data variables.product.company_short %} to show notifications for pull requests created by {% data variables.product.prodname_dependabot %}. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)." diff --git a/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md b/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md index eb75fa811d..c5c6fdf15f 100644 --- a/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md +++ b/translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md @@ -1,6 +1,6 @@ --- -title: Acerca de la seguridad de la cadena de suministro -intro: '{% data variables.product.product_name %} te ayuda a proteger la cadena de suministro, desde comprender las dependencias de tu entorno a conocer las vulnerabilidades de dichas dependencias {% ifversion fpt or ghec or ghes > 3.2 %} y aplicarles revisiones{% endif %}.' +title: About supply chain security +intro: '{% data variables.product.product_name %} helps you secure your supply chain, from understanding the dependencies in your environment, to knowing about vulnerabilities in those dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and patching them{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Supply chain security redirect_from: @@ -19,136 +19,154 @@ topics: - Dependencies - Pull requests - Repositories -ms.openlocfilehash: 2ad16960d0445994d5414390a62e16d719a10e6c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147064894' --- -## Acerca de la seguridad de la cadena de suministro en GitHub -Con el uso acelerado del código abierto, la mayoría de los proyectos dependen de cientos de dependencias de código abierto. Esto plantea un problema de seguridad: ¿qué ocurre si las dependencias que usa son vulnerables? Podría poner a los usuarios en riesgo de un ataque de cadena de suministro. Una de las cosas más importantes que puedes hacer para proteger la cadena de suministro es revisar las dependencias vulnerables{% ifversion GH-advisory-db-supports-malware %} y reemplazar cualquier malware{% endif %}. +## About supply chain security at GitHub -Las dependencias se agregan directamente a la cadena de suministro cuando se especifican en un archivo de manifiesto o en un archivo de bloqueo. Las dependencias también se pueden incluir de forma transitiva, es decir, incluso si no especifica una dependencia concreta, pero se usa en una dependencia propia, también dependerá de esa dependencia. +With the accelerated use of open source, most projects depend on hundreds of open-source dependencies. This poses a security problem: what if the dependencies you're using are vulnerable? You could be putting your users at risk of a supply chain attack. One of the most important things you can do to protect your supply chain is to patch your vulnerable dependencies{% ifversion GH-advisory-db-supports-malware %} and replace any malware{% endif %}. -{% data variables.product.product_name %} ofrece diversas características para ayudarle a comprender las dependencias del entorno{% ifversion ghes < 3.3 or ghae %} y conocer las vulnerabilidades de esas dependencias{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %}, conocer las vulnerabilidades de esas dependencias y aplicarles revisiones{% endif %}. +You add dependencies directly to your supply chain when you specify them in a manifest file or a lockfile. Dependencies can also be included transitively, that is, even if you don’t specify a particular dependency, but a dependency of yours uses it, then you’re also dependent on that dependency. -Las características de la cadena de suministro en {% data variables.product.product_name %} son las siguientes: -- **Gráfica de dependencias** -- **Revisión de dependencias** -- **{% data variables.product.prodname_dependabot_alerts %} ** {% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** +{% data variables.product.product_name %} offers a range of features to help you understand the dependencies in your environment{% ifversion ghes < 3.3 or ghae %} and know about vulnerabilities in those dependencies{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %}, know about vulnerabilities in those dependencies, and patch them{% endif %}. + +The supply chain features on {% data variables.product.product_name %} are: +- **Dependency graph** +- **Dependency review** +- **{% data variables.product.prodname_dependabot_alerts %} ** +{% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** - **{% data variables.product.prodname_dependabot_security_updates %}** - - **{% data variables.product.prodname_dependabot_version_updates %}** {% endif %} + - **{% data variables.product.prodname_dependabot_version_updates %}**{% endif %} -El gráfico de dependencias es fundamental para la seguridad de la cadena de suministro. En el gráfico de dependencias se identifican todas las dependencias ascendentes y las dependencias descendentes públicas de un repositorio o paquete. En el gráfico de dependencias del repositorio puede ver las dependencias del repositorio y algunas de sus propiedades, como la información de vulnerabilidad. +The dependency graph is central to supply chain security. The dependency graph identifies all upstream dependencies and public downstream dependents of a repository or package. You can see your repository’s dependencies and some of their properties, like vulnerability information, on the dependency graph for the repository. -Otras características de la cadena de suministro de {% data variables.product.prodname_dotcom %} dependen de la información proporcionada por el gráfico de dependencias. +Other supply chain features on {% data variables.product.prodname_dotcom %} rely on the information provided by the dependency graph. -- La revisión de dependencias usa el gráfico de dependencias para identificar los cambios de dependencias y ayudarle a comprender el impacto en la seguridad de estos cambios al revisar solicitudes de incorporación de cambios. -- {% data variables.product.prodname_dependabot %} realiza referencias cruzadas entre los datos de dependencia proporcionados por el gráfico de dependencias y la lista de avisos publicados en {% data variables.product.prodname_advisory_database %}, examina las dependencias y genera {% data variables.product.prodname_dependabot_alerts %} cuando se detecta una vulnerabilidad posible {% ifversion GH-advisory-db-supports-malware %}o malware{% endif %}. -{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %} usan el gráfico de dependencias y {% data variables.product.prodname_dependabot_alerts %} para ayudarle a actualizar las dependencias con vulnerabilidades conocidas en el repositorio. +- Dependency review uses the dependency graph to identify dependency changes and help you understand the security impact of these changes when you review pull requests. +- {% data variables.product.prodname_dependabot %} cross-references dependency data provided by the dependency graph with the list of advisories published in the {% data variables.product.prodname_advisory_database %}, scans your dependencies and generates {% data variables.product.prodname_dependabot_alerts %} when a potential vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} is detected. +{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %} use the dependency graph and {% data variables.product.prodname_dependabot_alerts %} to help you update dependencies with known vulnerabilities in your repository. -{% data variables.product.prodname_dependabot_version_updates %} no usan el gráfico de dependencias y en su lugar se basan en el control de versiones semántico de las dependencias. {% data variables.product.prodname_dependabot_version_updates %} ayudan a mantener actualizadas las dependencias, incluso cuando no tienen ninguna vulnerabilidad. +{% data variables.product.prodname_dependabot_version_updates %} don't use the dependency graph and rely on the semantic versioning of dependencies instead. {% data variables.product.prodname_dependabot_version_updates %} help you keep your dependencies updated, even when they don’t have any vulnerabilities. {% endif %} -{% ifversion fpt or ghec or ghes %} Para obtener guías de procedimientos recomendados sobre la seguridad de la cadena de suministro de un extremo a otro, incluida la protección de cuentas personales, código y procesos de compilación, consulta "[Protección de la cadena de suministro de un extremo a otro](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)". +{% ifversion fpt or ghec or ghes %} +For best practice guides on end-to-end supply chain security including the protection of personal accounts, code, and build processes, see "[Securing your end-to-end supply chain](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)." {% endif %} -## Introducción a las características +## Feature overview -### Qué es el gráfico de dependencias +### What is the dependency graph -Para generar el gráfico de dependencias, {% data variables.product.company_short %} examina las dependencias explícitas de un repositorio declaradas en el manifiesto y los archivos de bloqueo. Cuando se habilita, el gráfico de dependencias analiza automáticamente todos los archivos de manifiesto de paquete conocidos del repositorio y los usa para construir un gráfico con versiones y nombres de dependencia conocidos. +To generate the dependency graph, {% data variables.product.company_short %} looks at a repository’s explicit dependencies declared in the manifest and lockfiles. When enabled, the dependency graph automatically parses all known package manifest files in the repository, and uses this to construct a graph with known dependency names and versions. -- El gráfico de dependencias incluye información sobre las dependencias _directas_ y las _transitivas_. -- El gráfico de dependencias se actualiza automáticamente al insertar una confirmación en {% data variables.product.company_short %} que cambia o agrega un archivo de manifiesto o de bloqueo admitido a la rama predeterminada y cuando alguien inserta un cambio en el repositorio de una de las dependencias. -- Para ver el gráfico de dependencias, abra la página principal del repositorio en {% data variables.product.product_name %} y vaya a la pestaña **Conclusiones**. +- The dependency graph includes information on your _direct_ dependencies and _transitive_ dependencies. +- The dependency graph is automatically updated when you push a commit to {% data variables.product.company_short %} that changes or adds a supported manifest or lock file to the default branch, and when anyone pushes a change to the repository of one of your dependencies. +- You can see the dependency graph by opening the repository's main page on {% data variables.product.product_name %}, and navigating to the **Insights** tab. -{% ifversion dependency-submission-api %} {% data reusables.dependency-submission.dependency-submission-link %} {% endif %} - -Para más información sobre el gráfico de dependencias, vea "[Acerca del gráfico de dependencias](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)". - -### Qué es la revisión de dependencias - -La revisión de dependencias ayuda a los revisores y colaboradores a comprender los cambios de dependencia y su impacto en la seguridad en cada solicitud de incorporación de cambios. - -- La revisión de dependencias indica qué dependencias se han agregado, quitado o actualizado en una solicitud de incorporación de cambios. Puede usar las fechas de lanzamiento, la popularidad de las dependencias y la información de vulnerabilidad para ayudarle a decidir si quiere aceptar el cambio. -- Puede ver la revisión de dependencias de una solicitud de incorporación de cambios si muestra la diferencia enriquecida en la pestaña **Archivos cambiados**. - -Para más información sobre la revisión de dependencias, vea "[Acerca de la revisión de dependencias](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)". - -### Qué es Dependabot - -{% data variables.product.prodname_dependabot %} mantiene actualizadas las dependencias para lo que le informa de cualquier vulnerabilidad de seguridad en ellas{% ifversion fpt or ghec or ghes > 3.2 or ghae %}, y abre solicitudes de incorporación de cambios de forma automática para actualizar las dependencias a la siguiente versión segura disponible cuando se desencadena una alerta de {% data variables.product.prodname_dependabot %}, o bien a la versión más reciente cuando se publica una versión{% else %} para que pueda actualizar esa dependencia.{% endif %}. - -{% ifversion fpt or ghec or ghes > 3.2 %} El término "{% data variables.product.prodname_dependabot %}" abarca las características siguientes: -- {% data variables.product.prodname_dependabot_alerts %}: notificación mostrada en la pestaña **Seguridad** y en el gráfico de dependencias del repositorio. La alerta incluye un enlace al archivo afectado en el proyecto e información acerca de la versión arreglada. -- {% data variables.product.prodname_dependabot_updates %}: - - {% data variables.product.prodname_dependabot_security_updates %}: actualizaciones desencadenadas para actualizar las dependencias a una versión segura cuando se desencadena una alerta. - - {% data variables.product.prodname_dependabot_version_updates %}: actualizaciones programadas para mantener actualizadas las dependencias con la versión más reciente. +{% ifversion dependency-submission-api %} +{% data reusables.dependency-submission.dependency-submission-link %} {% endif %} -#### Qué son las alertas de Dependabot +For more information about the dependency graph, see "[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)." -{% data variables.product.prodname_dependabot_alerts %} resalta los repositorios afectados por una vulnerabilidad recién detectada en función del gráfico de dependencias y {% data variables.product.prodname_advisory_database %}, que contiene los avisos para las vulnerabilidades conocidas{% ifversion GH-advisory-db-supports-malware %} y el malware{% endif %}. +### What is dependency review -- {% data variables.product.prodname_dependabot %} realiza un examen para detectar las dependencias no seguras y envía {% data variables.product.prodname_dependabot_alerts %} cuando: {% ifversion fpt or ghec %} - - Se agrega un aviso nuevo a {% data variables.product.prodname_advisory_database %}.{% else %} - - Se sincronizan nuevos datos de aviso en {% data variables.product.product_location %} cada hora desde {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} - - Cambia el gráfico de dependencias del repositorio. -- {% data variables.product.prodname_dependabot_alerts %} se muestran {% ifversion fpt or ghec or ghes %} en la pestaña **Seguridad** del repositorio y{% endif %} en el gráfico de dependencias del repositorio. La alerta incluye {% ifversion fpt or ghec or ghes %}un vínculo al archivo afectado en el proyecto e {% endif %}información sobre una versión fija. +Dependency review helps reviewers and contributors understand dependency changes and their security impact in every pull request. -Para más información, vea "[Acerca de {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)". +- Dependency review tells you which dependencies were added, removed, or updated, in a pull request. You can use the release dates, popularity of dependencies, and vulnerability information to help you decide whether to accept the change. +- You can see the dependency review for a pull request by showing the rich diff on the **Files Changed** tab. + +For more information about dependency review, see "[About dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)." + +### What is Dependabot + +{% data variables.product.prodname_dependabot %} keeps your dependencies up to date by informing you of any security vulnerabilities in your dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and automatically opens pull requests to upgrade your dependencies to the next available secure version when a {% data variables.product.prodname_dependabot %} alert is triggered, or to the latest version when a release is published{% else %} so that you can update that dependency{% endif %}. {% ifversion fpt or ghec or ghes > 3.2 %} -#### Qué son las actualizaciones de Dependabot +The term "{% data variables.product.prodname_dependabot %}" encompasses the following features: +- {% data variables.product.prodname_dependabot_alerts %}—Displayed notification on the **Security** tab for the repository, and in the repository's dependency graph. The alert includes a link to the affected file in the project, and information about a fixed version. +- {% data variables.product.prodname_dependabot_updates %}: + - {% data variables.product.prodname_dependabot_security_updates %}—Triggered updates to upgrade your dependencies to a secure version when an alert is triggered. + - {% data variables.product.prodname_dependabot_version_updates %}—Scheduled updates to keep your dependencies up to date with the latest version. -Hay dos tipos de {% data variables.product.prodname_dependabot_updates %}: actualizaciones de _seguridad_ y de _versión_ de {% data variables.product.prodname_dependabot %}. En los dos casos {% data variables.product.prodname_dependabot %} genera solicitudes de incorporación de cambios automáticas para actualizar las dependencias, pero hay varias diferencias. - -{% data variables.product.prodname_dependabot_security_updates %}: - - Desencadenada por una alerta de {% data variables.product.prodname_dependabot %} - - Actualizan las dependencias a la versión mínima que resuelve una vulnerabilidad conocida - - Compatible con ecosistemas admitidos en el gráfico de dependencias - - No requiere un archivo de configuración, pero puedes usar uno para invalidar el comportamiento predeterminado. - -{% data variables.product.prodname_dependabot_version_updates %}: - - Requiere un archivo de configuración - - Se ejecutan según una programación que configure - - Actualizan las dependencias a la versión más reciente que coincida con la configuración - - Compatible con un grupo diferente de ecosistemas - -Para más información sobre {% data variables.product.prodname_dependabot_updates %}, vea "[Acerca de {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)" y "[Acerca de {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)". {% endif %} -## Disponibilidad de características - {% ifversion fpt or ghec %} -Repositorios públicos: -- **Gráfico de dependencias**: habilitado de forma predeterminada y no se puede deshabilitar. -- **Revisión de dependencias**: habilitada de forma predeterminada y no se puede deshabilitar. -- **{% data variables.product.prodname_dependabot_alerts %}** : no está habilitado de forma predeterminada. {% data variables.product.prodname_dotcom %} detecta las dependencias no seguras y muestra información en el gráfico de dependencias, pero no genera {% data variables.product.prodname_dependabot_alerts %} de forma predeterminada. Los propietarios de repositorios o los usuarios con acceso administrativo pueden habilitar las {% data variables.product.prodname_dependabot_alerts %}. - También puede habilitar o deshabilitar las alertas de Dependabot para todos los repositorios que pertenecen a la cuenta de usuario u organización. Para más información, vea "[Administración de la configuración de seguridad y análisis de la cuenta de usuario](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" o "[Administración de la configuración de seguridad y análisis para la organización](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)". +{% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dependabot_security_updates %}, and {% data variables.product.prodname_dependabot_version_updates %} do not use {% data variables.product.prodname_actions %} when they run on {% data variables.product.product_name %}. However, pull requests opened by {% data variables.product.prodname_dependabot %} can trigger workflows that run actions. For more information, see "[Automating {% data variables.product.prodname_dependabot %} with {% data variables.product.prodname_actions %}](/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions)." -Repositorios privados: -- **Gráfico de dependencias**: no está habilitado de forma predeterminada. Los administradores del repositorio pueden habilitar la característica. Para más información, vea "[Exploración de las dependencias de un repositorio](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". +{% elsif ghes %} + +{% data variables.product.prodname_dependabot_security_updates %} and {% data variables.product.prodname_dependabot_version_updates %} require {% data variables.product.prodname_actions %} to run on {% data variables.product.product_name %}. {% data variables.product.prodname_dependabot_alerts %} do not require {% data variables.product.prodname_actions %}. For more information, see "[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." + +{% elsif ghae %} + +{% data variables.product.prodname_actions %} is not required for {% data variables.product.prodname_dependabot_alerts %} to run on {% data variables.product.product_name %}. + +{% endif %} + +#### What are Dependabot alerts + +{% data variables.product.prodname_dependabot_alerts %} highlight repositories affected by a newly discovered vulnerability based on the dependency graph and the {% data variables.product.prodname_advisory_database %}, which contains advisories for known vulnerabilities{% ifversion GH-advisory-db-supports-malware %} and malware{% endif %}. + +- {% data variables.product.prodname_dependabot %} performs a scan to detect insecure dependencies and sends {% data variables.product.prodname_dependabot_alerts %} when: +{% ifversion fpt or ghec %} + - A new advisory is added to the {% data variables.product.prodname_advisory_database %}.{% else %} + - New advisory data is synchronized to {% data variables.product.product_location %} each hour from {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} + - The dependency graph for the repository changes. +- {% data variables.product.prodname_dependabot_alerts %} are displayed {% ifversion fpt or ghec or ghes %} on the **Security** tab for the repository and{% endif %} in the repository's dependency graph. The alert includes {% ifversion fpt or ghec or ghes %}a link to the affected file in the project, and {% endif %}information about a fixed version. + +For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)." + +{% ifversion fpt or ghec or ghes > 3.2 %} +#### What are Dependabot updates + +There are two types of {% data variables.product.prodname_dependabot_updates %}: {% data variables.product.prodname_dependabot %} _security_ updates and _version_ updates. {% data variables.product.prodname_dependabot %} generates automatic pull requests to update your dependencies in both cases, but there are several differences. + +{% data variables.product.prodname_dependabot_security_updates %}: + - Triggered by a {% data variables.product.prodname_dependabot %} alert + - Update dependencies to the minimum version that resolves a known vulnerability + - Supported for ecosystems the dependency graph supports + - Does not require a configuration file, but you can use one to override the default behavior + +{% data variables.product.prodname_dependabot_version_updates %}: + - Requires a configuration file + - Run on a schedule you configure + - Update dependencies to the latest version that matches the configuration + - Supported for a different group of ecosystems + +For more information about {% data variables.product.prodname_dependabot_updates %}, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)" and "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +{% endif %} + +## Feature availability + +{% ifversion fpt or ghec %} + +Public repositories: +- **Dependency graph**—enabled by default and cannot be disabled. +- **Dependency review**—enabled by default and cannot be disabled. +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. {% data variables.product.prodname_dotcom %} detects insecure dependencies and displays information in the dependency graph, but does not generate {% data variables.product.prodname_dependabot_alerts %} by default. Repository owners or people with admin access can enable {% data variables.product.prodname_dependabot_alerts %}. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." + +Private repositories: +- **Dependency graph**—not enabled by default. The feature can be enabled by repository administrators. For more information, see "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." {% ifversion fpt %} -- **Revisión de dependencias**: disponible en los repositorios privados propiedad de las organizaciones que usan {% data variables.product.prodname_ghe_cloud %} y que tienen una licencia para {% data variables.product.prodname_GH_advanced_security %}. Para más información, vea la [documentación de {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). +- **Dependency review**—available in private repositories owned by organizations that use {% data variables.product.prodname_ghe_cloud %} and have a license for {% data variables.product.prodname_GH_advanced_security %}. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). {% elsif ghec %} -- **Revisión de dependencias**: disponible repositorios privados propiedad de las organizaciones, siempre que tenga una licencia para {% data variables.product.prodname_GH_advanced_security %} y haya habilitado el gráfico de dependencias. Para más información, vea "[Acerca de {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)" y "[Exploración de las dependencias de un repositorio](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". {% endif %} -- **{% data variables.product.prodname_dependabot_alerts %}** : no está habilitado de forma predeterminada. Los propietarios de los repositorios privados o las personas con acceso administrativo puede habilitar las {% data variables.product.prodname_dependabot_alerts %} si habilitan la gráfica de dependencias y las {% data variables.product.prodname_dependabot_alerts %} para sus repositorios. - También puede habilitar o deshabilitar las alertas de Dependabot para todos los repositorios que pertenecen a la cuenta de usuario u organización. Para más información, vea "[Administración de la configuración de seguridad y análisis de la cuenta de usuario](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" o "[Administración de la configuración de seguridad y análisis para la organización](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)". +- **Dependency review**—available in private repositories owned by organizations provided you have a license for {% data variables.product.prodname_GH_advanced_security %} and the dependency graph enabled. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)" and "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." +{% endif %} +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Owners of private repositories, or people with admin access, can enable {% data variables.product.prodname_dependabot_alerts %} by enabling the dependency graph and {% data variables.product.prodname_dependabot_alerts %} for their repositories. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." -Cualquier tipo de repositorio: -- **{% data variables.product.prodname_dependabot_security_updates %}** : no está habilitado de forma predeterminada. Puedes habilitar las {% data variables.product.prodname_dependabot_security_updates %} para cualquier repositorio que utilice {% data variables.product.prodname_dependabot_alerts %} y la gráfica de dependencias. Para obtener información sobre cómo habilitar las actualizaciones de seguridad, vea "[Configuración de {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)". -- **{% data variables.product.prodname_dependabot_version_updates %}** : no está habilitado de forma predeterminada. Las personas con permisos de escritura en un repositorio pueden habilitar las {% data variables.product.prodname_dependabot_version_updates %}. Para obtener información sobre cómo habilitar las actualizaciones de versiones, consulta "[Configuración de {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)". +Any repository type: +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} {% ifversion ghes or ghae %} -- **Gráfico de dependencias** y **{% data variables.product.prodname_dependabot_alerts %}** : no están habilitados de forma predeterminada. El propietario de la empresa configura las dos características en un nivel empresarial. Para más información, vea {% ifversion ghes %}"[Habilitación del gráfico de dependencias para la empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)" y {% endif %}"[Habilitación de {% data variables.product.prodname_dependabot %} para la empresa](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)". -- **Revisión de dependencias**: disponible cuando se habilita el gráfico de dependencias para {% data variables.product.product_location %} y se habilita {% data variables.product.prodname_advanced_security %} para la organización o el repositorio. Para más información, consulte "[Acerca de {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)". -{% endif %} {% ifversion ghes > 3.2 %} -- **{% data variables.product.prodname_dependabot_security_updates %}** : no está habilitado de forma predeterminada. Puedes habilitar las {% data variables.product.prodname_dependabot_security_updates %} para cualquier repositorio que utilice {% data variables.product.prodname_dependabot_alerts %} y la gráfica de dependencias. Para obtener información sobre cómo habilitar las actualizaciones de seguridad, vea "[Configuración de {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)". -- **{% data variables.product.prodname_dependabot_version_updates %}** : no está habilitado de forma predeterminada. Las personas con permisos de escritura en un repositorio pueden habilitar las {% data variables.product.prodname_dependabot_version_updates %}. Para obtener información sobre cómo habilitar las actualizaciones de versiones, consulta "[Configuración de {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)". +- **Dependency graph** and **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Both features are configured at an enterprise level by the enterprise owner. For more information, see {% ifversion ghes %}"[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)" and {% endif %}"[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." +- **Dependency review**—available when dependency graph is enabled for {% data variables.product.product_location %} and {% data variables.product.prodname_advanced_security %} is enabled for the organization or repository. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)." +{% endif %} +{% ifversion ghes > 3.2 %} +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} diff --git a/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md index 70b27849c7..5aca361ee0 100644 --- a/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md +++ b/translations/es-ES/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md @@ -1,7 +1,7 @@ --- title: Changing the machine type for your codespace shortTitle: Change the machine type -intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for work you''re doing.' +intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.' product: '{% data reusables.gated-features.codespaces %}' versions: fpt: '*' @@ -23,9 +23,17 @@ type: how_to {% data reusables.codespaces.codespaces-machine-types %} You can choose an alternative machine type either when you create a codespace or at any time after you've created a codespace. -For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." For information on changing the machine type within {% data variables.product.prodname_vscode %}, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code#changing-the-machine-type-in-visual-studio-code)." +For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." -## Changing the machine type in {% data variables.product.prodname_dotcom %} +## Changing the machine type + +{% note %} + +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} + +{% endnote %} + +{% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} @@ -37,33 +45,64 @@ For information on choosing a machine type when you create a codespace, see "[Cr 1. Click **Change machine type**. !['Change machine type' menu option](/assets/images/help/codespaces/change-machine-type-menu-option.png) - 1. If multiple machine types are available for your codespace, choose the type of machine you want to use. ![Dialog box showing available machine types to choose](/assets/images/help/codespaces/change-machine-type-choice.png) +1. Click **Update codespace**. - {% note %} +{% endwebui %} - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +{% vscode %} - {% endnote %} +{% data reusables.codespaces.changing-machine-type-in-vscode %} -2. Click **Update codespace**. +{% endvscode %} - The change will take effect the next time your codespace restarts. +{% cli %} -## Force an immediate update of a currently running codespace +You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} command to change the machine type of a codespace. To use this command, you'll first need to find out the available machine types for your codespace. -If you change the machine type of a codespace you are currently using, and you want to apply the changes immediately, you can force the codespace to restart. +1. To view your list of codespaces, in a terminal, enter the following command. + + ``` + gh codespace list + ``` +1. Optionally, to find the current machine type for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME + ``` -1. At the bottom left of your codespace window, click **{% data variables.product.prodname_codespaces %}**. + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. The permanent names are listed under the **NAME** column in the list returned by `gh codespace list`. - ![Click '{% data variables.product.prodname_codespaces %}'](/assets/images/help/codespaces/codespaces-button.png) + If you're prompted to request the `codespace` scope, follow the instructions in the terminal. -1. From the options that are displayed at the top of the page select **Codespaces: Stop Current Codespace**. + Details for the current machine are listed under the `machine` field. +1. To find the available machine types for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME/machines + ``` - !['Suspend Current Codespace' option](/assets/images/help/codespaces/suspend-current-codespace.png) + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. +1. To change the machine type for a codespace, enter the following command. -1. After the codespace is stopped, click **Restart codespace**. + ``` + gh codespace edit --machine MACHINE-TYPE-NAME + ``` - ![Click 'Resume'](/assets/images/help/codespaces/resume-codespace.png) + Replace `MACHINE-TYPE-NAME` with the name of an available machine type for your codespace, for example `standardLinux32gb`. +1. Using the arrow keys, navigate to the codespace you want to change, then press Enter. + +{% endcli %} + +{% data reusables.codespaces.about-changing-storage-size %} + +{% cli %} + +## Further reading + +- "[Codespaces machines](/rest/codespaces/machines)" in the REST API documentation +- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) in the {% data variables.product.prodname_cli %} manual + +{% endcli %} \ No newline at end of file diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md index 349ed58b1a..1f866ccdd6 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md @@ -78,28 +78,15 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the {% data reusables.codespaces.codespaces-machine-types %} You can change the machine type of your codespace at any time. -1. In {% data variables.product.prodname_vscode_shortname %}, open the Command Palette (`shift command P` / `shift control P`). -1. Search for and select "Codespaces: Change Machine Type." +{% note %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-type-option.png) +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} -1. Click the codespace that you want to change. +{% endnote %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-choose-repo.png) +{% data reusables.codespaces.changing-machine-type-in-vscode %} -1. Choose the machine type you want to use. - - {% note %} - - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} - - {% endnote %} - -1. If the codespace is currently running, a message is displayed asking if you would like to restart and reconnect to your codespace now. - - Click **Yes** if you want to change the machine type used for this codespace immediately. - - If you click **No**, or if the codespace is not currently running, the change will take effect the next time the codespace restarts. +{% data reusables.codespaces.about-changing-storage-size %} ## Deleting a codespace in {% data variables.product.prodname_vscode_shortname %} diff --git a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md index 36f08bad58..0a582c1557 100644 --- a/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md +++ b/translations/es-ES/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md @@ -31,6 +31,7 @@ You can work with {% data variables.product.prodname_github_codespaces %} in the - [Modify ports in a codespace](#modify-ports-in-a-codespace) - [Access codespace logs](#access-codespace-logs) - [Access remote resources](#access-remote-resources) + - [Change the machine type of a codespace](#change-the-machine-type-of-a-codespace) ## Installing {% data variables.product.prodname_cli %} @@ -206,4 +207,12 @@ You can use the {% data variables.product.prodname_cli %} extension to create a **Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. -{% endnote %} \ No newline at end of file +{% endnote %} + +### Change the machine type of a codespace + +```shell +gh codespace edit -m machine-type-name +``` + +For more information, see the "{% data variables.product.prodname_cli %}" tab of "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)." \ No newline at end of file diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md index 3124e89039..784262db66 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md @@ -1,121 +1,121 @@ --- -title: Introducción a GitHub Copilot en IDE de JetBrains +title: Getting started with GitHub Copilot in a JetBrains IDE shortTitle: JetBrains IDE -intro: 'Obtén información sobre cómo instalar {% data variables.product.prodname_copilot %} en IDE de JetBrains y empezar a ver sugerencias a medida que escribes comentarios y código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in a JetBrains IDE, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: e031d6155f4dacf9987bee21ff80eada0e079d97 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '147110333' --- -## Acerca de {% data variables.product.prodname_copilot %} en IDE de JetBrains + +## About {% data variables.product.prodname_copilot %} and JetBrains IDEs {% data reusables.copilot.procedural-intro %} -Si usas IDE de JetBrains, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía se muestra cómo usar {% data variables.product.prodname_copilot %} en un IDE de JetBrains para macOS, Windows o Linux. +If you use a JetBrains IDE, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within a JetBrains IDE for macOS, Windows, or Linux. -## Requisitos previos +## Prerequisites {% data reusables.copilot.jetbrains-ides %} -## Instalación de la extensión JetBrains +## Installing the JetBrains extension -Para usar {% data variables.product.prodname_copilot %} en un IDE de JetBrains, hay que instalar la extensión {% data variables.product.prodname_copilot %}. El siguiente procedimiento te guiará a través de la instalación del complemento {% data variables.product.prodname_copilot %} en IntelliJ IDEA. Los pasos para instalar el complemento en otro IDE compatible pueden diferir. +To use {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} extension. The following procedure will guide you through installation of the {% data variables.product.prodname_copilot %} plugin in IntelliJ IDEA. Steps to install the plugin in another supported IDE may differ. -1. En el IDE de JetBrains, en el menú **Archivo** para Windows o bajo el nombre del IDE para Mac (por ejemplo, **PyCharm** o **IntelliJ**), haz clic en **Configuración** para Windows o **Preferencias** para Mac. -2. En el menú izquierdo del cuadro de diálogo **Configuración/Preferencias**, haz clic en **Complementos**. -3. En la parte superior del cuadro de diálogo **Configuración/Preferencias**, haz clic en **Marketplace**. En la barra de búsqueda, busca **{% data variables.product.prodname_copilot %}** y haz clic en **Instalar**. - ![Captura de pantalla de la búsqueda de Marketplace](/assets/images/help/copilot/jetbrains-marketplace.png) -1. Después de instalar {% data variables.product.prodname_copilot %}, haz clic en **Reiniciar IDE**. -1. Una vez reiniciado el IDE de JetBrains, haz clic en el menú **Herramientas**. Haz clic en **{% data variables.product.prodname_copilot %}** y, a continuación, haz clic en **Iniciar sesión en {% data variables.product.prodname_dotcom %}** . - ![Captura de pantalla del menú de herramientas de JetBrains](/assets/images/help/copilot/jetbrains-tools-menu.png) -1. En el cuadro de diálogo "Iniciar sesión en {% data variables.product.prodname_dotcom %}", para copiar el código del dispositivo y abrir la ventana de activación del dispositivo, haz clic en **Copiar y abrir**. - ![Captura de pantalla de la copia y apertura del código del dispositivo](/assets/images/help/copilot/device-code-copy-and-open.png) -1. Se abrirá una ventana de activación del dispositivo en el explorador. Pega el código del dispositivo y haz clic en **Continuar**. +1. In your JetBrains IDE, under the **File** menu for Windows or under the name of your IDE for Mac (for example, **PyCharm** or **IntelliJ**), click **Settings** for Windows or **Preferences** for Mac. +2. In the left-side menu of the **Settings/Preferences** dialog box, click **Plugins**. +3. At the top of the **Settings/Preferences** dialog box, click **Marketplace**. In the search bar, search for **{% data variables.product.prodname_copilot %}**, then click **Install**. + ![Screenshot of Marketplace search](/assets/images/help/copilot/jetbrains-marketplace.png) +1. After {% data variables.product.prodname_copilot %} is installed, click **Restart IDE**. +1. After your JetBrains IDE has restarted, click the **Tools** menu. Click **{% data variables.product.prodname_copilot %}**, then click **Login to {% data variables.product.prodname_dotcom %}**. + ![Screenshot of JetBrains tools menu](/assets/images/help/copilot/jetbrains-tools-menu.png) +1. In the "Sign in to {% data variables.product.prodname_dotcom %}" dialog box, to copy the device code and open the device activation window, click **Copy and Open**. + ![Screenshot of device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Para pegar el código en Windows o Linux, presiona Ctrl+v. - - Para pegar el código en macOS, presiona command+v. -1. {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar complemento {% data variables.product.prodname_copilot %}** . -1. Una vez aprobados los permisos, el IDE de JetBrains mostrará una confirmación. Para empezar a usar {% data variables.product.prodname_copilot %}, haz clic en **Aceptar**. - ![Captura de pantalla de la confirmación de permisos del IDE de JetBrains](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After the permissions have been approved, your JetBrains IDE will show a confirmation. To begin using {% data variables.product.prodname_copilot %}, click **OK**. + ![Screenshot of JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Visualización de tu primera sugerencia +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en Java, pero otros lenguajes funcionarán de forma similar. +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in Java, but other languages will work similarly. {% data reusables.copilot.create-java-file %} -1. En el archivo Java, crea una clase escribiendo `class Test`. - {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de clase en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. - ![Captura de pantalla de la sugerencia del cuerpo de la clase Java](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} -1. Para pedir a {% data variables.product.prodname_copilot %} que sugiera un cuerpo de función, escriba la siguiente línea debajo del corchete de la función `main`. La sugerencia exacta puede variar. +1. In the Java file, create a class by typing `class Test`. + {% data variables.product.prodname_copilot %} will automatically suggest a class body in grayed text, as shown below. The exact suggestion may vary. + ![Screenshot of the Java class body suggestion](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} +1. To prompt {% data variables.product.prodname_copilot %} to suggest a function body, type the following line below the bracket of the `main` function. The exact suggestion may vary. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} - ![Captura de pantalla de la sugerencia del cuerpo de la función de Java](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} -{% data variables.product.prodname_copilot %} intentará coincidir con el contexto y el estilo del código. Siempre puede editar el código sugerido. +{% data variables.product.prodname_copilot %} will attempt to match the context and style of your code. You can always edit the suggested code. -## Visualización de sugerencias alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-java-file %} -1. Para solicitar {% data variables.product.prodname_copilot %} para mostrar una sugerencia, escriba la siguiente línea en el archivo Java. -{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} {% data reusables.copilot.see-alternative-suggestions %} +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. +{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} +{% data reusables.copilot.see-alternative-suggestions %} - | SO | Ver la siguiente sugerencia | Ver la sugerencia anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - | macOS | Opción+] | Opción+[ | + | macOS | Option+] | Option+[ | | Windows | Alt+] | Alt+[ | | Linux | Alt+] | Alt+[ | {% data reusables.copilot.accept-or-reject-suggestion %} -## Visualización de varias sugerencias en una pestaña nueva +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que {% data variables.product.prodname_copilot %} muestre una sugerencia, escribe la siguiente línea en el archivo Java. +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -1. Abre una nueva pestaña con varias sugerencias adicionales. - - En macOS, presiona Comando+Mayús+A y, a continuación, haz clic en **Abrir GitHub Copilot** o presiona Comando+Mayús+\ para abrir la nueva pestaña inmediatamente. - - En Windows o Linux, presiona Ctrl+Entrar y haz clic en **Abrir GitHub Copilot**. - ![Captura de pantalla del diálogo para abrir Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) -1. Para aceptar una sugerencia, encima de la sugerencia, haz clic en **Aceptar solución**. Si quieres rechazar todas las sugerencias, cierra la pestaña. +1. Open a new tab with multiple additional suggestions. + - On macOS, press Command+Shift+A, then click **Open GitHub Copilot**, or press Command+Shift+\ to open the new tab immediately. + - On Windows or Linux, press Ctrl+Enter, then click **Open GitHub Copilot**. + ![Screenshot of dialogue to open Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que {% data variables.product.prodname_copilot %} sugiera una implementación de una función en el archivo de Java, escribe las líneas siguientes. +1. To prompt {% data variables.product.prodname_copilot %} to suggest an implementation of a function in the Java file, type the following lines. ```java{:copy} // find all images without alternate text // and give them a red border void process () { ``` - ![Captura de pantalla de la sugerencia del cuerpo de la función de Java](/assets/images/help/copilot/comment-suggestion-jetbrains.png) + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/comment-suggestion-jetbrains.png) -## Habilitación y deshabilitación de {% data variables.product.prodname_copilot %} +## Enabling and disabling {% data variables.product.prodname_copilot %} -Puedes habilitar o deshabilitar {% data variables.product.prodname_copilot %} para todos los lenguajes o para lenguajes individuales. El icono de estado de {% data variables.product.prodname_copilot %} en el panel inferior de la ventana del IDE de JetBrains indica si {% data variables.product.prodname_copilot %} está habilitado o deshabilitado. Cuando está habilitado, el icono está resaltado. Cuando está deshabilitado, el icono está atenuado. +You can enable or disable {% data variables.product.prodname_copilot %} for all languages, or for individual languages. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of your JetBrains IDE window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. -1. Para habilitar o deshabilitar {% data variables.product.prodname_copilot %}, haz clic en el icono de estado en el panel inferior de la ventana JetBrains. - ![Captura de pantalla del icono de estado en IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) -2. Si deshabilitas {% data variables.product.prodname_copilot %}, se te preguntará si quieres deshabilitarlo de forma global o para el lenguaje del archivo que estás editando actualmente. +1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. + ![Screenshot of the status icon in IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) +2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. - - Para deshabilitar las sugerencias de {% data variables.product.prodname_copilot %} de forma global, haz clic en **Deshabilitar finalizaciones**. - - Para deshabilitar las sugerencias de {% data variables.product.prodname_copilot %} para el lenguaje especificado, haz clic en **Deshabilitar para _LENGUAEE_**. - ![Captura de pantalla de la opción para deshabilitar {% data variables.product.prodname_copilot %} de forma global o para el lenguaje actual](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + - To disable suggestions from {% data variables.product.prodname_copilot %} globally, click **Disable Completions**. + - To disable suggestions from {% data variables.product.prodname_copilot %} for the specified language, click **Disable Completions for _LANGUAGE_**. + ![Screenshot of option to disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) -## Información adicional +## Further reading -- [Sitio web de {% data variables.product.prodname_copilot %}](https://copilot.github.com/) -- [Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) +- [The {% data variables.product.prodname_copilot %} website](https://copilot.github.com/) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md index d63e9998fc..75694b710b 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md @@ -1,105 +1,103 @@ --- -title: "Introducción a GitHub\_Copilot en Visual Studio\_Code" +title: Getting started with GitHub Copilot in Visual Studio Code shortTitle: Visual Studio Code -intro: 'Aprende a instalar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} y a empezar a ver sugerencias a medida que escribes comentarios y codificas.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 854d489eaa90690dd670fb01068fe0166c134afb -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080583' --- -## Acerca de {% data variables.product.prodname_copilot %} y {% data variables.product.prodname_vscode %} + +## About {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_vscode %} {% data reusables.copilot.procedural-intro %} -Si usas {% data variables.product.prodname_vscode %}, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía, se muestra cómo usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} para macOS, Windows o Linux. +If you use {% data variables.product.prodname_vscode %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vscode %} for macOS, Windows, or Linux. -## Prerrequisitos +## Prerequisites -Para usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}, debes tener instalado {% data variables.product.prodname_vscode %}. Para más información, consulta la [página de descarga de {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/Download). +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download). -## Instalación de la extensión de {% data variables.product.prodname_vscode %} +## Installing the {% data variables.product.prodname_vscode %} extension -Para usar {% data variables.product.prodname_copilot %}, primero debes instalar la extensión de {% data variables.product.prodname_vscode %}. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. En {% data variables.product.prodname_vscode %} Marketplace, ve a la página [Extensión de {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) y haz clic en **Instalar**. - ![Instalación de la extensión de {% data variables.product.prodname_copilot %} {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. Aparecerá una ventana emergente que te pedirá que abras {% data variables.product.prodname_vscode %}. Haz clic en **Abrir {% data variables.product.prodname_vscode %}** . -1. En la pestaña "Extensión: {% data variables.product.prodname_copilot %}" de {% data variables.product.prodname_vscode %}, haz clic en **Instalar**. - ![Botón Instalar de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. Si no autorizaste previamente a {% data variables.product.prodname_vscode %} en tu cuenta de {% data variables.product.prodname_dotcom %}, se te pedirá que inicies sesión en {% data variables.product.prodname_dotcom %} en {% data variables.product.prodname_vscode %}. - - Si autorizaste previamente a {% data variables.product.prodname_vscode %} para tu cuenta en {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} se autorizará automáticamente. - ![Captura de pantalla de la autorización de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. En el explorador, {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar {% data variables.product.prodname_vscode %}** . -1. En {% data variables.product.prodname_vscode %}, en el cuadro de diálogo "{% data variables.product.prodname_vscode %}", haz clic en **Abrir** para confirmar la autenticación. +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} for your account on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialog box, to confirm the authentication, click **Open**. -## Visualización de tu primera sugerencia +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en JavaScript, pero otros lenguajes funcionarán de manera similar. +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de función completo en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` - ![Captura de pantalla de una primera sugerencia {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -## Visualización de sugerencias alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` {% data reusables.copilot.see-alternative-suggestions %} - | SO | Ver la siguiente sugerencia | Ver la sugerencia anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - |macOS|Opción (⌥) o Alt+]|Opción (⌥) o Alt+[| + |macOS|Option (⌥) or Alt+]|Option (⌥) or Alt+[| |Windows|Alt+]|Alt+[| |Linux|Alt+]|Alt+[| -1. De manera alternativa, puedes mantener el puntero sobre la sugerencia para ver la paleta de comandos de {% data variables.product.prodname_copilot %} para elegir sugerencias. +1. Alternatively, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Visualización de varias sugerencias en una pestaña nueva +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escriba el encabezado de función siguiente. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` -1. Si quieres abrir una pestaña nueva con varias opciones adicionales, presiona Ctrl+Entrar. -1. Si quieres aceptar una sugerencia, haz clic en **Aceptar solución** encima de la sugerencia. Si quieres rechazar todas las sugerencias, cierra la pestaña. +1. To open a new tab with multiple additional options, press Ctrl+Enter. +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escribe el comentario siguiente. {% data variables.product.prodname_copilot %} sugerirá una implementación de la función. +1. In the JavaScript file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```javascript{:copy} // find all images without alternate text // and give them a red border function process() { ``` -## Uso de un marco +## Using a framework -También puedes usar {% data variables.product.prodname_copilot %} para generar sugerencias para API y marcos. En el ejemplo siguiente, se usa {% data variables.product.prodname_copilot %} para crear un servidor Express sencillo que devuelve la hora actual. +You can also use {% data variables.product.prodname_copilot %} to generate suggestions for APIs and frameworks. The following example uses {% data variables.product.prodname_copilot %} to create a simple Express server that returns the current time. {% data reusables.copilot.create-js-file %} -1. En el archivo de JavaScript, escribe el comentario siguiente y, luego, presiona Entrar. {% data variables.product.prodname_copilot %} sugerirá una implementación de la aplicación Express. +1. In the JavaScript file, type the following comment and then press Enter. {% data variables.product.prodname_copilot %} will suggest an implementation of the Express app. ```javascript{:copy} // Express server on port 3000 1. To accept each line, press Tab, then Enter. @@ -107,10 +105,10 @@ También puedes usar {% data variables.product.prodname_copilot %} para generar ```javascript{:copy} // Return the current time ``` -1. Para aceptar cada línea, presiona Tab. +1. To accept each line, press Tab. {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## Información adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md index 5e1a14f56f..0aaade3943 100644 --- a/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md +++ b/translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md @@ -1,83 +1,82 @@ --- -title: "Introducción a GitHub Copilot en Visual\_Studio" +title: Getting started with GitHub Copilot in Visual Studio shortTitle: Visual Studio product: '{% data reusables.gated-features.copilot %}' -intro: 'Obtén información sobre cómo instalar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %} y empezar a ver sugerencias a medida que escribe comentarios y código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, and start seeing suggestions as you write comments and code.' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 1d3c65cf1709ece9ea7b0eae9e6fadaa0df0c7f0 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '147098029' --- -## Acerca de {% data variables.product.prodname_copilot %} y Visual Studio + +## About {% data variables.product.prodname_copilot %} and Visual Studio {% data reusables.copilot.procedural-intro %} -Si usas {% data variables.product.prodname_vs %}, puedes ver e incorporar sugerencias de {% data variables.product.prodname_copilot %} directamente en el editor. En esta guía se muestra cómo usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %} para Windows. +If you use {% data variables.product.prodname_vs %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vs %} for Windows. -## Prerrequisitos +## Prerequisites -Para usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vs %}, debes tener instalado {% data variables.product.prodname_vs %} 2022 17.2 o posterior. Para más información, consulta la documentación de [Visual Studio IDE](https://visualstudio.microsoft.com/vs/). +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation. {% note %} -**Nota**: {% data variables.product.prodname_copilot %} no está disponible actualmente para su uso con Visual Studio para Mac. +**Note**: {% data variables.product.prodname_copilot %} is not currently available for use with Visual Studio for Mac. {% endnote %} -## Instalación de la extensión {% data variables.product.prodname_vs %} +## Installing the {% data variables.product.prodname_vs %} extension -Para usar {% data variables.product.prodname_copilot %}, primero debes instalar la extensión {% data variables.product.prodname_vs %}. -1. En la barra de herramientas de Visual Studio, haz clic en **Extensiones** y, a continuación, haz clic en **Administrar extensiones**. - ![Captura de pantalla de la barra de herramientas de Visual Studio](/assets/images/help/copilot/visual-studio-toolbar.png) -1. En la ventana "Administrar extensiones", haz clic en **Visual Studio Marketplace**, busca la extensión {% data variables.product.prodname_copilot %} y haz clic en **Descargar**. - ![Captura de pantalla de la extensión GitHub Copilot para Visual Studio con el botón Descargar resaltado](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) -1. Cierra la ventana "Administrar extensiones" y, a continuación, cierra y vuelve a iniciar {% data variables.product.prodname_vs %}. -1. Opcionalmente, para comprobar que {% data variables.product.prodname_copilot %} está instalado y habilitado, vuelve a **Administrar extensiones**, haz clic en **Instalado** para ver las extensiones instaladas actualmente y, a continuación, haz clic en **{% data variables.product.prodname_copilot %}** para ver la información de estado. - ![Captura de pantalla de las extensiones instaladas en Visual Studio con GitHub Copilot resaltado](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) -1. Abre o crea un proyecto en {% data variables.product.prodname_vs %}. -1. En el cuadro de diálogo "Microsoft {% data variables.product.prodname_vs %}", para copiar el código de activación del dispositivo, haz clic en **Aceptar**. - ![Captura de pantalla del cuadro de diálogo Microsoft {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-auth-dialogue.png) -1. Se abrirá una ventana de activación del dispositivo en el explorador. Pega el código del dispositivo y haz clic en **Continuar**. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vs %} extension. +1. In the Visual Studio toolbar, click **Extensions**, then click **Manage Extensions**. + ![Screenshot of the Visual Studio toolbar](/assets/images/help/copilot/visual-studio-toolbar.png) +1. In the "Manage Extensions" window, click **Visual Studio Marketplace**, search for the {% data variables.product.prodname_copilot %} extension, then click **Download**. + ![Screenshot of GitHub Copilot extension for Visual Studio with the download button emphasized](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) +1. Close the "Manage Extensions" window, then exit and relaunch {% data variables.product.prodname_vs %}. +1. Optionally, to check that {% data variables.product.prodname_copilot %} is installed and enabled, go back to **Manage Extensions**, click **Installed** to view your currently installed extensions, then click **{% data variables.product.prodname_copilot %}** to see status information. + ![Screenshot of installed extensions in Visual Studio with GitHub Copilot emphasized](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) +1. Open or create a new project in {% data variables.product.prodname_vs %}. +1. In the "Microsoft {% data variables.product.prodname_vs %}" dialog box, to copy your device activation code, click **OK**. + ![Screenshot of the Microsoft {% data variables.product.prodname_vs %} dialogue box](/assets/images/help/copilot/vs-auth-dialogue.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Para pegar el código en Windows o Linux, presiona Ctrl+v. - - Para pegar el código en macOS, presiona command+v. -1. {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar complemento {% data variables.product.prodname_copilot %}** . -1. Después de aprobar los permisos, {% data variables.product.prodname_vs %} mostrará una confirmación. - ![Captura de pantalla de la confirmación de permisos de {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After you approve the permissions, {% data variables.product.prodname_vs %} will show a confirmation. + ![Screenshot of {% data variables.product.prodname_vs %} permissions confirmation](/assets/images/help/copilot/vs-confirmation.png) -## Visualización de tu primera sugerencia -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en C#, pero otros lenguajes funcionarán de forma similar. +## Seeing your first suggestion + +{% data reusables.copilot.code-examples-limitations %} +{% data reusables.copilot.supported-languages %} The following samples are in C#, but other languages will work similarly. {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe la siguiente signatura de función. {% data variables.product.prodname_copilot %} sugerirá automáticamente un cuerpo de función completo en texto atenuado, como se muestra a continuación. La sugerencia exacta puede variar. +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```csharp{:copy} int CalculateDaysBetweenDates( ``` - ![Captura de pantalla de una primera sugerencia de Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) +{% data reusables.copilot.accept-suggestion %} -## Visualización de sugerencias alternativas -{% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe la siguiente signatura de función. {% data variables.product.prodname_copilot %} mostrará una sugerencia. +## Seeing alternative suggestions +{% data reusables.copilot.alternative-suggestions %} +{% data reusables.copilot.create-c-file %} +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will show you a suggestion. ```csharp{:copy} int CalculateDaysBetweenDates( ``` -1. Si hay sugerencias alternativas disponibles, puedes ver estas alternativas presionando Alt+] (o Alt+[). -1. Opcionalmente, puedes mantener el puntero sobre la sugerencia para ver la paleta de comandos{% data variables.product.prodname_copilot %} para elegir sugerencias. +1. If alternative suggestions are available, you can see these alternatives by pressing Alt+] (or Alt+[). +1. Optionally, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Generación de sugerencias de código a partir de comentarios +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-c-file %} -1. En el archivo de C#, escribe el comentario siguiente. {% data variables.product.prodname_copilot %} sugerirá una implementación de la función. +1. In the C# file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```csharp{:copy} using System.Xml.Linq; @@ -90,6 +89,6 @@ Para usar {% data variables.product.prodname_copilot %}, primero debes instalar {% data reusables.copilot.enabling-or-disabling-vs %} -## Información adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/es-ES/content/copilot/quickstart.md b/translations/es-ES/content/copilot/quickstart.md index 1917591d55..bde85097a6 100644 --- a/translations/es-ES/content/copilot/quickstart.md +++ b/translations/es-ES/content/copilot/quickstart.md @@ -1,6 +1,6 @@ --- -title: Inicio rápido para GitHub Copilot -intro: '{% data variables.product.prodname_copilot %} puede ayudarte a trabajar porque te ofrece sugerencias insertadas mientras codificas.' +title: Quickstart for GitHub Copilot +intro: '{% data variables.product.prodname_copilot %} can help you work, by offering inline suggestions as you code.' product: '{% data reusables.gated-features.copilot %}' allowTitleToDifferFromFilename: true versions: @@ -8,60 +8,60 @@ versions: shortTitle: Quickstart topics: - Copilot -ms.openlocfilehash: 5aa3071cddc2bf83e7ee7082eabea00f79a66ea5 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080643' --- -## Introducción -{% data variables.product.prodname_copilot %} es un programador de pares de IA. Puedes usar {% data variables.product.prodname_copilot %} para obtener sugerencias para líneas o funciones completas directamente en el editor. +## Introduction -En esta guía, se muestra cómo te puedes registrar en {% data variables.product.prodname_copilot %}, instalar la extensión de {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %} y obtener tu primera sugerencia. Para más información sobre {% data variables.product.prodname_copilot %}, consulta "[Acerca {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". Para información más detallada sobre cómo usar {% data variables.product.prodname_copilot %} en una variedad de entornos, consulta "[Introducción](/copilot/getting-started-with-github-copilot)". +{% data variables.product.prodname_copilot %} is an AI pair programmer. You can use {% data variables.product.prodname_copilot %} to get suggestions for whole lines or entire functions right inside your editor. -## Prerrequisitos +This guide will show you how to sign up for {% data variables.product.prodname_copilot %}, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)." + +## Prerequisites {% data reusables.copilot.copilot-prerequisites %} -- Para usar {% data variables.product.prodname_copilot %} en {% data variables.product.prodname_vscode %}, debes tener instalado {% data variables.product.prodname_vscode %}. Para más información, consulta la documentación de [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/). +- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) documentation. -## Registro en {% data variables.product.prodname_copilot %} +## Signing up for {% data variables.product.prodname_copilot %} {% data reusables.copilot.signup-procedure %} -## Instalación de la extensión de {% data variables.product.prodname_copilot %} para {% data variables.product.prodname_vscode %} +## Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %} -Para usar {% data variables.product.prodname_copilot %}, primero debes instalar la extensión de {% data variables.product.prodname_vscode %}. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. En {% data variables.product.prodname_vscode %} Marketplace, ve a la página [Extensión de {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) y haz clic en **Instalar**. - ![Instalación de la extensión de {% data variables.product.prodname_copilot %} {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. Aparecerá una ventana emergente que te pedirá que abras {% data variables.product.prodname_vscode %}. Haz clic en **Abrir {% data variables.product.prodname_vscode %}** . -1. En la pestaña "Extensión: {% data variables.product.prodname_copilot %}" de {% data variables.product.prodname_vscode %}, haz clic en **Instalar**. - ![Botón Instalar de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. Si no autorizaste previamente a {% data variables.product.prodname_vscode %} en tu cuenta de {% data variables.product.prodname_dotcom %}, se te pedirá que inicies sesión en {% data variables.product.prodname_dotcom %} en {% data variables.product.prodname_vscode %}. - - Si autorizaste previamente a {% data variables.product.prodname_vscode %} en tu cuenta de {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} se autorizará automáticamente. - ![Captura de pantalla de la autorización de {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. En el explorador, {% data variables.product.prodname_dotcom %} solicitará los permisos necesarios para {% data variables.product.prodname_copilot %}. Para aprobar estos permisos, haz clic en **Autorizar {% data variables.product.prodname_vscode %}** . -1. En {% data variables.product.prodname_vscode %}, en el cuadro de diálogo "{% data variables.product.prodname_vscode %}", haz clic en **Abrir** para confirmar la autenticación. +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialogue box, to confirm the authentication, click **Open**. -## Obtención de tu primera sugerencia +## Getting your first suggestion -{% data reusables.copilot.supported-languages %} Los ejemplos siguientes están en JavaScript, pero otros lenguajes funcionarán de manera similar. +{% data reusables.copilot.code-examples-limitations %} -1. Abre {% data variables.product.prodname_vscode %}. -{% data reusables.copilot.create-js-file %} {% data reusables.copilot.type-function-header %} {% data variables.product.prodname_copilot %} sugerirá automáticamente todo el cuerpo de una función en texto atenuado, tal como se muestra a continuación. La sugerencia exacta puede variar. -![Primera sugerencia {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. -## Pasos siguientes +1. Open {% data variables.product.prodname_vscode %}. +{% data reusables.copilot.create-js-file %} +{% data reusables.copilot.type-function-header %} + {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. + ![First suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -Instalaste {% data variables.product.prodname_copilot %} correctamente y recibiste tu primera sugerencia, pero eso es solo el principio. Estos son algunos recursos útiles para que completes los pasos siguientes con {% data variables.product.prodname_copilot %}. +## Next Steps -- [Introducción](/copilot/getting-started-with-github-copilot): aprendiste a obtener tu primera sugerencia en {% data variables.product.prodname_vscode %}. Estas guías te muestran cómo configurar y recorrer las diversas funciones de {% data variables.product.prodname_copilot %} en todos los entornos admitidos. -- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): ve ejemplos prácticos de cómo {% data variables.product.prodname_copilot %} puede ayudarte a trabajar. -- [Configuración de {% data variables.product.prodname_copilot %}](/copilot/configuring-github-copilot): estas guías te proporciona información detallada sobre cómo configurar {% data variables.product.prodname_copilot %} según tus preferencias personales. +You successfully installed {% data variables.product.prodname_copilot %} and received your first suggestion, but that's just the beginning! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_copilot %}. + +- [Getting Started](/copilot/getting-started-with-github-copilot): You've learned how to get your first suggestion in {% data variables.product.prodname_vscode %}. These guides show you how to set up and navigate the various functions of {% data variables.product.prodname_copilot %} across all of the supported environments. +- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): See practical examples of how {% data variables.product.prodname_copilot %} can help you work. +- [Configuring {% data variables.product.prodname_copilot %}](/copilot/configuring-github-copilot): These guides provide details on how to configure {% data variables.product.prodname_copilot %} to your personal preferences. -## Información adicional +## Further reading -- [Acerca de {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) diff --git a/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md b/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md index 95b6f09549..00f75ff588 100644 --- a/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md +++ b/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md @@ -1,60 +1,89 @@ --- -title: Colaborar con los mantenedores utilizando debates +title: Collaborating with maintainers using discussions shortTitle: Collaborating with maintainers -intro: 'Puedes contribuir a las metas, planes, salud y comunidad de un proyecto en {% data variables.product.product_name %} si te comunicas con los mantenedores del proyecto en un debate.' +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 access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions -ms.openlocfilehash: f090088d55e946e67c1f0b5d790deca9fd794a90 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410255' --- -## Acerca de la colaboración con mantenedores utilizando los {% data variables.product.prodname_discussions %} -{% data reusables.discussions.about-discussions %} Si utilizas o contribuyes con un proyecto, puedes iniciar un debate para hacer sugerencias e interactuar con los manenedores y miembros de la comunidad con respecto a tus planes, preguntas, ideas y retroalimentación. Para más información, vea "[Acerca de los debates](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". + +## About collaboration with maintainers using {% data variables.product.prodname_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-categories-and-formats %} {% data reusables.discussions.about-announcement-format %} -Los administradores de repositorios y mantenedores de proyectos pueden borrar un debate de ese repositorio. Igualmente, los administradores y los mantenedores del repositorio de origen de los debates de una organización pueden eliminar un debate de esa organización. Para más información, consulta "[Administración de debates](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)". +Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)." -{% data reusables.discussions.github-recognizes-members %} Estos miembros aparecen en una lista de los contribuyentes más útiles en los debates del proyecto. Conforme crezca tu proyecto, podrás otorgar permisos de acceso superiores a los miembros activos de tu comunidad. Para más información, vea "[Concesión de permisos más altos a los principales colaboradores](/discussions/guides/granting-higher-permissions-to-top-contributors)". +{% 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)" -![Contribuyentes más útiles para los debates de un proyecto](/assets/images/help/discussions/most-helpful.png) +![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) -Para más información sobre la participación en debates, vea "[Participación en una debate](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)". +Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value. -## Prerrequisitos +For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." -Para colaborar con los mantenedores de debates del repositorio, un administrador de del repositorio o un mantenedor del proyecto debe habilitar {% data variables.product.prodname_discussions %} para el repositorio. Para más información, vea "[Habilitación o deshabilitación de {% data variables.product.prodname_discussions %} en un repositorio](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)". +## Prerequisites -Para colaborar con los mantenedores en los debates de la organización, se debe habilitar {% data variables.product.prodname_discussions %} para la organización. Para más información, consulta "[Habilitación o deshabilitación de {% data variables.product.prodname_discussions %} para una organización](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)". +To collaborate with maintainers in repository discussions, a repository administrator or project maintainer must enable {% data variables.product.prodname_discussions %} for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." -## Iniciar un debate +To collaborate with maintainers in organization discussions, {% data variables.product.prodname_discussions %} must be enabled for the organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Starting a discussion {% data reusables.discussions.starting-a-discussion %} -## Inicio de un sondeo +## Starting a poll {% data reusables.discussions.starting-a-poll %} -## Filtrar la lista de debates +## Filtering the list of discussions -Puedes buscar debates y filtrar la lista de éstos de un repositorio u organización. Para más información, vea "[Búsqueda en debates](/search-github/searching-on-github/searching-discussions)". +You can search for discussions and filter the list of discussions in a repository or organization. For more information, see "[Searching discussions](/search-github/searching-on-github/searching-discussions)." -{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} -1. En el campo **Buscar todos los debates**, escriba una consulta de búsqueda. Opcionalmente, a la derecha del campo de búsqueda, da clic en un botón para filtrar aún más los resultados. - ![Barra de búsqueda y botones para filtrar los debates](/assets/images/help/discussions/search-and-filter-controls.png) -1. En la lista de debates, da clic en el debate que quieras ver. - ![Resultados de la búsqueda para debates](/assets/images/help/discussions/search-result.png) +{% data reusables.discussions.navigate-to-repo-or-org %} +{% 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) -## Convertir una propuesta en un debate +## Sorting the list of discussions -{% data reusables.discussions.you-can-convert-an-issue %} Para más información, consulta "[Moderación de debates](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)". +You can choose how to sort the list of discussions. -## Información adicional +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +1. To the right of the **Search all discussions** field, select **New**, or select **Top** and choose a time period from the drop down menu. -- "[Acerca de la escritura y el formato en {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" {%- ifversion fpt or ghec %} -- "[Mantenimiento de la seguridad en {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)" {%- endif %} + ![Buttons for sorting discussions](/assets/images/help/discussions/sort-discussions-buttons.png) + + - Sort by **New** to display the discussions with the most recent activity at the top of the list. + - Sort by **Top** to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period. + +## Sorting top-level comments in discussions + +You can choose how to sort top-level comments in discussions. Comment threads do not impact the order comments are sorted in. + +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. Under the main discussion post, select **Oldest**, **Newest**, or **Top**. + + ![Buttons for sorting comments in discussions](/assets/images/help/discussions/sort-comments-buttons.png) + + - Sort by **Oldest** to display the oldest top-level comments first. + - Sort by **Newest** to display the newest top-level comments first. + - Sort by **Top** to display the most upvoted top-level comments first. + +## Converting an issue to a discussion + +{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." + +## Further reading + +- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +{%- ifversion fpt or ghec %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)" +{%- endif %} diff --git a/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md b/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md index 71b4bf0e6b..ccfd537fc0 100644 --- a/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md +++ b/translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md @@ -1,40 +1,66 @@ --- -title: Participar en un debate -intro: 'Puedes conversar con la comunidad y con los mantenedores en un foro dentro del repositorio de un proyecto en {% data variables.product.product_name %}.' +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 access to a repository can participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can participate in discussions and polls in that organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions shortTitle: Participate in discussion -ms.openlocfilehash: 07db8d3583c218e592ca1b68171292e52fcfc12f -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410239' --- -## Acerca de la perticipación en un debate -{% data reusables.discussions.about-discussions %} Para obtener más información, consulte "[Acerca de las debates](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". -Además de iniciar o visualizar debates y sondeos, puedes comentar como respuesta al comentario original del autor del debate. También puedes crear un hilo de comentarios si respondes a un comentario individual que otro miembro de la comunidad haya hecho dentro del debate, y reaccionar a los comentarios con emojis. +## About participation in a discussion -{% ifversion fpt or ghec %}Puedes bloquear usuarios y reportar el contenido perjudicial para mantener un ambiente agradable y seguro en {% data variables.product.product_name %}. Para obtener más información, consulta "[Mantenimiento de la seguridad en {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)".{% endif %} +{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." -## Prerrequisitos +In addition to starting or viewing discussions and polls, you can: -Los {% data variables.product.prodname_discussions %} deben estar habilitados en el repositorio o la organización para que puedas participar en ellos. Para obtener más información, consulta "[Habilitación o deshabilitación de {% data variables.product.prodname_discussions %} para un repositorio](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)" y "[Habilitación o deshabilitación de debates de GitHub para una organización](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." +- Comment in response to the original comment from the author of the discussion +- Create a comment thread by replying to an individual comment that another community member made within the discussion +- React to comments with emoji +- Upvote discussions and top-level comments to give them more visibility -## Crear un debate +{% ifversion fpt or ghec %}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 %}](/communities/maintaining-your-safety-on-github)."{% endif %} + +## Prerequisites + +{% data variables.product.prodname_discussions %} must be enabled for the repository or organization for you to participate in a discussion in the repository or organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)" and "[Enabling or disabling GitHub Discussions for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Creating a discussion {% data reusables.discussions.starting-a-discussion %} -## Creación de un sondeo +## Creating a poll {% data reusables.discussions.starting-a-poll %} -## Marcar un comentario como una respuesta +## Marking a comment as an answer -Los autores de los debates y los usuarios con el rol de clasificación o superior dentro del repositorio pueden marcar un comentario como la respuesta a un debate dentro de dicho repositorio. -De forma similar, los autores y los usuarios de debates con el rol de evaluación de prioridades o superior en el repositorio de origen de los debates de la organización pueden marcar un comentario como respuesta a un debate de la organización. +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. +Similarly, discussion authors and users with the triage role or greater for the source repository for organization discussions can mark a comment as the answer to a discussion in the organization. {% data reusables.discussions.marking-a-comment-as-an-answer %} + +## Upvoting a discussion + +You can upvote discussions to give more visibility to the topics that matter to you, and sort discussions to see which have been upvoted the most. For more information on sorting discussions, see "[Sorting the list of discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-the-list-of-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +1. In the list of discussions, find the discussion you want to upvote. +1. To the left of the discussion, click the upvote arrow. + + ![Discussion list and upvote button for upvoting discussions](/assets/images/help/discussions/upvote-discussion-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. + +## Upvoting a comment + +You can upvote top-level comments in discussions, and sort top-level comments to see which comments have been upvoted the most. For more information on sorting comments, see "[Sorting top-level comments in discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-top-level-comments-in-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. In the discussion, find a top-level comment you want to upvote. +1. Click on the upvote arrow at the bottom left of the comment. + + ![Top-level comment and upvote button for upvoting comments](/assets/images/help/discussions/upvote-comment-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. diff --git a/translations/es-ES/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md b/translations/es-ES/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md index 4903a2caf5..dd8c5100cd 100644 --- a/translations/es-ES/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md +++ b/translations/es-ES/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Administrar la política de bifurcación para tu organización -intro: 'Puedes permitir o evitar la bifurcación de cualquier repositorio privado{% ifversion ghes or ghae or ghec %} e interno{% endif %} propiedad de su organización.' +title: Managing the forking policy for your organization +intro: 'You can allow or prevent the forking of any private{% ifversion ghes or ghae or ghec %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -15,24 +15,30 @@ topics: - Organizations - Teams shortTitle: Manage forking policy -ms.openlocfilehash: 11aad8ee3c08b62f6bc352f91b6d804f35eee6e6 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: '145119298' --- -De manera predeterminada, las nuevas organizaciones se configuran para no permitir la bifurcación de repositorios privados{% ifversion ghes or ghec or ghae %} e internos{% endif %}. -Si permite la bifurcación de repositorios privados{% ifversion ghes or ghec or ghae %} e internos{% endif %} en el nivel de organización, también puede configurar la capacidad de bifurcar un repositorio privado{% ifversion ghes or ghec or ghae %} o interno{% endif %}. Para obtener más información, consulte "[Administración de la directiva de bifurcación para el repositorio](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)". +By default, new organizations are configured to disallow the forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories. -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.profile.org_member_privileges %} -1. En "Repository forking", seleccione **Allow forking of private {% ifversion ghec or ghes or ghae %}and internal {% endif %}repositories**. +If you allow forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% ifversion ghes or ghec or ghae %} 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)." - {%- ifversion fpt %} ![ Casilla para permitir o no permitir las bifurcaciones en la organización](/assets/images/help/repository/allow-disable-forking-fpt.png) {%- elsif ghes or ghec or ghae %} ![Casilla para permitir o no permitir las bifurcaciones en la organización](/assets/images/help/repository/allow-disable-forking-organization.png) {%- endif %} -6. Haga clic en **Save**(Guardar). +{% ifversion org-owners-limit-forks-creation %} +{% ifversion ghec %}If your organization is owned by an enterprise account, you{% else %}You{% endif %} may not be able to configure this setting for your organization, if an enterprise owner has set a policy at the enterprise level. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-forking-private-or-internal-repositories)."{% endif %} -## Información adicional +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.profile.org_member_privileges %} +1. Under "Repository forking", select **Allow forking of private {% ifversion ghec or ghes or ghae %}and internal {% endif %}repositories**. -- "[Acerca de las bifurcaciones](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" -- "[Roles de repositorio para una organización](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)" + {%- ifversion fpt %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-fpt.png) + {%- elsif ghes or ghec or ghae %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-organization.png) + {%- endif %}{% ifversion org-owners-limit-forks-creation %} +2. Optionally, if forking is enabled, you can specify where users are allowed to fork repositories. If your organization belongs to a {% data variables.product.prodname_enterprise %} account and a more restrictive default has been selected in the enterprise settings, you won't be able to select the more permissive default in your organization settings. Review the information about changing the setting and choose a policy. + ![Screenshot showing the list of repository forking policy options](/assets/images/help/business-accounts/org-repository-forking-policy-settings.png){%- endif %} +3. Click **Save**. + +## Further reading + +- "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" +- "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)" diff --git a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md index c52b1f4f18..53cf00e556 100644 --- a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md +++ b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md @@ -47,7 +47,16 @@ To reduce the size of your CODEOWNERS file, consider using wildcard patterns to ## CODEOWNERS syntax -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). The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. +{% warning %} + +**Warning:** 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 + +{% endwarning %} + +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. The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. {% ifversion fpt or ghec%}In most cases, you{% else %}You{% endif %} can also refer to a user by an email address that has been added to their account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, for example `user@example.com`. {% ifversion fpt or ghec %} You cannot use an email address to refer to a {% data variables.product.prodname_managed_user %}. For more information about {% data variables.product.prodname_managed_users %}, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}{% endif %} @@ -117,15 +126,6 @@ apps/ @octocat /apps/github ``` -{% warning %} - -**Warning:** 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 - -{% endwarning %} - ## CODEOWNERS and branch protection Repository owners can add branch protection rules to ensure that changed code is reviewed by the owners of the changed files. For more information, see "[About protected branches](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)." diff --git a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md index ac0814041c..70049d7c6e 100644 --- a/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md +++ b/translations/es-ES/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md @@ -119,9 +119,9 @@ By default, when you create a new repository in your personal account, `GITHUB_T {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.settings-sidebar-actions-general %} 1. Under "Workflow permissions", choose whether you want the `GITHUB_TOKEN` to have read and write access for all scopes, or just read access for the `contents` scope. - - ![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository{% ifversion allow-actions-to-approve-pr-with-ent-repo %}-with-pr-approval{% endif %}.png) - + + {% ifversion allow-actions-to-approve-pr-with-ent-repo %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository-with-pr-approval.png){% else %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository.png){% endif %} + 1. Click **Save** to apply the settings. {% ifversion allow-actions-to-approve-pr-with-ent-repo %} diff --git a/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md index db921f19ab..4cb42a307d 100644 --- a/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -1,17 +1,11 @@ ---- -ms.openlocfilehash: bd2ea7e2ff0c8e9f60c3d011ee30573e3702cbed -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147879344" ---- -{% ifversion ghae %} Para permitir que los ejecutores autohospedados se comuniquen con {% data variables.product.prodname_dotcom %}, agregue la dirección IP o intervalo de direcciones IP de los ejecutores autohospedados a la lista de IP permitidas. Para más información, vea "[Adición de una dirección IP permitida](#adding-an-allowed-ip-address)". -{% else %} {% warning %} +{% ifversion ghae %} +To allow your self-hosted runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your self-hosted runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +{% else %} +{% warning %} -**Advertencia**: Si usa una lista de IP permitidas y también quiere utilizar {% data variables.product.prodname_actions %}, tendrá que usar ejecutores autohospedados. Para más información, vea "[Hospedaje de ejecutores propios](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". +**Warning**: If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with a static IP address range{% endif %}. For more information, see "[Hosting your own runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[Using larger runners](/actions/using-github-hosted-runners/using-larger-runners)"{% endif %}. {% endwarning %} -Para permitir que los ejecutores auto-hospedados se comuniquen con {% data variables.product.prodname_dotcom %}, agrega la dirección o rango de direcciones IP de tus ejecutores auto-hospedados a la lista de IP permitidas. Para más información, vea "[Adición de una dirección IP permitida](#adding-an-allowed-ip-address)". +To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." {% endif %} diff --git a/translations/es-ES/data/reusables/repositories/navigate-to-commit-page.md b/translations/es-ES/data/reusables/repositories/navigate-to-commit-page.md index 2223d6600a..d712c518b8 100644 --- a/translations/es-ES/data/reusables/repositories/navigate-to-commit-page.md +++ b/translations/es-ES/data/reusables/repositories/navigate-to-commit-page.md @@ -1,10 +1,2 @@ ---- -ms.openlocfilehash: af420b118bb0fcb0bdad8e2c88f02e5b546fa4f1 -ms.sourcegitcommit: fbc89bcee79c2cda1d3d6e99d5571873ca3b2686 -ms.translationtype: HT -ms.contentlocale: es-ES -ms.lasthandoff: 08/31/2022 -ms.locfileid: "147065230" ---- -1. En la página principal del repositorio, haga clic en las confirmaciones para ir a la página confirmaciones. - ![Captura de pantalla de la página principal del repositorio con las confirmaciones resaltadas](/assets/images/help/commits/commits-page.png) +1. On the main page of the repository, click {% octicon "history" aria-label="The history icon" %} **commits** to navigate to the commits page. + ![Screenshot of the repository main page with the commits emphasized](/assets/images/help/commits/commits-page.png) diff --git a/translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username.md b/translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username.md index 84367ad293..5cb7038add 100644 --- a/translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username.md +++ b/translations/ja-JP/content/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/changing-your-github-username.md @@ -73,6 +73,10 @@ After changing your username, links to your previous profile page, such as `http {% ifversion fpt or ghec %}Git commits that were associated with your {% data variables.product.product_name %}-provided `noreply` email address won't be attributed to your new username and won't appear in your contributions graph.{% endif %} If your Git commits are associated with another email address you've [added to your GitHub account](/articles/adding-an-email-address-to-your-github-account), {% ifversion fpt or ghec %}including the ID-based {% data variables.product.product_name %}-provided `noreply` email address, {% endif %}they'll continue to be attributed to you and appear in your contributions graph after you've changed your username. For more information on setting your email address, see "[Setting your commit email address](/articles/setting-your-commit-email-address)." +## Your gists + +After changing your username, the URLs to any public or secret gists will also change and previous links to these will return a 404 error. We recommend updating the links to these gists anywhere you may have shared them. + ## Changing your username {% data reusables.user-settings.access_settings %} diff --git a/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md b/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md index af61355b2f..79bbe18b9c 100644 --- a/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md +++ b/translations/ja-JP/content/actions/hosting-your-own-runners/about-self-hosted-runners.md @@ -123,8 +123,8 @@ The following operating systems are supported for the self-hosted runner applica The following processor architectures are supported for the self-hosted runner application. - `x64` - Linux, macOS, Windows. -- `ARM64` - Linux{% ifversion actions-macos-arm %}, macOS{% endif %}. -- `ARM32` - Linux only. +- `ARM64` - Linux{% ifversion actions-macos-arm %}, macOS{% endif %}{% ifversion actions-windows-arm %}, Windows (currently in beta){% endif %}. +- `ARM32` - Linux. {% ifversion ghes %} diff --git a/translations/ja-JP/content/actions/learn-github-actions/contexts.md b/translations/ja-JP/content/actions/learn-github-actions/contexts.md index 9786fea20d..a4fdab860d 100644 --- a/translations/ja-JP/content/actions/learn-github-actions/contexts.md +++ b/translations/ja-JP/content/actions/learn-github-actions/contexts.md @@ -74,6 +74,9 @@ The following table indicates where each context and special function can be use | Workflow key | Context | Special functions | | ---- | ------- | ----------------- | +{%- ifversion actions-run-name %} +| run-name | github, inputs | | +{%- endif %} | concurrency | github, inputs | | | env | github, secrets, inputs | | | jobs.<job_id>.concurrency | github, needs, strategy, matrix, inputs | | @@ -211,6 +214,9 @@ The `github` context contains information about the workflow run and the event t {%- ifversion fpt or ghec or ghes > 3.5 or ghae > 3.4 %} | `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. | {%- endif %} +{%- ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %} +| `github.secret_source` | `string` | The source of a secret used in a workflow. Possible values are `None`, `Actions`, `Dependabot`, or `Codespaces`. | +{%- endif %} | `github.server_url` | `string` | The URL of the GitHub server. For example: `https://github.com`. | | `github.sha` | `string` | {% data reusables.actions.github_sha_description %} | | `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)."
Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |{% ifversion actions-stable-actor-ids %} diff --git a/translations/ja-JP/content/actions/quickstart.md b/translations/ja-JP/content/actions/quickstart.md index 53f75049a4..b83df0ebe2 100644 --- a/translations/ja-JP/content/actions/quickstart.md +++ b/translations/ja-JP/content/actions/quickstart.md @@ -1,6 +1,6 @@ --- -title: GitHub Actions のクイックスタート -intro: '{% data variables.product.prodname_actions %} の機能を 5 分またはそれ以下で試すことができます。' +title: Quickstart for GitHub Actions +intro: 'Try out the features of {% data variables.product.prodname_actions %} in 5 minutes or less.' allowTitleToDifferFromFilename: true redirect_from: - /actions/getting-started-with-github-actions/starting-with-preconfigured-workflow-templates @@ -13,84 +13,85 @@ type: quick_start topics: - Fundamentals shortTitle: Quickstart -ms.openlocfilehash: 164aef041c509264c9e8440d5339bce3cf4aaaca -ms.sourcegitcommit: 80842b4e4c500daa051eff0ccd7cde91c2d4bb36 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/12/2022 -ms.locfileid: '146139458' --- -{% data reusables.actions.enterprise-beta %} {% data reusables.actions.enterprise-github-hosted-runners %} -## はじめに +{% data reusables.actions.enterprise-beta %} +{% data reusables.actions.enterprise-github-hosted-runners %} -{% data variables.product.prodname_actions %} ワークフローを作成して実行するには、{% data variables.product.prodname_dotcom %} リポジトリのみが必要になります。 このガイドでは、{% data variables.product.prodname_actions %} の重要な機能のいくつかを示すワークフローを追加します。 +## Introduction -次の例は、{% data variables.product.prodname_actions %} ジョブを自動的にトリガーする方法、実行する場所、およびリポジトリ内のコードとやり取りする方法を示しています。 +You only need a {% data variables.product.prodname_dotcom %} repository to create and run a {% data variables.product.prodname_actions %} workflow. In this guide, you'll add a workflow that demonstrates some of the essential features of {% data variables.product.prodname_actions %}. -## 最初のワークフローを作成する +The following example shows you how {% data variables.product.prodname_actions %} jobs can be automatically triggered, where they run, and how they can interact with the code in your repository. -1. `.github/workflows` ディレクトリがまだ存在しない場合、リポジトリの {% data variables.product.prodname_dotcom %} でこのディレクトリを作成します。 -2. `.github/workflows` ディレクトリに `github-actions-demo.yml` という名前のファイルを作成します。 詳細については、「[新しいファイルの作成](/github/managing-files-in-a-repository/creating-new-files)」を参照してください。 -3. 次の YAML コンテンツを `github-actions-demo.yml` ファイルにコピーします: {% raw %} - ```yaml{:copy} - name: GitHub Actions Demo - on: [push] - jobs: - Explore-GitHub-Actions: - runs-on: ubuntu-latest - steps: - - run: echo "🎉 The job was automatically triggered by a ${{ github.event_name }} event." - - run: echo "🐧 This job is now running on a ${{ runner.os }} server hosted by GitHub!" - - run: echo "🔎 The name of your branch is ${{ github.ref }} and your repository is ${{ github.repository }}."{% endraw %} - - name: Check out repository code - uses: {% data reusables.actions.action-checkout %}{% raw %} - - run: echo "💡 The ${{ github.repository }} repository has been cloned to the runner." - - run: echo "🖥️ The workflow is now ready to test your code on the runner." - - name: List files in the repository - run: | - ls ${{ github.workspace }} - - run: echo "🍏 This job's status is ${{ job.status }}." +## Creating your first workflow - ``` - {% endraw %} -3. ページの下部までスクロールして、 **[このコミットに新しいブランチを作成して pull request を開始]** を選択してください。 そして、pull request を作成するために **[新しいファイルを提案]** をクリックしてください。 - ![ワークフローファイルのコミット](/assets/images/help/repository/actions-quickstart-commit-new-file.png) +1. Create a `.github/workflows` directory in your repository on {% data variables.product.prodname_dotcom %} if this directory does not already exist. +1. In the `.github/workflows` directory, create a file named `github-actions-demo.yml`. For more information, see "[Creating new files](/github/managing-files-in-a-repository/creating-new-files)." +1. Copy the following YAML contents into the `github-actions-demo.yml` file: -リポジトリ内のワークフローファイルをブランチにコミットすると、`push` イベントがトリガーされ、ワークフローが実行されます。 + ```yaml{:copy} + name: GitHub Actions Demo + {%- ifversion actions-run-name %} + run-name: {% raw %}${{ github.actor }}{% endraw %} is testing out GitHub Actions 🚀 + {%- endif %} + on: [push] + jobs: + Explore-GitHub-Actions: + runs-on: ubuntu-latest + steps: + - run: echo "🎉 The job was automatically triggered by a {% raw %}${{ github.event_name }}{% endraw %} event." + - run: echo "🐧 This job is now running on a {% raw %}${{ runner.os }}{% endraw %} server hosted by GitHub!" + - run: echo "🔎 The name of your branch is {% raw %}${{ github.ref }}{% endraw %} and your repository is {% raw %}${{ github.repository }}{% endraw %}." + - name: Check out repository code + uses: {% data reusables.actions.action-checkout %} + - run: echo "💡 The {% raw %}${{ github.repository }}{% endraw %} repository has been cloned to the runner." + - run: echo "🖥️ The workflow is now ready to test your code on the runner." + - name: List files in the repository + run: | + ls {% raw %}${{ github.workspace }}{% endraw %} + - run: echo "🍏 This job's status is {% raw %}${{ job.status }}{% endraw %}." + ``` +1. Scroll to the bottom of the page and select **Create a new branch for this commit and start a pull request**. Then, to create a pull request, click **Propose new file**. -## ワークフローの結果を表示する + ![Commit workflow file](/assets/images/help/repository/actions-quickstart-commit-new-file.png) -{% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.actions-tab %} -1. 左サイドバーで、表示するワークフローをクリックします。 +Committing the workflow file to a branch in your repository triggers the `push` event and runs your workflow. - ![左サイドバーのワークフローのリスト](/assets/images/help/repository/actions-quickstart-workflow-sidebar.png) -1. ワークフローの実行リストから、表示させたい実行の名前をクリックしてください。 +## Viewing your workflow results - ![ワークフローの実行の名前](/assets/images/help/repository/actions-quickstart-run-name.png) -1. **[ジョブ]** で **[Explore-GitHub-Actions]** ジョブをクリックします。 +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.actions-tab %} +1. In the left sidebar, click the workflow you want to see. - ![ジョブを探す](/assets/images/help/repository/actions-quickstart-job.png) -1. ログには、各ステップの処理方法が表示されます。 いずれかのステップを展開して、詳細を表示します。 + ![Workflow list in left sidebar](/assets/images/help/repository/actions-quickstart-workflow-sidebar.png) +1. From the list of workflow runs, click the name of the run you want to see. - ![ワークフロー結果の例](/assets/images/help/repository/actions-quickstart-logs.png) + ![Name of workflow run](/assets/images/help/repository/actions-quickstart-run-name.png) +1. Under **Jobs** , click the **Explore-GitHub-Actions** job. + + ![Locate job](/assets/images/help/repository/actions-quickstart-job.png) +1. The log shows you how each of the steps was processed. Expand any of the steps to view its details. + + ![Example workflow results](/assets/images/help/repository/actions-quickstart-logs.png) - たとえば、リポジトリ内のファイルのリストを確認できます。![アクションの詳細の例](/assets/images/help/repository/actions-quickstart-log-detail.png) + For example, you can see the list of files in your repository: + ![Example action detail](/assets/images/help/repository/actions-quickstart-log-detail.png) -## その他のスターターワークフロー +## More starter workflows {% data reusables.actions.workflow-template-overview %} -## より複雑な例 +## More complex examples {% data reusables.actions.link-to-example-library %} -## 次の手順 +## Next steps -追加したワークフロー例では、コードがブランチにプッシュされるたびに実行され、{% data variables.product.prodname_actions %} がリポジトリのコンテンツを処理できる方法が示されます。 ただし、これは {% data variables.product.prodname_actions %} で可能なことの一部にすぎません。 +The example workflow you just added runs each time code is pushed to the branch, and shows you how {% data variables.product.prodname_actions %} can work with the contents of your repository. But this is only the beginning of what you can do with {% data variables.product.prodname_actions %}: -- リポジトリには、さまざまなイベントに基づいてさまざまなジョブをトリガーする複数のワークフローを含めることができます。 -- ワークフローを使用してソフトウェアテストアプリをインストールし、{% data variables.product.prodname_dotcom %} のランナーでコードを自動的にテストすることができます。 +- Your repository can contain multiple workflows that trigger different jobs based on different events. +- You can use a workflow to install software testing apps and have them automatically test your code on {% data variables.product.prodname_dotcom %}'s runners. -{% data variables.product.prodname_actions %} は、アプリケーション開発プロセスのほぼすべての要素を自動化するのに役立ちます。 使い始める準備はできていますか。 {% data variables.product.prodname_actions %} で次のステップに進む際に役立つ、以下のようなリソースを参照してください。 +{% data variables.product.prodname_actions %} can help you automate nearly every aspect of your application development processes. Ready to get started? Here are some helpful resources for taking your next steps with {% data variables.product.prodname_actions %}: -- 詳しいチュートリアルについては、「[{% data variables.product.prodname_actions %}](/actions/learn-github-actions)」を参照してください。 +- "[Learn {% data variables.product.prodname_actions %}](/actions/learn-github-actions)" for an in-depth tutorial. diff --git a/translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md b/translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md index 5033dda0ed..0db7b2a3d4 100644 --- a/translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md +++ b/translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md @@ -27,7 +27,23 @@ You must store workflow files in the `.github/workflows` directory of your repos ## `name` -The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's actions page. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository. +The name of your workflow. {% data variables.product.prodname_dotcom %} displays the names of your workflows on your repository's "Actions" tab. If you omit `name`, {% data variables.product.prodname_dotcom %} sets it to the workflow file path relative to the root of the repository. + +{% ifversion actions-run-name %} +## `run-name` + +The name for workflow runs generated from the workflow. {% data variables.product.prodname_dotcom %} displays the workflow run name in the list of workflow runs on your repository's "Actions" tab. If you omit `run-name`, the run name is set to event-specific information for the workflow run. For example, for a workflow triggered by a `push` or `pull_request` event, it is set as the commit message. + +This value can include expressions and can reference the [`github`](/actions/learn-github-actions/contexts#github-context) and [`inputs`](/actions/learn-github-actions/contexts#inputs-context) contexts. + +### Example + +{% raw %} +```yaml +run-name: Deploy to ${{ inputs.deploy_target }} by @${{ github.actor }} +``` +{% endraw %} +{% endif %} ## `on` diff --git a/translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md b/translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md index b02b39762f..fa49ebc9f5 100644 --- a/translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md +++ b/translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: エンタープライズ向けの Dependabot の有効化 -intro: '{% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} と {% data variables.product.prodname_dependabot_updates %}{% endif %} を有効にすることで、{% data variables.product.product_location %} のユーザーがコード依存関係の脆弱性を見つけて修正できるようにすることができます。' +title: Enabling Dependabot for your enterprise +intro: 'You can allow users of {% data variables.product.product_location %} to find and fix vulnerabilities in code dependencies by enabling {% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} and {% data variables.product.prodname_dependabot_updates %}{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Dependabot redirect_from: @@ -22,107 +22,112 @@ topics: - Security - Dependency graph - Dependabot -ms.openlocfilehash: 271e0ad3a81ea8c8cefac9c4a4db6e18ecad5069 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: '146455574' --- -## {% data variables.product.product_name %} の {% data variables.product.prodname_dependabot %} について -{% data variables.product.prodname_dependabot %} を使用すると、{% data variables.product.product_location %} のユーザーが依存関係の脆弱性を見つけて修正するのに役立ちます。{% ifversion ghes > 3.2 %}{% data variables.product.prodname_dependabot_alerts %} を有効にして、脆弱な依存関係についてユーザーに通知し、{% data variables.product.prodname_dependabot_updates %} を有効にして脆弱性を修正し、依存関係を最新バージョンに更新することができます。 +## About {% data variables.product.prodname_dependabot %} for {% data variables.product.product_name %} -### {% data variables.product.prodname_dependabot_alerts %} について +{% data variables.product.prodname_dependabot %} helps users of {% data variables.product.product_location %} find and fix vulnerabilities in their dependencies.{% ifversion ghes > 3.2 %} You can enable {% data variables.product.prodname_dependabot_alerts %} to notify users about vulnerable dependencies and {% data variables.product.prodname_dependabot_updates %} to fix the vulnerabilities and keep dependencies updated to the latest version. + +### About {% data variables.product.prodname_dependabot_alerts %} {% endif %} {% data reusables.dependabot.dependabot-alerts-beta %} -{% data variables.product.prodname_dependabot_alerts %} を使用して、{% data variables.product.prodname_dotcom %} ではリポジトリ内の安全でない依存関係を特定し、{% data variables.product.prodname_advisory_database %} のデータと依存関係グラフ サービスを使用して、{% data variables.product.product_location %} にアラートを作成します。 +With {% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dotcom %} identifies insecure dependencies in repositories and creates alerts on {% data variables.product.product_location %}, using data from the {% data variables.product.prodname_advisory_database %} and the dependency graph service. {% data reusables.repositories.tracks-vulnerabilities %} -エンタープライズに対して {% data variables.product.prodname_dependabot_alerts %} を有効にすると、脆弱性データが {% data variables.product.prodname_advisory_database %} からインスタンスに 1 時間に 1 回同期されます。 {% data variables.product.company_short %} でレビューされたアドバイザリのみが同期されます。 {% data reusables.security-advisory.link-browsing-advisory-db %} +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, vulnerability data is synced from the {% data variables.product.prodname_advisory_database %} to your instance once every hour. Only {% data variables.product.company_short %}-reviewed advisories are synchronized. {% data reusables.security-advisory.link-browsing-advisory-db %} -また、脆弱性データはいつでも手動で同期することができます。 詳細については、「[エンタープライズの脆弱性データの表示](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)」を参照してください。 +You can also choose to manually sync vulnerability data at any time. For more information, see "[Viewing the vulnerability data for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)." {% note %} -**注**: {% data variables.product.prodname_dependabot_alerts %} を有効にすると、{% data variables.product.product_location %} のコードやコードに関する情報は、{% data variables.product.prodname_dotcom_the_website %} にアップロードされません。 +**Note:** When you enable {% data variables.product.prodname_dependabot_alerts %}, no code or information about code from {% data variables.product.product_location %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. {% endnote %} -{% data variables.product.product_location %} が脆弱性に関する情報を受け取ると、影響を受けるバージョンの依存関係を使用する {% data variables.product.product_location %} 内のリポジトリを識別し、{% data variables.product.prodname_dependabot_alerts %} を生成します。 新しい {% data variables.product.prodname_dependabot_alerts %} についてユーザーに自動的に通知するかどうかを選択できます。 +When {% data variables.product.product_location %} receives information about a vulnerability, it identifies repositories in {% data variables.product.product_location %} that use the affected version of the dependency and generates {% data variables.product.prodname_dependabot_alerts %}. You can choose whether or not to notify users automatically about new {% data variables.product.prodname_dependabot_alerts %}. -{% data variables.product.prodname_dependabot_alerts %} が有効になっているリポジトリの場合、マニフェスト ファイルまたはロック ファイルを含む既定のブランチへの任意のプッシュでスキャンがトリガーされます。 さらに、{% data variables.product.product_location %} に新しい脆弱性レコードが追加されると、{% data variables.product.product_name %} では {% data variables.product.product_location %} のすべての既存のリポジトリをスキャンし、脆弱なリポジトリについてのアラートを生成します。 詳細については、「[{% data variables.product.prodname_dependabot_alerts %}について](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)」を参照してください。 +For repositories with {% data variables.product.prodname_dependabot_alerts %} enabled, scanning is triggered on any push to the default branch that contains a manifest file or lock file. Additionally, when a new vulnerability record is added to {% data variables.product.product_location %}, {% data variables.product.product_name %} scans all existing repositories on {% data variables.product.product_location %} and generates alerts for any repository that is vulnerable. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." {% ifversion ghes > 3.2 %} -### {% data variables.product.prodname_dependabot_updates %} について +### About {% data variables.product.prodname_dependabot_updates %} {% data reusables.dependabot.beta-security-and-version-updates %} -{% data variables.product.prodname_dependabot_alerts %} を有効にした後、{% data variables.product.prodname_dependabot_updates %} を有効にすることができます。 {% data variables.product.prodname_dependabot_updates %} が {% data variables.product.product_location %} に対して有効になっている場合、ユーザーはリポジトリを構成して、依存関係の更新とセキュリティ保護が自動的に行われるようにすることができます。 +After you enable {% data variables.product.prodname_dependabot_alerts %}, you can choose to enable {% data variables.product.prodname_dependabot_updates %}. When {% data variables.product.prodname_dependabot_updates %} are enabled for {% data variables.product.product_location %}, users can configure repositories so that their dependencies are updated and kept secure automatically. {% note %} -**注**: {% data variables.product.product_name %} の {% data variables.product.prodname_dependabot_updates %} には、セルフホステッド ランナーを含む {% data variables.product.prodname_actions %} が必要です。 +**Note:** {% data variables.product.prodname_dependabot_updates %} on {% data variables.product.product_name %} requires {% data variables.product.prodname_actions %} with self-hosted runners. {% endnote %} -既定では、{% data variables.product.prodname_dependabot %} で使用される {% data variables.product.prodname_actions %} ランナーは、上流パッケージ マネージャーから更新されたパッケージをダウンロードするために、インターネットにアクセスする必要があります。 {% data variables.product.prodname_github_connect %} を利用する {% data variables.product.prodname_dependabot_updates %} の場合、インターネット アクセスにより、{% data variables.product.prodname_dotcom_the_website %} でホストされる依存関係とアドバイザリへのアクセスを可能にするトークンがランナーに提供されます。 +By default, {% data variables.product.prodname_actions %} runners used by {% data variables.product.prodname_dependabot %} need access to the internet, to download updated packages from upstream package managers. For {% data variables.product.prodname_dependabot_updates %} powered by {% data variables.product.prodname_github_connect %}, internet access provides your runners with a token that allows access to dependencies and advisories hosted on {% data variables.product.prodname_dotcom_the_website %}. -{% data variables.product.prodname_dependabot_updates %} では、{% data variables.product.company_short %} によって、依存関係を更新するためのプル要求が 2 つの方法で自動的に作成されます。 +With {% data variables.product.prodname_dependabot_updates %}, {% data variables.product.company_short %} automatically creates pull requests to update dependencies in two ways. -- **{% data variables.product.prodname_dependabot_version_updates %}** : 追跡対象の依存関係の新しいバージョンがリリースされたときに {% data variables.product.prodname_dependabot %} がプル要求を作成できるように、ユーザーは {% data variables.product.prodname_dependabot %} 構成ファイルをリポジトリに追加します。 詳細については、「[{% data variables.product.prodname_dependabot_version_updates %} について](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)」を参照してください。 -- **{% data variables.product.prodname_dependabot_security_updates %}** : ユーザーは、{% data variables.product.prodname_dotcom %} でリポジトリの依存関係グラフのいずれかの依存関係で脆弱性が検出されたときに、{% data variables.product.prodname_dependabot %} がプル要求を作成できるようにリポジトリ設定を切り替えます。 詳細については、「[{% data variables.product.prodname_dependabot_alerts %} について](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)」と「[{% data variables.product.prodname_dependabot_security_updates %} について](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)」を参照してください。 +- **{% data variables.product.prodname_dependabot_version_updates %}**: Users add a {% data variables.product.prodname_dependabot %} configuration file to the repository to enable {% data variables.product.prodname_dependabot %} to create pull requests when a new version of a tracked dependency is released. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +- **{% data variables.product.prodname_dependabot_security_updates %}**: Users toggle a repository setting to enable {% data variables.product.prodname_dependabot %} to create pull requests when {% data variables.product.prodname_dotcom %} detects a vulnerability in one of the dependencies of the dependency graph for the repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)" and "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)." {% endif %} -## {% data variables.product.prodname_dependabot_alerts %} の有効化 +## Enabling {% data variables.product.prodname_dependabot_alerts %} -{% data variables.product.prodname_dependabot_alerts %} を有効にする前に、次のことを行います。 -- {% data variables.product.prodname_github_connect %} を有効にする必要がある。 詳細については、「[{% data variables.product.prodname_github_connect %} の管理](/admin/configuration/configuring-github-connect/managing-github-connect)」を参照してください。{% ifversion ghes %} -- 依存関係グラフを有効にする必要がある。 詳細については、「[企業の依存関係グラフの有効化](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)」を参照してください。{% endif %} +Before you can enable {% data variables.product.prodname_dependabot_alerts %}: +- You must enable {% data variables.product.prodname_github_connect %}. For more information, see "[Managing {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/managing-github-connect)."{% ifversion ghes %} +- You must enable the dependency graph. For more information, see "[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)."{% endif %} -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} {%- ifversion dependabot-updates-github-connect %} -1. [{% data variables.product.prodname_dependabot %}] の [ユーザーはオープン ソース コードの依存関係の脆弱性アラートを受け取ることができる] の右側にあるドロップダウン メニューを選択し、 **[有効 (通知なし)]** をクリックします。 必要に応じて、通知ありでアラートを有効にするには、 **[有効 (通知あり)]** をクリックします。 +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +{%- ifversion dependabot-updates-github-connect %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can receive vulnerability alerts for open source code dependencies", select the dropdown menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. - ![脆弱性に対するリポジトリのスキャンを有効化するドロップダウンメニューのスクリーンショット](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) + ![Screenshot of the dropdown menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) {%- else %} -1. [リポジトリは脆弱性のスキャンが可能] で、ドロップダウンメニューを選択して、 **[有効 (通知なし)]** を選択します。 必要に応じて、通知ありでアラートを有効にするには、 **[有効 (通知あり)]** をクリックします。 - ![脆弱性に対するリポジトリのスキャンを有効化するドロップダウンメニュー](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) {%- endif %} {% tip %} +1. Under "Repositories can be scanned for vulnerabilities", select the drop-down menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. + ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) +{%- endif %} + {% tip %} - **ヒント**: メールの過負荷を避けるため、最初の数日間は {% data variables.product.prodname_dependabot_alerts %} を通知なしに設定することをお勧めします。 数日後、通知を有効化して、通常どおり {% data variables.product.prodname_dependabot_alerts %} を受信できます。 + **Tip**: We recommend configuring {% data variables.product.prodname_dependabot_alerts %} without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_alerts %} as usual. {% endtip %} {% ifversion dependabot-updates-github-connect %} -## {% data variables.product.prodname_dependabot_updates %} の有効化 +## Enabling {% data variables.product.prodname_dependabot_updates %} -エンタープライズで {% data variables.product.prodname_dependabot_alerts %} を有効にした後、{% data variables.product.prodname_dependabot_updates %} を有効にできます。 +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, you can enable {% data variables.product.prodname_dependabot_updates %}. -{% ifversion ghes %}{% data variables.product.prodname_dependabot_updates %} を有効にする前に、セルフホステッド ランナーで {% data variables.product.prodname_actions %} を使用するように {% data variables.product.product_location %} を構成する必要があります。 詳細については、「[GitHub Enterprise Server の {% data variables.product.prodname_actions %} の概要](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)」を参照してください。 +{% ifversion ghes %} +{% data reusables.dependabot.enabling-actions-for-ghes %} For more information, see "[Getting started with {% data variables.product.prodname_actions %} for GitHub Enterprise Server](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)." -エンタープライズでクラスタリングを使用している場合、{% data variables.product.prodname_dependabot_updates %} は {% data variables.product.product_name %} ではサポートされません。 +{% data variables.product.prodname_dependabot_updates %} are not supported on {% data variables.product.product_name %} if your enterprise uses clustering. {% endif %} -{% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. [セキュリティ] で、 **{% data variables.product.prodname_dependabot_security_updates %}** を選択します。 +{% data reusables.enterprise_site_admin_settings.sign-in %} +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.advanced-security-tab %} +1. Under "Security", select **{% data variables.product.prodname_dependabot_security_updates %}**. - ![{% data variables.product.prodname_dependabot_security_updates %} を有効または無効にするチェックボックスのスクリーンショット](/assets/images/enterprise/management-console/enable-dependabot-updates.png) + ![Screenshot of the checkbox to enable or disable {% data variables.product.prodname_dependabot_security_updates %}](/assets/images/enterprise/management-console/enable-dependabot-updates.png) {% data reusables.enterprise_management_console.save-settings %} -1. **[Visit your instance]\(インスタンスにアクセスする)** をクリックします。 -1. 依存関係を更新するプル要求を作成するようにセルフホステッド ランナーを構成します。 詳細については、「[エンタープライズでの {% data variables.product.prodname_dependabot_updates %} のセルフホステッド ランナーの管理](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)」を参照してください。 -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} -1. [{% data variables.product.prodname_dependabot %}] で、[ユーザーは脆弱でないオープン ソース コードの依存関係に簡単にアップグレードできる] の右側にある **[有効]** をクリックします。 +1. Click **Visit your instance**. +1. Configure self-hosted runners to create the pull requests that will update dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can easily upgrade to non-vulnerable open source code dependencies", click **Enable**. - ![脆弱な依存関係の更新を有効にするドロップダウン メニューのスクリーンショット](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) - -{% endif %} {% ifversion ghes > 3.2 %} - -{% data variables.product.prodname_dependabot_alerts %} を有効にする場合は、{% data variables.product.prodname_dependabot_security_updates %} に対して {% data variables.product.prodname_actions %} を設定することも検討する必要があります。 この機能により、開発者は依存関係の脆弱性を修正できます。 詳細については、「[エンタープライズでの {% data variables.product.prodname_dependabot_updates %} のセルフホステッド ランナーの管理](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)」を参照してください。 - -セキュリティを強化する必要がある場合は、プライベート レジストリを使用するように {% data variables.product.prodname_dependabot %} を構成することをお勧めします。 詳細については、「[{% data variables.product.prodname_dependabot %} に対する暗号化されたシークレットを管理する](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)」を参照してください。 + ![Screenshot of the dropdown menu to enable updating vulnerable dependencies](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) + +{% endif %} +{% ifversion ghes > 3.2 %} + +When you enable {% data variables.product.prodname_dependabot_alerts %}, you should consider also setting up {% data variables.product.prodname_actions %} for {% data variables.product.prodname_dependabot_security_updates %}. This feature allows developers to fix vulnerabilities in their dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." + +If you need enhanced security, we recommend configuring {% data variables.product.prodname_dependabot %} to use private registries. For more information, see "[Managing encrypted secrets for {% data variables.product.prodname_dependabot %}](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)." {% endif %} diff --git a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md index e4c5db0a41..5ec3ef3506 100644 --- a/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/ja-JP/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md @@ -108,9 +108,12 @@ If you allow members to create repositories in your organizations, you can choos ![Screenshot showing the list of disabled options from forking policy](/assets/images/help/business-accounts/restrict-personal-namespace-enabled-setting.png){% endif %} ## Enforcing a policy for forking private or internal repositories - Across all organizations owned by your enterprise, you can allow people with access to a private or internal repository to fork the repository, never allow forking of private or internal repositories, or allow owners to administer the setting on the organization level. +{% ifversion org-owners-limit-forks-creation %} +People with admin permissions can set a more granular forking policy. For more information, see "[Managing the forking policy for your organization](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization)." +{% endif %} + {% ifversion enterprise-namespace-repo-setting %} {% note %} @@ -122,8 +125,8 @@ Across all organizations owned by your enterprise, you can allow people with acc {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -3. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -4. Under "Repository forking", use the drop-down menu and choose a policy. +1. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +2. Under "Repository forking", use the dropdown menu and choose a policy. ![Drop-down menu with repository forking policy options](/assets/images/help/business-accounts/repository-forking-policy-drop-down.png){% ifversion innersource-fork-policies %} 5. If forking is enabled, you can specify where users are allowed to fork repositories. Review the information about changing the setting and choose a policy. diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md index c653fba912..1885e6d052 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md @@ -37,6 +37,7 @@ topics: The {% data variables.product.prodname_dependabot_security_updates %} feature is available for repositories where you have enabled the dependency graph and {% data variables.product.prodname_dependabot_alerts %}. You will see a {% data variables.product.prodname_dependabot %} alert for every vulnerable dependency identified in your full dependency graph. However, security updates are triggered only for dependencies that are specified in a manifest or lock file. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#dependencies-included)." {% ifversion dependabot-security-updates-unlock-transitive-dependencies %} + {% note %} **Note**: For npm, {% data variables.product.prodname_dependabot %} will raise a pull request to update an explicitly defined dependency to a secure version, even if it means updating the parent dependency or dependencies{% ifversion dependabot-security-updates-npm %}, or even removing a sub-dependency that is no longer needed by the parent{% endif %}. For other ecosystems, {% data variables.product.prodname_dependabot %} is unable to update an indirect or transitive dependency if it would also require an update to the parent dependency. For more information, see "[Dependabot tries to update dependencies without an alert](/en/code-security/dependabot/working-with-dependabot/troubleshooting-dependabot-errors#dependabot-tries-to-update-dependencies-without-an-alert)." @@ -47,6 +48,8 @@ You can enable a related feature, {% data variables.product.prodname_dependabot_ {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + ## About pull requests for security updates Each pull request contains everything you need to quickly and safely review and merge a proposed fix into your project. This includes information about the vulnerability like release notes, changelog entries, and commit details. Details of which vulnerability a pull request resolves are hidden from anyone who does not have access to {% data variables.product.prodname_dependabot_alerts %} for the repository. diff --git a/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md b/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md index 8c8901ab87..7620498058 100644 --- a/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md +++ b/translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md @@ -1,6 +1,6 @@ --- -title: GitHub Dependabot のバージョンアップデートについて -intro: '{% data variables.product.prodname_dependabot %} を使用して、使用するパッケージを最新バージョンに更新しておくことができます。' +title: About Dependabot version updates +intro: 'You can use {% data variables.product.prodname_dependabot %} to keep the packages you use updated to the latest versions.' redirect_from: - /github/administering-a-repository/about-dependabot - /github/administering-a-repository/about-github-dependabot @@ -21,53 +21,51 @@ topics: - Dependencies - Pull requests shortTitle: Dependabot version updates -ms.openlocfilehash: 56bac2fbf2fb42a418cffbd478aa526803b124d9 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '145186085' --- -{% data reusables.dependabot.beta-security-and-version-updates %} {% data reusables.dependabot.enterprise-enable-dependabot %} -## {% data variables.product.prodname_dependabot_version_updates %} について +{% data reusables.dependabot.beta-security-and-version-updates %} +{% data reusables.dependabot.enterprise-enable-dependabot %} -{% data variables.product.prodname_dependabot %} は、依存関係を維持する手間を省きます。 これを使用して、リポジトリが依存するパッケージおよびアプリケーションの最新リリースに自動的に対応できるようにすることができます。 +## About {% data variables.product.prodname_dependabot_version_updates %} -`dependabot.yml` 構成ファイルをリポジトリにチェックインして、{% 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 %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -{% data variables.product.prodname_dependabot %} で以前の依存関係が特定されると、マニフェストを依存関係の最新バージョンに更新する pull request が発行されます。 ベンダーの依存関係の場合、{% data variables.product.prodname_dependabot %} はプルリクエストを生成して、古い依存関係を新しいバージョンに直接置き換えます。 テストに合格したことを確認し、プルリクエストの概要に含まれている変更履歴とリリースノートを確認して、マージします。 詳細については、「[{% data variables.product.prodname_dependabot %} バージョンの更新の構成](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)」を参照してください。 +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a `dependabot.yml` configuration file into your repository. The configuration file specifies the location of the manifest, or of other package definition files, stored in your repository. {% data variables.product.prodname_dependabot %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. -_セキュリティ更新プログラム_ を有効にすると、{% data variables.product.prodname_dependabot %} でも pull request が発行され、脆弱性のある依存関係を更新します。 詳細については、「[{% data variables.product.prodname_dependabot_security_updates %}について](/github/managing-security-vulnerabilities/about-dependabot-security-updates)」を参照してください。 +When {% data variables.product.prodname_dependabot %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot %} raises a pull request to replace the outdated dependency with the new version directly. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Configuring {% data variables.product.prodname_dependabot %} version updates](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)." + +If you enable _security updates_, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + {% data reusables.dependabot.dependabot-tos %} -## {% data variables.product.prodname_dependabot %} のプルリクエストの頻度 +## Frequency of {% data variables.product.prodname_dependabot %} pull requests -設定ファイルで、新しいバージョンの各エコシステムをチェックする頻度を、毎日、毎週、毎月の中から指定します。 +You specify how often to check each ecosystem for new versions in the configuration file: daily, weekly, or monthly. {% data reusables.dependabot.initial-updates %} -セキュリティアップデートを有効にした場合、セキュリティアップデートの追加に対するプルリクエストが表示されることがあります。 これらは、デフォルト ブランチへの依存関係に対する {% data variables.product.prodname_dependabot %} アラートによってトリガーされます。 {% data variables.product.prodname_dependabot %} はプルリクエストを自動的に生成し、脆弱性のある依存関係を更新します。 +If you've enabled security updates, you'll sometimes see extra pull requests for security updates. These are triggered by a {% data variables.product.prodname_dependabot %} alert for a dependency on your default branch. {% data variables.product.prodname_dependabot %} automatically raises a pull request to update the vulnerable dependency. -## サポートされているリポジトリとエコシステム +## Supported repositories and ecosystems -サポートされているパッケージマネージャーのいずれかの依存関係マニフェストまたはロックファイルを含むリポジトリのバージョン更新を設定できます。 一部のパッケージマネージャーでは、依存関係のベンダを設定することもできます。 詳細については、「[dependabot.yml ファイルの構成オプション](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)」を参照してください。 +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for the dependabot.yml file](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)." {% note %} {% data reusables.dependabot.private-dependencies-note %} -{% data variables.product.prodname_dependabot %} は、すべてのパッケージマネージャーに対してプライベートな {% data variables.product.prodname_dotcom %} 依存関係をサポートしません。 詳細は、以下の表をご覧ください。 +{% 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. {% endnote %} {% data reusables.dependabot.supported-package-managers %} -リポジトリですでに依存関係管理にインテグレーションを使用している場合は、{% data variables.product.prodname_dependabot %} を有効にする前にそれを無効にする必要があります。 {% ifversion fpt or ghec %}詳細については、「[統合について](/github/customizing-your-github-workflow/about-integrations)」を参照してください。{% endif %} +If your repository already uses an integration for dependency management, you will need to disable this before enabling {% data variables.product.prodname_dependabot %}. {% ifversion fpt or ghec %}For more information, see "[About integrations](/github/customizing-your-github-workflow/about-integrations)."{% endif %} -## {% data variables.product.prodname_dependabot %} バージョン更新の通知について +## About notifications for {% data variables.product.prodname_dependabot %} version updates -{% data variables.product.company_short %} で通知をフィルター処理して、{% data variables.product.prodname_dependabot %} によって作成された pull request の通知を表示できます。 詳細については、「[受信トレイからの通知の管理](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)」を参照してください。 +You can filter your notifications on {% data variables.product.company_short %} to show notifications for pull requests created by {% data variables.product.prodname_dependabot %}. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)." diff --git a/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md b/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md index 41e41302ae..c5c6fdf15f 100644 --- a/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md +++ b/translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md @@ -1,6 +1,6 @@ --- -title: サプライ チェーンのセキュリティについて -intro: '{% data variables.product.product_name %} は、環境内の依存関係の理解から、それらの依存関係の脆弱性の把握{% ifversion fpt or ghec or ghes > 3.2 %}やパッチの適用{% endif %}まで、サプライ チェーンをセキュリティで保護するのに役立ちます。' +title: About supply chain security +intro: '{% data variables.product.product_name %} helps you secure your supply chain, from understanding the dependencies in your environment, to knowing about vulnerabilities in those dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and patching them{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Supply chain security redirect_from: @@ -19,136 +19,154 @@ topics: - Dependencies - Pull requests - Repositories -ms.openlocfilehash: 2ad16960d0445994d5414390a62e16d719a10e6c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147064891' --- -## GitHub でのサプライ チェーンのセキュリティについて -オープン ソースの使用が急速に進んでおり、ほとんどのプロジェクトは数百ものオープンソース依存関係を利用しています。 これにより、セキュリティ上の問題が浮上します。もしも、使用している依存関係に脆弱性があるとしたら、どうなるでしょうか、 ユーザーをサプライ チェーン攻撃のリスクにさらす可能性があります。 サプライ チェーンを保護するために行うことができる最も重要なことの 1 つは、脆弱な依存関係にパッチを適用{% ifversion GH-advisory-db-supports-malware %}したり、マルウェアを置き換えたり{% endif %}することです。 +## About supply chain security at GitHub -依存関係をサプライ チェーンに直接追加するときは、マニフェスト ファイルまたはロックファイルで指定します。 依存関係は推移的に含めることもできます。つまり、特定の依存関係を指定しなくても、使用している依存関係が別の依存関係を使用している場合は、その依存関係にも依存することになります。 +With the accelerated use of open source, most projects depend on hundreds of open-source dependencies. This poses a security problem: what if the dependencies you're using are vulnerable? You could be putting your users at risk of a supply chain attack. One of the most important things you can do to protect your supply chain is to patch your vulnerable dependencies{% ifversion GH-advisory-db-supports-malware %} and replace any malware{% endif %}. -{% data variables.product.product_name %} には、環境内の依存関係を理解し{% ifversion ghes < 3.3 or ghae %}、それらの依存関係の脆弱性を把握{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %}、それらの依存関係の脆弱性を把握してパッチを適用{% endif %}できるように、さまざまな機能が用意されています。 +You add dependencies directly to your supply chain when you specify them in a manifest file or a lockfile. Dependencies can also be included transitively, that is, even if you don’t specify a particular dependency, but a dependency of yours uses it, then you’re also dependent on that dependency. -{% data variables.product.product_name %} のサプライ チェーン機能は次のとおりです。 -- **依存関係グラフ** -- **依存関係レビュー** -- **{% data variables.product.prodname_dependabot_alerts %} ** {% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** +{% data variables.product.product_name %} offers a range of features to help you understand the dependencies in your environment{% ifversion ghes < 3.3 or ghae %} and know about vulnerabilities in those dependencies{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %}, know about vulnerabilities in those dependencies, and patch them{% endif %}. + +The supply chain features on {% data variables.product.product_name %} are: +- **Dependency graph** +- **Dependency review** +- **{% data variables.product.prodname_dependabot_alerts %} ** +{% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** - **{% data variables.product.prodname_dependabot_security_updates %}** - - **{% data variables.product.prodname_dependabot_version_updates %}** {% endif %} + - **{% data variables.product.prodname_dependabot_version_updates %}**{% endif %} -依存関係グラフは、サプライ チェーンのセキュリティの中心です。 依存関係グラフによって、リポジトリまたはパッケージについて、すべてのアップストリーム依存関係とパブリック ダウンストリーム依存関係が識別されます。 リポジトリの依存関係とそのプロパティの一部 (脆弱性情報など) を、そのリポジトリの依存関係グラフで確認できます。 +The dependency graph is central to supply chain security. The dependency graph identifies all upstream dependencies and public downstream dependents of a repository or package. You can see your repository’s dependencies and some of their properties, like vulnerability information, on the dependency graph for the repository. -{% data variables.product.prodname_dotcom %} の他のサプライ チェーン機能は、依存関係グラフで提供される情報を利用します。 +Other supply chain features on {% data variables.product.prodname_dotcom %} rely on the information provided by the dependency graph. -- 依存関係レビューは、依存関係グラフを使用して依存関係の変更を特定し、ユーザーが pull request を確認するときにそれらの変更がセキュリティに及ぼす影響を理解するのに役立ちます。 -- {% data variables.product.prodname_dependabot %} は、依存関係グラフによって提供される依存関係データと {% data variables.product.prodname_advisory_database %} で公開されるアドバイザリの一覧を相互参照し、依存関係をスキャンして、潜在的な脆弱性{% ifversion GH-advisory-db-supports-malware %}またはマルウェア{% endif %}が検出されると {% data variables.product.prodname_dependabot_alerts %}を生成します。 -{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %}は、依存関係グラフと {% data variables.product.prodname_dependabot_alerts %}を使用して、リポジトリ内の既知の脆弱性を含む依存関係をユーザーが更新できるように役立ちます。 +- Dependency review uses the dependency graph to identify dependency changes and help you understand the security impact of these changes when you review pull requests. +- {% data variables.product.prodname_dependabot %} cross-references dependency data provided by the dependency graph with the list of advisories published in the {% data variables.product.prodname_advisory_database %}, scans your dependencies and generates {% data variables.product.prodname_dependabot_alerts %} when a potential vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} is detected. +{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %} use the dependency graph and {% data variables.product.prodname_dependabot_alerts %} to help you update dependencies with known vulnerabilities in your repository. -{% data variables.product.prodname_dependabot_version_updates %} では、依存関係グラフは使用されません。代わりに依存関係のセマンティック バージョン管理が利用されます。 {% data variables.product.prodname_dependabot_version_updates %} は、依存関係に脆弱性が含まれない場合でも、依存関係を最新状態に保つために役立ちます。 +{% data variables.product.prodname_dependabot_version_updates %} don't use the dependency graph and rely on the semantic versioning of dependencies instead. {% data variables.product.prodname_dependabot_version_updates %} help you keep your dependencies updated, even when they don’t have any vulnerabilities. {% endif %} -{% ifversion fpt or ghec or ghes %} 個人アカウント、コード、ビルド プロセスの保護など、エンド ツー エンドのサプライ チェーンのセキュリティに関するベスト プラクティス ガイドについては、「[エンド ツー エンドのサプライ チェーンのセキュリティ保護](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)」を参照してください。 +{% ifversion fpt or ghec or ghes %} +For best practice guides on end-to-end supply chain security including the protection of personal accounts, code, and build processes, see "[Securing your end-to-end supply chain](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)." {% endif %} -## 機能の概要 +## Feature overview -### 依存関係グラフとは +### What is the dependency graph -依存関係グラフを生成するために、{% data variables.product.company_short %} は、マニフェストやロックファイルで宣言されているリポジトリの明示的な依存関係を調べます。 有効にすると、依存関係グラフはリポジトリ内のすべての既知のパッケージ マニフェスト ファイルを自動的に解析し、これを使用して既知の依存関係の名前とバージョンを含むグラフを作成します。 +To generate the dependency graph, {% data variables.product.company_short %} looks at a repository’s explicit dependencies declared in the manifest and lockfiles. When enabled, the dependency graph automatically parses all known package manifest files in the repository, and uses this to construct a graph with known dependency names and versions. -- 依存関係グラフには、"_直接_" 依存関係と "_推移的_" 依存関係の情報が含まれます。 -- 依存関係グラフが自動的に更新されるのは、サポートされるマニフェストまたはロック ファイルを既定ブランチに対して変更または追加するプッシュを {% data variables.product.company_short %} にコミットするとき、およびご使用の依存関係のいずれかのリポジトリに対して任意のユーザーが変更をプッシュするときです。 -- 依存関係グラフを表示するには、{% data variables.product.product_name %} 上でリポジトリのメイン ページを開いて **[Insights]\(分析情報\)** タブに移動します。 +- The dependency graph includes information on your _direct_ dependencies and _transitive_ dependencies. +- The dependency graph is automatically updated when you push a commit to {% data variables.product.company_short %} that changes or adds a supported manifest or lock file to the default branch, and when anyone pushes a change to the repository of one of your dependencies. +- You can see the dependency graph by opening the repository's main page on {% data variables.product.product_name %}, and navigating to the **Insights** tab. -{% ifversion dependency-submission-api %} {% data reusables.dependency-submission.dependency-submission-link %} {% endif %} - -依存関係グラフの詳細については、「[依存関係グラフについて](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)」を参照してください。 - -### 依存関係レビューとは - -依存関係レビューは、レビュー担当者と共同作成者が、すべての pull request における依存関係の変更とそのセキュリティへの影響を理解するのに役立ちます。 - -- 依存関係レビューでは、pull request で追加、削除、または更新された依存関係がわかります。 リリース日、依存関係の評判、脆弱性情報を使用して、変更を受け入れるかどうかを判断できます。 -- pull request の依存関係レビューは、 **[Files Changed]\(変更されたファイル\)** タブの詳しい差分を表示すると確認できます。 - -依存関係レビューの詳細については、「[依存関係レビューについて](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)」を参照してください。 - -### Dependabot とは - -{% data variables.product.prodname_dependabot %} は、依存関係のセキュリティ脆弱性をユーザーに通知しすることで、ご使用の依存関係を最新状態に保ちます{% ifversion fpt or ghec or ghes > 3.2 or ghae %}。また、自動的に pull request を開き、依存関係を次に使用可能なセキュア バージョン ({% data variables.product.prodname_dependabot %} アラートがトリガーされたとき) または最新バージョン (リリースが公開されたとき) にアップグレードします{% else %}。こうしてユーザーが依存関係を更新できるようにします{% endif %}。 - -{% ifversion fpt or ghec or ghes > 3.2 %} "{% data variables.product.prodname_dependabot %}" という用語には、次の機能が含まれます。 -- {% data variables.product.prodname_dependabot_alerts %}— リポジトリの **[セキュリティ]** タブとリポジトリの依存関係グラフに表示される通知。 アラートには、プロジェクト内で影響を受けるファイルへのリンクと、修正バージョンに関する情報が含まれています。 -- {% data variables.product.prodname_dependabot_updates %}: - - {% data variables.product.prodname_dependabot_security_updates %}— アラートがトリガーされたときに、更新プログラムをトリガーし、依存関係をセキュアなバージョンにアップグレードします。 - - {% data variables.product.prodname_dependabot_version_updates %}— 更新プログラムをスケジュールして、ご使用の依存関係を最新バージョンに保ちます。 +{% ifversion dependency-submission-api %} +{% data reusables.dependency-submission.dependency-submission-link %} {% endif %} -#### Dependabot アラートとは +For more information about the dependency graph, see "[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)." -{% data variables.product.prodname_dependabot_alerts %}は、依存関係グラフと {% data variables.product.prodname_advisory_database %} (既知の脆弱性{% ifversion GH-advisory-db-supports-malware %}とマルウェア{% endif %}に関するアドバイザリを含む) に基づいて、新しく検出された脆弱性の影響を受けるリポジトリを強調表示します。 +### What is dependency review -- {% data variables.product.prodname_dependabot %} は、次の場合に、スキャンを実行して安全ではない依存関係を検出し、{% data variables.product.prodname_dependabot_alerts %}を送信します。{% ifversion fpt or ghec %} - - {% data variables.product.prodname_advisory_database %} に新しいアドバイザリが追加されたとき。{% else %} - - 新しいアドバイザリ データが {% data variables.product.prodname_dotcom_the_website %} から 1 時間ごとに {% data variables.product.product_location %} に同期されたとき。 {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} - - リポジトリの依存関係グラフが変更されたとき。 -- {% data variables.product.prodname_dependabot_alerts %}が、{% ifversion fpt or ghec or ghes %}リポジトリの **[セキュリティ]** タブと{% endif %}リポジトリの依存関係グラフに表示されたとき。 アラートには、{% ifversion fpt or ghec or ghes %}プロジェクト内の影響を受けるファイルへのリンクと、{% endif %}固定バージョンに関する情報が含まれます。 +Dependency review helps reviewers and contributors understand dependency changes and their security impact in every pull request. -詳細については、「[{% data variables.product.prodname_dependabot_alerts %}について](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)」を参照してください。 +- Dependency review tells you which dependencies were added, removed, or updated, in a pull request. You can use the release dates, popularity of dependencies, and vulnerability information to help you decide whether to accept the change. +- You can see the dependency review for a pull request by showing the rich diff on the **Files Changed** tab. + +For more information about dependency review, see "[About dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)." + +### What is Dependabot + +{% data variables.product.prodname_dependabot %} keeps your dependencies up to date by informing you of any security vulnerabilities in your dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and automatically opens pull requests to upgrade your dependencies to the next available secure version when a {% data variables.product.prodname_dependabot %} alert is triggered, or to the latest version when a release is published{% else %} so that you can update that dependency{% endif %}. {% ifversion fpt or ghec or ghes > 3.2 %} -#### Dependabot 更新プログラムとは +The term "{% data variables.product.prodname_dependabot %}" encompasses the following features: +- {% data variables.product.prodname_dependabot_alerts %}—Displayed notification on the **Security** tab for the repository, and in the repository's dependency graph. The alert includes a link to the affected file in the project, and information about a fixed version. +- {% data variables.product.prodname_dependabot_updates %}: + - {% data variables.product.prodname_dependabot_security_updates %}—Triggered updates to upgrade your dependencies to a secure version when an alert is triggered. + - {% data variables.product.prodname_dependabot_version_updates %}—Scheduled updates to keep your dependencies up to date with the latest version. -2 種類の {% data variables.product.prodname_dependabot_updates %}があります。{% data variables.product.prodname_dependabot %} "_セキュリティ_" 更新プログラムと "_バージョン_" 更新プログラムです。 {% data variables.product.prodname_dependabot %} は、どちらのケースでも依存関係を更新するために自動 pull request を生成しますが、いくつかの違いがあります。 - -{% data variables.product.prodname_dependabot_security_updates %}: - - {% data variables.product.prodname_dependabot %} アラートによってトリガーされます。 - - 既知の脆弱性を解決する最小バージョンに依存関係を更新します。 - - 依存関係グラフがサポートするエコシステムでサポートされます。 - - 構成ファイルは必要ありませんが、既定の動作をオーバーライドするために使用できます - -{% data variables.product.prodname_dependabot_version_updates %}: - - 構成ファイルが必要です - - 構成したスケジュールに従って実行します。 - - 構成と一致する最新バージョンに依存関係を更新します。 - - さまざまな一連のエコシステムでサポートされます。 - -{% data variables.product.prodname_dependabot_updates %}の詳細については、「[{% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)について」および「[{% data variables.product.prodname_dependabot_version_updates %}について](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)」を参照してください。 {% endif %} -## 使用可能な機能 - {% ifversion fpt or ghec %} -パブリック リポジトリ: -- **依存関係グラフ**— 既定で有効になっており、無効にすることはできません。 -- **依存関係レビュー**— 既定で有効になっており、無効にすることはできません。 -- **{% data variables.product.prodname_dependabot_alerts %}** — 既定で有効になっていません。 {% data variables.product.prodname_dotcom %} は、安全ではない依存関係を検出して依存関係グラフに情報を表示しますが、{% data variables.product.prodname_dependabot_alerts %}は既定では生成されません。 リポジトリの所有者または管理者アクセス権を持つユーザーは、{% data variables.product.prodname_dependabot_alerts %}を有効にすることができます。 - また、ユーザーは自らのユーザー アカウントまたは組織が所有するすべてのリポジトリでも、Dependabot アラートを有効化または無効化できます。 詳細については、「[ユーザー アカウントのセキュリティと分析の設定の管理](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)」または「[組織のセキュリティと分析の設定の管理](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)」を参照してください。 +{% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dependabot_security_updates %}, and {% data variables.product.prodname_dependabot_version_updates %} do not use {% data variables.product.prodname_actions %} when they run on {% data variables.product.product_name %}. However, pull requests opened by {% data variables.product.prodname_dependabot %} can trigger workflows that run actions. For more information, see "[Automating {% data variables.product.prodname_dependabot %} with {% data variables.product.prodname_actions %}](/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions)." -プライベート リポジトリ: -- **依存関係グラフ**— 既定では有効になっていません。 この機能は、リポジトリ管理者が有効にすることができます。 詳細については、「[ポジトリの依存関係を調べる](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)」を参照してください。 +{% elsif ghes %} + +{% data variables.product.prodname_dependabot_security_updates %} and {% data variables.product.prodname_dependabot_version_updates %} require {% data variables.product.prodname_actions %} to run on {% data variables.product.product_name %}. {% data variables.product.prodname_dependabot_alerts %} do not require {% data variables.product.prodname_actions %}. For more information, see "[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." + +{% elsif ghae %} + +{% data variables.product.prodname_actions %} is not required for {% data variables.product.prodname_dependabot_alerts %} to run on {% data variables.product.product_name %}. + +{% endif %} + +#### What are Dependabot alerts + +{% data variables.product.prodname_dependabot_alerts %} highlight repositories affected by a newly discovered vulnerability based on the dependency graph and the {% data variables.product.prodname_advisory_database %}, which contains advisories for known vulnerabilities{% ifversion GH-advisory-db-supports-malware %} and malware{% endif %}. + +- {% data variables.product.prodname_dependabot %} performs a scan to detect insecure dependencies and sends {% data variables.product.prodname_dependabot_alerts %} when: +{% ifversion fpt or ghec %} + - A new advisory is added to the {% data variables.product.prodname_advisory_database %}.{% else %} + - New advisory data is synchronized to {% data variables.product.product_location %} each hour from {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} + - The dependency graph for the repository changes. +- {% data variables.product.prodname_dependabot_alerts %} are displayed {% ifversion fpt or ghec or ghes %} on the **Security** tab for the repository and{% endif %} in the repository's dependency graph. The alert includes {% ifversion fpt or ghec or ghes %}a link to the affected file in the project, and {% endif %}information about a fixed version. + +For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)." + +{% ifversion fpt or ghec or ghes > 3.2 %} +#### What are Dependabot updates + +There are two types of {% data variables.product.prodname_dependabot_updates %}: {% data variables.product.prodname_dependabot %} _security_ updates and _version_ updates. {% data variables.product.prodname_dependabot %} generates automatic pull requests to update your dependencies in both cases, but there are several differences. + +{% data variables.product.prodname_dependabot_security_updates %}: + - Triggered by a {% data variables.product.prodname_dependabot %} alert + - Update dependencies to the minimum version that resolves a known vulnerability + - Supported for ecosystems the dependency graph supports + - Does not require a configuration file, but you can use one to override the default behavior + +{% data variables.product.prodname_dependabot_version_updates %}: + - Requires a configuration file + - Run on a schedule you configure + - Update dependencies to the latest version that matches the configuration + - Supported for a different group of ecosystems + +For more information about {% data variables.product.prodname_dependabot_updates %}, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)" and "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +{% endif %} + +## Feature availability + +{% ifversion fpt or ghec %} + +Public repositories: +- **Dependency graph**—enabled by default and cannot be disabled. +- **Dependency review**—enabled by default and cannot be disabled. +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. {% data variables.product.prodname_dotcom %} detects insecure dependencies and displays information in the dependency graph, but does not generate {% data variables.product.prodname_dependabot_alerts %} by default. Repository owners or people with admin access can enable {% data variables.product.prodname_dependabot_alerts %}. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." + +Private repositories: +- **Dependency graph**—not enabled by default. The feature can be enabled by repository administrators. For more information, see "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." {% ifversion fpt %} -- **依存関係レビュー**— {% data variables.product.prodname_ghe_cloud %} を使用し、{% data variables.product.prodname_GH_advanced_security %} のライセンスを持つ組織が所有するプライベート リポジトリでも利用できます。 詳細については、[{% data variables.product.prodname_ghe_cloud %} ドキュメント](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)を参照してください。 +- **Dependency review**—available in private repositories owned by organizations that use {% data variables.product.prodname_ghe_cloud %} and have a license for {% data variables.product.prodname_GH_advanced_security %}. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). {% elsif ghec %} -- **依存関係レビュー**— ユーザーに {% data variables.product.prodname_GH_advanced_security %} のライセンスがあり、依存関係グラフが有効になっていれば、組織が所有するプライベート リポジトリでも利用できます。 詳細については、「[{% data variables.product.prodname_GH_advanced_security %}について](/get-started/learning-about-github/about-github-advanced-security)」および「[リポジトリの依存関係を調べる](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)」を参照してください。 {% endif %} -- **{% data variables.product.prodname_dependabot_alerts %}** — 既定で有効になっていません。 プライベートリポジトリの所有者、または管理アクセス権を持つユーザは、リポジトリの依存関係グラフと {% data variables.product.prodname_dependabot_alerts %} を有効にすることで、{% data variables.product.prodname_dependabot_alerts %} を有効化できます。 - また、ユーザーは自らのユーザー アカウントまたは組織が所有するすべてのリポジトリでも、Dependabot アラートを有効化または無効化できます。 詳細については、「[ユーザー アカウントのセキュリティと分析の設定の管理](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)」または「[組織のセキュリティと分析の設定の管理](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)」を参照してください。 +- **Dependency review**—available in private repositories owned by organizations provided you have a license for {% data variables.product.prodname_GH_advanced_security %} and the dependency graph enabled. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)" and "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." +{% endif %} +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Owners of private repositories, or people with admin access, can enable {% data variables.product.prodname_dependabot_alerts %} by enabling the dependency graph and {% data variables.product.prodname_dependabot_alerts %} for their repositories. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." -すべての種類のリポジトリ: -- **{% data variables.product.prodname_dependabot_security_updates %}** — 既定で有効になっていません。 {% data variables.product.prodname_dependabot_alerts %} と依存関係グラフを使用する任意のリポジトリで {% data variables.product.prodname_dependabot_security_updates %} を有効にすることができます。 セキュリティ更新プログラムの有効化の詳細については、「[{% data variables.product.prodname_dependabot_security_updates %}の構成](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)」を参照してください。 -- **{% data variables.product.prodname_dependabot_version_updates %}** — 既定で有効になっていません。 リポジトリへの書き込みアクセス許可を持つユーザーは、{% data variables.product.prodname_dependabot_version_updates %}を有効にすることができます。 セキュリティ更新プログラムの有効化の詳細については、「[{% data variables.product.prodname_dependabot_version_updates %} の構成](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)」を参照してください。 +Any repository type: +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} {% ifversion ghes or ghae %} -- **依存関係グラフ** および **{% data variables.product.prodname_dependabot_alerts %}** — 既定で有効になっていません。 どちらの機能も、エンタープライズ所有者によってエンタープライズ レベルで構成されます。 詳細については、{% ifversion ghes %}「[エンタープライズの依存関係グラフの有効化](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)」および{% endif %}「[エンタープライズの {% data variables.product.prodname_dependabot %} の有効化](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)」を参照してください。 -- **依存関係レビュー**— {% data variables.product.product_location %}に対して依存関係グラフが有効になっており、{% data variables.product.prodname_advanced_security %} が組織またはリポジトリで有効になっている場合に使用できます。 詳細については、「[{% data variables.product.prodname_GH_advanced_security %} について](/get-started/learning-about-github/about-github-advanced-security)」を参照してください。 -{% endif %} {% ifversion ghes > 3.2 %} -- **{% data variables.product.prodname_dependabot_security_updates %}** — 既定で有効になっていません。 {% data variables.product.prodname_dependabot_alerts %} と依存関係グラフを使用する任意のリポジトリで {% data variables.product.prodname_dependabot_security_updates %} を有効にすることができます。 セキュリティ更新プログラムの有効化の詳細については、「[{% data variables.product.prodname_dependabot_security_updates %}の構成](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)」を参照してください。 -- **{% data variables.product.prodname_dependabot_version_updates %}** — 既定で有効になっていません。 リポジトリへの書き込みアクセス許可を持つユーザーは、{% data variables.product.prodname_dependabot_version_updates %}を有効にすることができます。 セキュリティ更新プログラムの有効化の詳細については、「[{% data variables.product.prodname_dependabot_version_updates %} の構成](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)」を参照してください。 +- **Dependency graph** and **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Both features are configured at an enterprise level by the enterprise owner. For more information, see {% ifversion ghes %}"[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)" and {% endif %}"[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." +- **Dependency review**—available when dependency graph is enabled for {% data variables.product.product_location %} and {% data variables.product.prodname_advanced_security %} is enabled for the organization or repository. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)." +{% endif %} +{% ifversion ghes > 3.2 %} +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} diff --git a/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md index 70b27849c7..5aca361ee0 100644 --- a/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md +++ b/translations/ja-JP/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md @@ -1,7 +1,7 @@ --- title: Changing the machine type for your codespace shortTitle: Change the machine type -intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for work you''re doing.' +intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.' product: '{% data reusables.gated-features.codespaces %}' versions: fpt: '*' @@ -23,9 +23,17 @@ type: how_to {% data reusables.codespaces.codespaces-machine-types %} You can choose an alternative machine type either when you create a codespace or at any time after you've created a codespace. -For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." For information on changing the machine type within {% data variables.product.prodname_vscode %}, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code#changing-the-machine-type-in-visual-studio-code)." +For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." -## Changing the machine type in {% data variables.product.prodname_dotcom %} +## Changing the machine type + +{% note %} + +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} + +{% endnote %} + +{% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} @@ -37,33 +45,64 @@ For information on choosing a machine type when you create a codespace, see "[Cr 1. Click **Change machine type**. !['Change machine type' menu option](/assets/images/help/codespaces/change-machine-type-menu-option.png) - 1. If multiple machine types are available for your codespace, choose the type of machine you want to use. ![Dialog box showing available machine types to choose](/assets/images/help/codespaces/change-machine-type-choice.png) +1. Click **Update codespace**. - {% note %} +{% endwebui %} - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +{% vscode %} - {% endnote %} +{% data reusables.codespaces.changing-machine-type-in-vscode %} -2. Click **Update codespace**. +{% endvscode %} - The change will take effect the next time your codespace restarts. +{% cli %} -## Force an immediate update of a currently running codespace +You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} command to change the machine type of a codespace. To use this command, you'll first need to find out the available machine types for your codespace. -If you change the machine type of a codespace you are currently using, and you want to apply the changes immediately, you can force the codespace to restart. +1. To view your list of codespaces, in a terminal, enter the following command. + + ``` + gh codespace list + ``` +1. Optionally, to find the current machine type for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME + ``` -1. At the bottom left of your codespace window, click **{% data variables.product.prodname_codespaces %}**. + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. The permanent names are listed under the **NAME** column in the list returned by `gh codespace list`. - ![Click '{% data variables.product.prodname_codespaces %}'](/assets/images/help/codespaces/codespaces-button.png) + If you're prompted to request the `codespace` scope, follow the instructions in the terminal. -1. From the options that are displayed at the top of the page select **Codespaces: Stop Current Codespace**. + Details for the current machine are listed under the `machine` field. +1. To find the available machine types for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME/machines + ``` - !['Suspend Current Codespace' option](/assets/images/help/codespaces/suspend-current-codespace.png) + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. +1. To change the machine type for a codespace, enter the following command. -1. After the codespace is stopped, click **Restart codespace**. + ``` + gh codespace edit --machine MACHINE-TYPE-NAME + ``` - ![Click 'Resume'](/assets/images/help/codespaces/resume-codespace.png) + Replace `MACHINE-TYPE-NAME` with the name of an available machine type for your codespace, for example `standardLinux32gb`. +1. Using the arrow keys, navigate to the codespace you want to change, then press Enter. + +{% endcli %} + +{% data reusables.codespaces.about-changing-storage-size %} + +{% cli %} + +## Further reading + +- "[Codespaces machines](/rest/codespaces/machines)" in the REST API documentation +- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) in the {% data variables.product.prodname_cli %} manual + +{% endcli %} \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md index 349ed58b1a..1f866ccdd6 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md @@ -78,28 +78,15 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the {% data reusables.codespaces.codespaces-machine-types %} You can change the machine type of your codespace at any time. -1. In {% data variables.product.prodname_vscode_shortname %}, open the Command Palette (`shift command P` / `shift control P`). -1. Search for and select "Codespaces: Change Machine Type." +{% note %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-type-option.png) +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} -1. Click the codespace that you want to change. +{% endnote %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-choose-repo.png) +{% data reusables.codespaces.changing-machine-type-in-vscode %} -1. Choose the machine type you want to use. - - {% note %} - - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} - - {% endnote %} - -1. If the codespace is currently running, a message is displayed asking if you would like to restart and reconnect to your codespace now. - - Click **Yes** if you want to change the machine type used for this codespace immediately. - - If you click **No**, or if the codespace is not currently running, the change will take effect the next time the codespace restarts. +{% data reusables.codespaces.about-changing-storage-size %} ## Deleting a codespace in {% data variables.product.prodname_vscode_shortname %} diff --git a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md index 36f08bad58..0a582c1557 100644 --- a/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md +++ b/translations/ja-JP/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md @@ -31,6 +31,7 @@ You can work with {% data variables.product.prodname_github_codespaces %} in the - [Modify ports in a codespace](#modify-ports-in-a-codespace) - [Access codespace logs](#access-codespace-logs) - [Access remote resources](#access-remote-resources) + - [Change the machine type of a codespace](#change-the-machine-type-of-a-codespace) ## Installing {% data variables.product.prodname_cli %} @@ -206,4 +207,12 @@ You can use the {% data variables.product.prodname_cli %} extension to create a **Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. -{% endnote %} \ No newline at end of file +{% endnote %} + +### Change the machine type of a codespace + +```shell +gh codespace edit -m machine-type-name +``` + +For more information, see the "{% data variables.product.prodname_cli %}" tab of "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)." \ No newline at end of file diff --git a/translations/ja-JP/content/codespaces/the-githubdev-web-based-editor.md b/translations/ja-JP/content/codespaces/the-githubdev-web-based-editor.md index c768525303..3944c4fa55 100644 --- a/translations/ja-JP/content/codespaces/the-githubdev-web-based-editor.md +++ b/translations/ja-JP/content/codespaces/the-githubdev-web-based-editor.md @@ -30,13 +30,15 @@ The {% data variables.product.prodname_serverless %} provides many of the benefi The {% data variables.product.prodname_serverless %} runs entirely in your browser’s sandbox. The editor doesn’t clone the repository, but instead uses the [GitHub Repositories extension](https://code.visualstudio.com/docs/editor/github#_github-repositories-extension) to carry out most of the functionality that you will use. Your work is saved in the browser’s local storage until you commit it. You should commit your changes regularly to ensure that they're always accessible. +You must be signed in to use the web-based editor. + ## Opening the {% data variables.product.prodname_serverless %} You can open any {% data variables.product.prodname_dotcom %} repository in the {% data variables.product.prodname_serverless %} in either of the following ways: -- To open the repository in the same browser tab, press `.` while browsing any repository or pull request on {% data variables.product.prodname_dotcom %}. +- To open the repository in the same browser tab, press . while browsing any repository or pull request on {% data variables.product.prodname_dotcom %}. - To open the repository in a new browser tab, hold down the shift key and press `.`. + To open the repository in a new browser tab, press >. - Change the URL from "github.com" to "github.dev". - When viewing a file, use the dropdown menu next to {% octicon "pencil" aria-label="The edit icon" %} and select **Open in github.dev**. diff --git a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md index d42d144e5b..784262db66 100644 --- a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md +++ b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md @@ -1,121 +1,121 @@ --- -title: JetBrains IDE で GitHub Copilot の使用を開始する +title: Getting started with GitHub Copilot in a JetBrains IDE shortTitle: JetBrains IDE -intro: '{% data variables.product.prodname_copilot %} を JetBrains IDE にインストールし、コメントやコードを記述するときに候補が表示されるようにする方法について説明します。' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in a JetBrains IDE, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: e031d6155f4dacf9987bee21ff80eada0e079d97 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147110330' --- -## {% data variables.product.prodname_copilot %} と JetBrains IDE について + +## About {% data variables.product.prodname_copilot %} and JetBrains IDEs {% data reusables.copilot.procedural-intro %} -JetBrains IDE を使用すると、{% data variables.product.prodname_copilot %} からの候補をエディター内で直接表示し、取り入れることができます。 このガイドでは、macOS、Windows、or Linux 用の JetBrains IDE 内で {% data variables.product.prodname_copilot %} を使用する方法を示します。 +If you use a JetBrains IDE, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within a JetBrains IDE for macOS, Windows, or Linux. -## 前提条件 +## Prerequisites {% data reusables.copilot.jetbrains-ides %} -## JetBrains 拡張機能のインストール +## Installing the JetBrains extension -JetBrains IDE で {% data variables.product.prodname_copilot %} を使用するには、{% data variables.product.prodname_copilot %} 拡張機能をインストールする必要があります。 次の手順では、{% data variables.product.prodname_copilot %} プラグインを IntelliJ IDEA にインストールする手順について説明します。 サポートされている別の IDE にインストールする場合、手順が異なる可能性があります。 +To use {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} extension. The following procedure will guide you through installation of the {% data variables.product.prodname_copilot %} plugin in IntelliJ IDEA. Steps to install the plugin in another supported IDE may differ. -1. JetBrains IDE の **[ファイル]** メニュー (Windows の場合) または IDE for Mac の名前 (たとえば、**PyCharm**、**IntelliJ** など) で、 **[設定]** (Windows の場合) または **[環境設定]** (Mac の場合) をクリックします。 -2. **[設定] または [環境設定]** ダイアログ ボックスの左側のメニューで、 **[プラグイン]** をクリックします。 -3. **[設定] または [環境設定]** ダイアログ ボックスの上部にある **[Marketplace]** をクリックします。 検索バーで、「 **{% data variables.product.prodname_copilot %}** 」を検索し、 **[インストール]** をクリックします。 - ![Marketplace の検索のスクリーンショット](/assets/images/help/copilot/jetbrains-marketplace.png) -1. {% data variables.product.prodname_copilot %} がインストールされたら、 **[IDE を再起動する]** をクリックします。 -1. JetBrains IDE が再起動したら、 **[ツール]** メニューをクリックします。 **[{% data variables.product.prodname_copilot %}]** 、 **[{% data variables.product.prodname_dotcom %} にログイン]** の順にクリックします。 - ![JetBrains の [ツール] メニューのスクリーンショット](/assets/images/help/copilot/jetbrains-tools-menu.png) -1. デバイス コードをコピーしてデバイスの有効化ウィンドウを開くには、[{% data variables.product.prodname_dotcom %} にサインイン] ダイアログ ボックスで、 **[コピーして開く]** をクリックします。 - ![デバイス コードの [コピーして開く] のスクリーンショット](/assets/images/help/copilot/device-code-copy-and-open.png) -1. ブラウザーでデバイスの有効化ウィンドウが開きます。 デバイス コードを貼り付け、 **[続行]** をクリックします。 +1. In your JetBrains IDE, under the **File** menu for Windows or under the name of your IDE for Mac (for example, **PyCharm** or **IntelliJ**), click **Settings** for Windows or **Preferences** for Mac. +2. In the left-side menu of the **Settings/Preferences** dialog box, click **Plugins**. +3. At the top of the **Settings/Preferences** dialog box, click **Marketplace**. In the search bar, search for **{% data variables.product.prodname_copilot %}**, then click **Install**. + ![Screenshot of Marketplace search](/assets/images/help/copilot/jetbrains-marketplace.png) +1. After {% data variables.product.prodname_copilot %} is installed, click **Restart IDE**. +1. After your JetBrains IDE has restarted, click the **Tools** menu. Click **{% data variables.product.prodname_copilot %}**, then click **Login to {% data variables.product.prodname_dotcom %}**. + ![Screenshot of JetBrains tools menu](/assets/images/help/copilot/jetbrains-tools-menu.png) +1. In the "Sign in to {% data variables.product.prodname_dotcom %}" dialog box, to copy the device code and open the device activation window, click **Copy and Open**. + ![Screenshot of device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Windows または Linux でコードを貼り付けるには、Ctrl + v キーを押します。 - - macOS でコードを貼り付けるには、command + v キーを押します。 -1. {% data variables.product.prodname_dotcom %} から、{% data variables.product.prodname_copilot %} に必要なアクセス許可が要求されます。 これらのアクセス許可を承認するには、 **[{% data variables.product.prodname_copilot %} プラグインの承認]** をクリックします。 -1. アクセス許可が承認されたら、JetBrains IDE によって確認が表示されます。 {% data variables.product.prodname_copilot %} の使用を開始するには、 **[OK]** をクリックします。 - ![JetBrains IDE によるアクセス許可の確認のスクリーンショット](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After the permissions have been approved, your JetBrains IDE will show a confirmation. To begin using {% data variables.product.prodname_copilot %}, click **OK**. + ![Screenshot of JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## 最初の候補を表示する +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} 次のサンプルは Java で記述されていますが、他の言語も同様に動作します。 +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in Java, but other languages will work similarly. {% data reusables.copilot.create-java-file %} -1. Java ファイルで、「`class Test`」と入力してクラスを作成します。 - {% data variables.product.prodname_copilot %} によって、次に示すように、クラス本文の候補が灰色のテキストで自動的に表示されます。 実際に表示される候補はこのとおりではない場合があります。 - ![Java クラス本文の候補のスクリーンショット](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} -1. 関数本文の候補を表示するように {% data variables.product.prodname_copilot %} に要求するには、`main` 関数の角かっこの下に次の行を入力します。 実際に表示される候補はこのとおりではない場合があります。 +1. In the Java file, create a class by typing `class Test`. + {% data variables.product.prodname_copilot %} will automatically suggest a class body in grayed text, as shown below. The exact suggestion may vary. + ![Screenshot of the Java class body suggestion](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} +1. To prompt {% data variables.product.prodname_copilot %} to suggest a function body, type the following line below the bracket of the `main` function. The exact suggestion may vary. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} - ![Java 関数本文の候補のスクリーンショット](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} -{% data variables.product.prodname_copilot %} は、コードのコンテキストとスタイルの一致を試みます。 提案されたコードはいつでも編集できます。 +{% data variables.product.prodname_copilot %} will attempt to match the context and style of your code. You can always edit the suggested code. -## 代替候補の表示 +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-java-file %} -1. 候補を表示するように {% data variables.product.prodname_copilot %} に要求するには、Java ファイルに次の行を入力します。 -{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} {% data reusables.copilot.see-alternative-suggestions %} +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. +{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} +{% data reusables.copilot.see-alternative-suggestions %} - | OS | 次の候補を表示 | 前の候補を表示 | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | | macOS | Option+] | Option+[ | | Windows | Alt+] | Alt+[ | | Linux | Alt+] | Alt+[ | {% data reusables.copilot.accept-or-reject-suggestion %} -## 新しいタブに複数の候補を表示する +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-java-file %} -1. 候補を表示するように {% data variables.product.prodname_copilot %} に要求するには、Java ファイルに次の行を入力します。 +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -1. 複数の追加候補を表示した新しいタブが開きます。 - - macOS では、Command+Shift+Aキーを押して **[GitHub Copilot を開く]** をクリックするか、Command+Shift+\ キーを押して新しいタブをすぐに開きます。 - - Windows または Linux では、Ctrl+Enter キーを押して、 **[GitHub Copilot を開く]** をクリックします。 - ![Copilot を開くためのダイアログのスクリーンショット](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) -1. 候補を受け入れるには、候補の上にある **[ソリューションの受入]** をクリックします。 すべての候補を拒否するには、タブを閉じます。 +1. Open a new tab with multiple additional suggestions. + - On macOS, press Command+Shift+A, then click **Open GitHub Copilot**, or press Command+Shift+\ to open the new tab immediately. + - On Windows or Linux, press Ctrl+Enter, then click **Open GitHub Copilot**. + ![Screenshot of dialogue to open Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## コメントからコード候補を生成する +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-java-file %} -1. Java ファイル内の関数の実装を提案するように {% data variables.product.prodname_copilot %} に要求するには、次の行を入力します。 +1. To prompt {% data variables.product.prodname_copilot %} to suggest an implementation of a function in the Java file, type the following lines. ```java{:copy} // find all images without alternate text // and give them a red border void process () { ``` - ![Java 関数本文の候補のスクリーンショット](/assets/images/help/copilot/comment-suggestion-jetbrains.png) + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/comment-suggestion-jetbrains.png) -## {% data variables.product.prodname_copilot %} の有効化と無効化 +## Enabling and disabling {% data variables.product.prodname_copilot %} -すべての言語、または個々の言語の {% data variables.product.prodname_copilot %} を有効または無効にすることができます。 JetBrains IDE ウィンドウの下部パネルにある {% data variables.product.prodname_copilot %} 状態アイコンは、{% data variables.product.prodname_copilot %} が有効であるか、または無効であるかを示します。 有効の場合、アイコンが強調表示されます。 無効の場合、アイコンは淡色表示されます。 +You can enable or disable {% data variables.product.prodname_copilot %} for all languages, or for individual languages. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of your JetBrains IDE window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. -1. {% data variables.product.prodname_copilot %} を有効または無効にするには、JetBrains ウィンドウの下部パネルにある状態アイコンをクリックします。 - ![IntelliJ IDEA の状態アイコンのスクリーンショット](/assets/images/help/copilot/status-icon-jetbrains.png) -2. {% data variables.product.prodname_copilot %} を無効にする場合、グローバルに無効にするか、または現在編集しているファイルの言語に対して無効にするかを確認されます。 +1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. + ![Screenshot of the status icon in IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) +2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. - - {% data variables.product.prodname_copilot %} からの候補をグローバルに無効にするには、 **[入力候補を無効にする]** をクリックします。 - - 指定した言語に対して {% data variables.product.prodname_copilot %} からの候補を無効にするには、 **["_言語_" の入力候補を無効にする]** をクリックします。 - ![{% data variables.product.prodname_copilot %} をグローバルに、または現在の言語に対して無効にするためのオプションのスクリーンショット](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + - To disable suggestions from {% data variables.product.prodname_copilot %} globally, click **Disable Completions**. + - To disable suggestions from {% data variables.product.prodname_copilot %} for the specified language, click **Disable Completions for _LANGUAGE_**. + ![Screenshot of option to disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) -## 参考資料 +## Further reading -- [{% data variables.product.prodname_copilot %} Web サイト](https://copilot.github.com/) -- [{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) +- [The {% data variables.product.prodname_copilot %} website](https://copilot.github.com/) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) diff --git a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md index df62d182e2..75694b710b 100644 --- a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md +++ b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md @@ -1,105 +1,103 @@ --- -title: Visual Studio Code で GitHub Copilot の使用を開始する +title: Getting started with GitHub Copilot in Visual Studio Code shortTitle: Visual Studio Code -intro: '{% data variables.product.prodname_vscode %} に {% data variables.product.prodname_copilot %} をインストールし、コメントやコードを記述するときに候補が表示されるようにする方法について説明します。' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 854d489eaa90690dd670fb01068fe0166c134afb -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080155' --- -## {% data variables.product.prodname_copilot %} と {% data variables.product.prodname_vscode %} について + +## About {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_vscode %} {% data reusables.copilot.procedural-intro %} -{% data variables.product.prodname_vscode %} を使う場合、エディター内に {% data variables.product.prodname_copilot %} の候補を直接表示し、取り入れることができます。 このガイドでは、macOS、Windows、Linux 用の {% data variables.product.prodname_vscode %} 内で {% data variables.product.prodname_copilot %} を使う方法について説明します。 +If you use {% data variables.product.prodname_vscode %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vscode %} for macOS, Windows, or Linux. -## 前提条件 +## Prerequisites -{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vscode %} がインストールされている必要があります。 詳細については、[{% data variables.product.prodname_vscode %} のダウンロード ページ](https://code.visualstudio.com/Download)を参照してください。 +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download). -## {% data variables.product.prodname_vscode %} 拡張機能をインストールする +## Installing the {% data variables.product.prodname_vscode %} extension -{% data variables.product.prodname_copilot %} を使うには、最初に {% data variables.product.prodname_vscode %} 拡張機能をインストールする必要があります。 +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. {% data variables.product.prodname_vscode %} Marketplace で、[{% data variables.product.prodname_copilot %} 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)ページに移動し、 **[Install]\(インストール\)** をクリックします。 - ![{% data variables.product.prodname_copilot %} 拡張機能 {% data variables.product.prodname_vscode %} をインストールする](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. ポップアップが表示され、{% data variables.product.prodname_vscode %} を開くように求められます。 **[Open {% data variables.product.prodname_vscode %}]** をクリックします。 -1. {% data variables.product.prodname_vscode %} の [Extension: {% data variables.product.prodname_copilot %}] タブの **[Install]\(インストール\)** をクリックします。 - ![{% data variables.product.prodname_vscode %} の [Install]\(インストール\) ボタン](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. {% data variables.product.prodname_dotcom %} アカウントで {% data variables.product.prodname_vscode %} を以前に認可していない場合は、{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_dotcom %} にサインインするように求められます。 - - {% data variables.product.prodname_dotcom %} のアカウントで {% data variables.product.prodname_vscode %} を以前に認可している場合は、{% data variables.product.prodname_copilot %} は自動的に認可されます。 - ![{% data variables.product.prodname_vscode %} 認可画面のスクリーン ショット](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. ブラウザーで、{% data variables.product.prodname_dotcom %} から、{% data variables.product.prodname_copilot %} に必要なアクセス許可が要求されます。 これらのアクセス許可を承認するには、 **[{% data variables.product.prodname_vscode %} の認可]** をクリックします。 -1. {% data variables.product.prodname_vscode %} の [{% data variables.product.prodname_vscode %}] ダイアログ ボックスで、認証を確認するには、 **[Open]\(開く\)** をクリックします。 +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} for your account on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialog box, to confirm the authentication, click **Open**. -## 最初の候補を表示する +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} 次のサンプルは JavaScript で記述されていますが、他の言語も同様に動作します。 +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. {% data reusables.copilot.create-js-file %} -1. JavaScript ファイルで、次の関数ヘッダーを入力します。 次に示すように、{% data variables.product.prodname_copilot %} から自動的に関数本文全体の候補が灰色のテキストで表示されます。 実際に表示される候補はこのとおりではない場合があります。 +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` - ![最初の候補のスクリーンショット {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -## 代替候補の表示 +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-js-file %} -1. JavaScript ファイルで、次の関数ヘッダーを入力します。 {% data variables.product.prodname_copilot %} による候補が表示されます。 +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` {% data reusables.copilot.see-alternative-suggestions %} - | OS | 次の候補を表示 | 前の候補を表示 | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - |macOS|Option (⌥) または Alt+]|Option (⌥) または Alt+[| + |macOS|Option (⌥) or Alt+]|Option (⌥) or Alt+[| |Windows|Alt+]|Alt+[| |Linux|Alt+]|Alt+[| -1. または、候補の上にマウス ポインターを置くと、候補を選択するための{% data variables.product.prodname_copilot %} コマンド パレットが表示されます。 +1. Alternatively, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## 新しいタブに複数の候補を表示する +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-js-file %} -1. JavaScript ファイルで、次の関数ヘッダーを入力します。 {% data variables.product.prodname_copilot %} による候補が表示されます。 +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` -1. 複数の追加オプションを含む新しいタブを開くには、Ctrl+Enter キーを押します。 -1. 候補を受け入れるには、候補の上にある **[Accept Solution]\(ソリューションの受入\)** をクリックします。 すべての候補を拒否するには、タブを閉じます。 +1. To open a new tab with multiple additional options, press Ctrl+Enter. +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## コメントからコード候補を生成する +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-js-file %} -1. JavaScript ファイルで、次のコメントを入力します。 {% data variables.product.prodname_copilot %} による関数の実装の候補が表示されます。 +1. In the JavaScript file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```javascript{:copy} // find all images without alternate text // and give them a red border function process() { ``` -## フレームワークの使用 +## Using a framework -{% data variables.product.prodname_copilot %} を使うと、API やフレームワークの候補を生成することもできます。 次の例では、{% data variables.product.prodname_copilot %} を使って、現在の時刻を返す単純な Express サーバーを作成しています。 +You can also use {% data variables.product.prodname_copilot %} to generate suggestions for APIs and frameworks. The following example uses {% data variables.product.prodname_copilot %} to create a simple Express server that returns the current time. {% data reusables.copilot.create-js-file %} -1. JavaScript ファイルで、次のコメントを入力し、Enter キーを押します。 {% data variables.product.prodname_copilot %} による Express アプリの実装の候補が表示されます。 +1. In the JavaScript file, type the following comment and then press Enter. {% data variables.product.prodname_copilot %} will suggest an implementation of the Express app. ```javascript{:copy} // Express server on port 3000 1. To accept each line, press Tab, then Enter. @@ -107,10 +105,10 @@ ms.locfileid: '147080155' ```javascript{:copy} // Return the current time ``` -1. 各行を受け入れるには、Tab キーを押します。 +1. To accept each line, press Tab. {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## 参考資料 +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md index c8dae6af54..0aaade3943 100644 --- a/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md +++ b/translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md @@ -1,83 +1,82 @@ --- -title: Visual Studio で GitHub Copilot の使用を開始する +title: Getting started with GitHub Copilot in Visual Studio shortTitle: Visual Studio product: '{% data reusables.gated-features.copilot %}' -intro: '{% data variables.product.prodname_vs %} に {% data variables.product.prodname_copilot %} をインストールし、コメントやコードを記述するときに候補が表示されるようにする方法について説明します。' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, and start seeing suggestions as you write comments and code.' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 1d3c65cf1709ece9ea7b0eae9e6fadaa0df0c7f0 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147098026' --- -## {% data variables.product.prodname_copilot %} と Visual Studio について + +## About {% data variables.product.prodname_copilot %} and Visual Studio {% data reusables.copilot.procedural-intro %} -{% data variables.product.prodname_vs %} を使うと、エディター内に {% data variables.product.prodname_copilot %} による候補が直接表示されるので、取り入れることができます。 このガイドでは、{% data variables.product.prodname_vs %} for Windows 内で {% data variables.product.prodname_copilot %} を使う方法について説明します。 +If you use {% data variables.product.prodname_vs %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vs %} for Windows. -## 前提条件 +## Prerequisites -{% data variables.product.prodname_vs %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vs %} 2022 17.2 以降がインストールされている必要があります。 詳しい情報については、[Visual Studio IDE](https://visualstudio.microsoft.com/vs/) のドキュメントをご覧ください。 +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation. {% note %} -**注**: {% data variables.product.prodname_copilot %} は現在、Visual Studio for Mac で使うことはできません。 +**Note**: {% data variables.product.prodname_copilot %} is not currently available for use with Visual Studio for Mac. {% endnote %} -## {% data variables.product.prodname_vs %} 拡張機能をインストールする +## Installing the {% data variables.product.prodname_vs %} extension -{% data variables.product.prodname_copilot %} を使うには、最初に {% data variables.product.prodname_vs %} 拡張機能をインストールする必要があります。 -1. Visual Studio ツール バーの **[拡張機能]** をクリックし、 **[拡張機能の管理]** をクリックします。 - ![Visual Studio ツール バーのスクリーンショット](/assets/images/help/copilot/visual-studio-toolbar.png) -1. [拡張機能の管理] ウィンドウで、**Visual Studio Marketplace** をクリックし、{% data variables.product.prodname_copilot %} 拡張機能を検索して、 **[ダウンロード]** をクリックします。 - ![Visual Studio 用 GitHub Copilot 拡張機能の [ダウンロード] ボタンが強調されたスクリーンショット](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) -1. [拡張機能の管理] ウィンドウを閉じ、{% data variables.product.prodname_vs %} を終了してもう一度起動します。 -1. 必要に応じて、{% data variables.product.prodname_copilot %} がインストールされ、有効になっていることを確認するには、 **[拡張機能の管理]** に戻り、 **[インストール済み]** をクリックして現在インストールされている拡張機能を表示し、 **{% data variables.product.prodname_copilot %}** をクリックして状態情報を表示します。 - ![Visual Studio でインストール済み拡張機能の GitHub Copilot が強調されているスクリーンショット](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) -1. {% data variables.product.prodname_vs %} で新しいプロジェクトを開くか、作成します。 -1. デバイスのアクティブ化コードをコピーするには、[Microsoft {% data variables.product.prodname_vs %}] ダイアログ ボックスの **[OK]** をクリックします。 - ![[Microsoft {% data variables.product.prodname_vs %}] ダイアログ ボックスのスクリーンショット](/assets/images/help/copilot/vs-auth-dialogue.png) -1. ブラウザーにデバイスのアクティブ化ウィンドウが表示されます。 デバイス コードを貼り付け、 **[続行]** をクリックします。 +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vs %} extension. +1. In the Visual Studio toolbar, click **Extensions**, then click **Manage Extensions**. + ![Screenshot of the Visual Studio toolbar](/assets/images/help/copilot/visual-studio-toolbar.png) +1. In the "Manage Extensions" window, click **Visual Studio Marketplace**, search for the {% data variables.product.prodname_copilot %} extension, then click **Download**. + ![Screenshot of GitHub Copilot extension for Visual Studio with the download button emphasized](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) +1. Close the "Manage Extensions" window, then exit and relaunch {% data variables.product.prodname_vs %}. +1. Optionally, to check that {% data variables.product.prodname_copilot %} is installed and enabled, go back to **Manage Extensions**, click **Installed** to view your currently installed extensions, then click **{% data variables.product.prodname_copilot %}** to see status information. + ![Screenshot of installed extensions in Visual Studio with GitHub Copilot emphasized](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) +1. Open or create a new project in {% data variables.product.prodname_vs %}. +1. In the "Microsoft {% data variables.product.prodname_vs %}" dialog box, to copy your device activation code, click **OK**. + ![Screenshot of the Microsoft {% data variables.product.prodname_vs %} dialogue box](/assets/images/help/copilot/vs-auth-dialogue.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Windows または Linux でコードを貼り付けるには、Ctrl + v キーを押します。 - - macOS でコードを貼り付けるには、command + v キーを押します。 -1. {% data variables.product.prodname_dotcom %} から、{% data variables.product.prodname_copilot %} に必要なアクセス許可が要求されます。 これらのアクセス許可を承認するには、 **[{% data variables.product.prodname_copilot %} プラグインの認可]** をクリックします。 -1. アクセス許可を承認すると、{% data variables.product.prodname_vs %} に確認が表示されます。 - ![{% data variables.product.prodname_vs %} アクセス許可確認のスクリーンショット](/assets/images/help/copilot/vs-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After you approve the permissions, {% data variables.product.prodname_vs %} will show a confirmation. + ![Screenshot of {% data variables.product.prodname_vs %} permissions confirmation](/assets/images/help/copilot/vs-confirmation.png) -## 最初の候補を表示する -{% data reusables.copilot.supported-languages %} 次のサンプルは C# で記述されていますが、他の言語も同様に動作します。 +## Seeing your first suggestion + +{% data reusables.copilot.code-examples-limitations %} +{% data reusables.copilot.supported-languages %} The following samples are in C#, but other languages will work similarly. {% data reusables.copilot.create-c-file %} -1. C# ファイルに、次の関数シグネチャを入力します。 次に示すように、{% data variables.product.prodname_copilot %} による関数本体全体の候補が自動的に灰色のテキストで表示されます。 実際に表示される候補はこのとおりではない場合があります。 +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```csharp{:copy} int CalculateDaysBetweenDates( ``` - ![Visual Studio Code の最初の候補のスクリーンショット](/assets/images/help/copilot/first-suggestion-visual-studio.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) +{% data reusables.copilot.accept-suggestion %} -## 代替候補を表示する -{% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-c-file %} -1. C# ファイルに、次の関数シグネチャを入力します。 {% data variables.product.prodname_copilot %} による候補が表示されます。 +## Seeing alternative suggestions +{% data reusables.copilot.alternative-suggestions %} +{% data reusables.copilot.create-c-file %} +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will show you a suggestion. ```csharp{:copy} int CalculateDaysBetweenDates( ``` -1. 代替候補が利用可能な場合、これらの代替候補は、Alt + ] (または Alt + [) キーを押して表示できます。 -1. 必要に応じて、候補の上にマウス ポインターを置くと、候補を選べるように {% data variables.product.prodname_copilot %} コマンド パレットが表示されます。 +1. If alternative suggestions are available, you can see these alternatives by pressing Alt+] (or Alt+[). +1. Optionally, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## コメントからコード候補を生成する +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-c-file %} -1. C# ファイルに、次のコメントを入力します。 {% data variables.product.prodname_copilot %} による関数の実装の候補が表示されます。 +1. In the C# file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```csharp{:copy} using System.Xml.Linq; @@ -90,6 +89,6 @@ ms.locfileid: '147098026' {% data reusables.copilot.enabling-or-disabling-vs %} -## 参考資料 +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/ja-JP/content/copilot/quickstart.md b/translations/ja-JP/content/copilot/quickstart.md index e9a9c0a87b..bde85097a6 100644 --- a/translations/ja-JP/content/copilot/quickstart.md +++ b/translations/ja-JP/content/copilot/quickstart.md @@ -1,6 +1,6 @@ --- -title: GitHub Copilot のクイック スタート -intro: '{% data variables.product.prodname_copilot %} は、コーディング中にインライン候補を提示することで作業を支援します。' +title: Quickstart for GitHub Copilot +intro: '{% data variables.product.prodname_copilot %} can help you work, by offering inline suggestions as you code.' product: '{% data reusables.gated-features.copilot %}' allowTitleToDifferFromFilename: true versions: @@ -8,60 +8,60 @@ versions: shortTitle: Quickstart topics: - Copilot -ms.openlocfilehash: 5aa3071cddc2bf83e7ee7082eabea00f79a66ea5 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147080245' --- -## はじめに -{% data variables.product.prodname_copilot %} は AI ペア プログラマーです。 {% data variables.product.prodname_copilot %} を使うと、エディター内で行全体または関数全体の候補を得ることができます。 +## Introduction -このガイドでは、{% data variables.product.prodname_copilot %} にサインアップし、{% data variables.product.prodname_vscode %} に {% data variables.product.prodname_copilot %} 拡張機能をインストールして、最初の候補を得る方法について説明します。 {% data variables.product.prodname_copilot %} の詳しい情報については、「[{% data variables.product.prodname_copilot %}について](/copilot/overview-of-github-copilot/about-github-copilot)」をご覧ください。 さまざまな環境で {% data variables.product.prodname_copilot %} を使う方法の詳しい情報については、「[使用を開始する](/copilot/getting-started-with-github-copilot)」をご覧ください。 +{% data variables.product.prodname_copilot %} is an AI pair programmer. You can use {% data variables.product.prodname_copilot %} to get suggestions for whole lines or entire functions right inside your editor. -## 前提条件 +This guide will show you how to sign up for {% data variables.product.prodname_copilot %}, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)." + +## Prerequisites {% data reusables.copilot.copilot-prerequisites %} -- {% data variables.product.prodname_vscode %} で {% data variables.product.prodname_copilot %} を使うには、{% data variables.product.prodname_vscode %} がインストールされている必要があります。 詳しい情報については、[{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) のドキュメントをご覧ください。 +- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) documentation. -## {% data variables.product.prodname_copilot %} にサインアップする +## Signing up for {% data variables.product.prodname_copilot %} {% data reusables.copilot.signup-procedure %} -## {% data variables.product.prodname_vscode %} 用の {% data variables.product.prodname_copilot %} 拡張機能をインストールする +## Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %} -{% data variables.product.prodname_copilot %} を使うには、最初に {% data variables.product.prodname_vscode %} 拡張機能をインストールする必要があります。 +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. {% data variables.product.prodname_vscode %} Marketplace で、[{% data variables.product.prodname_copilot %} 拡張機能](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)ページに移動し、 **[Install]\(インストール\)** をクリックします。 - ![{% data variables.product.prodname_copilot %} 拡張機能 {% data variables.product.prodname_vscode %} をインストールする](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. ポップアップが表示され、{% data variables.product.prodname_vscode %} を開くように求められます。 **[Open {% data variables.product.prodname_vscode %}]** をクリックします。 -1. {% data variables.product.prodname_vscode %} の [Extension: {% data variables.product.prodname_copilot %}] タブの **[Install]\(インストール\)** をクリックします。 - ![{% data variables.product.prodname_vscode %} の [Install]\(インストール\) ボタン](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. {% data variables.product.prodname_dotcom %} アカウントで {% data variables.product.prodname_vscode %} を以前に認可していない場合、{% data variables.product.prodname_vscode %} で {% data variables.product.prodname_dotcom %} にサインインするように求められます。 - - {% data variables.product.prodname_dotcom %} アカウントで {% data variables.product.prodname_vscode %} を以前に認可している場合は、{% data variables.product.prodname_copilot %} は自動的に認可されます。 - ![{% data variables.product.prodname_vscode %} 認可画面のスクリーン ショット](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. ブラウザーで、{% data variables.product.prodname_dotcom %} から、{% data variables.product.prodname_copilot %} に必要なアクセス許可が要求されます。 これらのアクセス許可を承認するには、 **[{% data variables.product.prodname_vscode %} の認可]** をクリックします。 -1. {% data variables.product.prodname_vscode %} の [{% data variables.product.prodname_vscode %}] ダイアログ ボックスで、認証を確認するには、 **[開く]** をクリックします。 +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialogue box, to confirm the authentication, click **Open**. -## 最初の候補を得る +## Getting your first suggestion -{% data reusables.copilot.supported-languages %} 次のサンプルは JavaScript で記述されていますが、他の言語も同様に動作します。 +{% data reusables.copilot.code-examples-limitations %} -1. {% data variables.product.prodname_vscode %} を開きます。 -次に示すように、{% data reusables.copilot.create-js-file %} {% data reusables.copilot.type-function-header %} {% data variables.product.prodname_copilot %} による関数本体全体の候補が自動的に灰色のテキストで表示されます。 実際に表示される候補はこのとおりではない場合があります。 -![最初の候補 {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. -## 次の手順 +1. Open {% data variables.product.prodname_vscode %}. +{% data reusables.copilot.create-js-file %} +{% data reusables.copilot.type-function-header %} + {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. + ![First suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -{% data variables.product.prodname_copilot %} を正常にインストールし、最初の候補を受け取りましたが、これはほんの始まりにすぎません。 {% data variables.product.prodname_copilot %} を使う次のステップに進む際は、次のリソースが役立ちます。 +## Next Steps -- [使用を開始する](/copilot/getting-started-with-github-copilot): {% data variables.product.prodname_vscode %} で最初の候補を得る方法について説明しています。 これらのガイドには、サポートされているすべての環境において、{% data variables.product.prodname_copilot %} のさまざまな機能を設定および操作する方法が説明されています。 -- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): {% data variables.product.prodname_copilot %} がどのように作業に役立つかについて実際の例をご覧ください。 -- [{% data variables.product.prodname_copilot %} の構成](/copilot/configuring-github-copilot): これらのガイドには、{% data variables.product.prodname_copilot %} を個人の好みに合わせて構成する方法が詳しく説明されています。 +You successfully installed {% data variables.product.prodname_copilot %} and received your first suggestion, but that's just the beginning! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_copilot %}. + +- [Getting Started](/copilot/getting-started-with-github-copilot): You've learned how to get your first suggestion in {% data variables.product.prodname_vscode %}. These guides show you how to set up and navigate the various functions of {% data variables.product.prodname_copilot %} across all of the supported environments. +- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): See practical examples of how {% data variables.product.prodname_copilot %} can help you work. +- [Configuring {% data variables.product.prodname_copilot %}](/copilot/configuring-github-copilot): These guides provide details on how to configure {% data variables.product.prodname_copilot %} to your personal preferences. -## 参考資料 +## Further reading -- [{% data variables.product.prodname_copilot %} について](/copilot/overview-of-github-copilot/about-github-copilot) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) 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 3f94f0beb9..00f75ff588 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,60 +1,89 @@ --- -title: ディスカッションを使用してメンテナとコラボレーションする +title: Collaborating with maintainers using discussions shortTitle: Collaborating with maintainers -intro: 'ディスカッションでプロジェクトのメンテナと連絡を取り合うことにより、{% data variables.product.product_name %} でプロジェクトの目標、計画、健全性、およびコミュニティに貢献できます。' +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 access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions -ms.openlocfilehash: f090088d55e946e67c1f0b5d790deca9fd794a90 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410252' --- -## {% data variables.product.prodname_discussions %} を使用したメンテナとのコラボレーションについて -{% data reusables.discussions.about-discussions %} プロジェクトを使用または貢献する場合は、ディスカッションを開始して提案を行い、計画、質問、アイデア、フィードバックについてメンテナやコミュニティメンバーと交流することができます。 詳細については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。 + +## About collaboration with maintainers using {% data variables.product.prodname_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-categories-and-formats %} {% data reusables.discussions.about-announcement-format %} -リポジトリ管理者とプロジェクトのメンテナは、そのリポジトリ内のディスカッションを削除できます。 同様に、Organization のディスカッションのソース リポジトリの管理者とメンテナは、その Organization 内のディスカッションを削除できます。 詳しくは、「[ディスカッションの管理](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)」を参照してください。 +Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)." -{% data reusables.discussions.github-recognizes-members %} これらのメンバーは、プロジェクトのディスカッションに最も役立つコントリビューターのリストに表示されます。 プロジェクトが成長するにつれて、コミュニティのアクティブなメンバーにより高いアクセス許可を付与できます。 詳細については、「[上位貢献者により高いアクセス許可を付与する](/discussions/guides/granting-higher-permissions-to-top-contributors)」を参照してください +{% 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)" -![プロジェクトのディスカッションに最も役立つ貢献者](/assets/images/help/discussions/most-helpful.png) +![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) -ディスカッションへの参加の詳細については、「[ディスカッションに参加する](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)」を参照してください。 +Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value. -## 前提条件 +For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." -リポジトリ ディスカッションでメンテナとコラボレーションするには、リポジトリ管理者またはプロジェクトのメンテナがリポジトリの {% data variables.product.prodname_discussions %} を有効にする必要があります。 詳細については、「[リポジトリの {% data variables.product.prodname_discussions %} を有効化または無効化する](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」を参照してください。 +## Prerequisites -Organization のディスカッションでメンテナと共同作業するには、Organization に対して {% data variables.product.prodname_discussions %} を有効にする必要があります。 詳細については、「[Organization の {% data variables.product.prodname_discussions %} を有効化または無効化する](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)」を参照してください。 +To collaborate with maintainers in repository discussions, a repository administrator or project maintainer must enable {% data variables.product.prodname_discussions %} for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." -## ディスカッションを開始する +To collaborate with maintainers in organization discussions, {% data variables.product.prodname_discussions %} must be enabled for the organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Starting a discussion {% data reusables.discussions.starting-a-discussion %} -## ポーリングを開始する +## Starting a poll {% data reusables.discussions.starting-a-poll %} -## ディスカッションのリストをフィルタする +## Filtering the list of discussions -ディスカッションを検索し、リポジトリまたは Organization 内のディスカッションのリストをフィルタできます。 詳細については、「[ディスカッションを検索する](/search-github/searching-on-github/searching-discussions)」を参照してください。 +You can search for discussions and filter the list of discussions in a repository or organization. For more information, see "[Searching discussions](/search-github/searching-on-github/searching-discussions)." -{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} -1. **[すべてのディスカッションを検索]** フィールドに、検索クエリを入力します。 必要に応じて、検索フィールドの右側にあるボタンをクリックして、結果をさらにフィルタします。 - ![ディスカッションをフィルタするための検索バーとボタン](/assets/images/help/discussions/search-and-filter-controls.png) -1. ディスカッションのリストで、表示するディスカッションをクリックします。 - ![ディスカッション検索結果](/assets/images/help/discussions/search-result.png) +{% data reusables.discussions.navigate-to-repo-or-org %} +{% 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) -## Issue をディスカッションに変換する +## Sorting the list of discussions -{% data reusables.discussions.you-can-convert-an-issue %} 詳細については、「[ディスカッションをモデレートする](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)」を参照してください。 +You can choose how to sort the list of discussions. -## 参考資料 +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +1. To the right of the **Search all discussions** field, select **New**, or select **Top** and choose a time period from the drop down menu. -- 「[{% data variables.product.prodname_dotcom %} 上での執筆とフォーマットについて](/github/writing-on-github/about-writing-and-formatting-on-github)」{%- ifversion fpt or ghec %} -- 「[{% data variables.product.prodname_dotcom %} での安全性を維持する](/communities/maintaining-your-safety-on-github)」{%- endif %} + ![Buttons for sorting discussions](/assets/images/help/discussions/sort-discussions-buttons.png) + + - Sort by **New** to display the discussions with the most recent activity at the top of the list. + - Sort by **Top** to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period. + +## Sorting top-level comments in discussions + +You can choose how to sort top-level comments in discussions. Comment threads do not impact the order comments are sorted in. + +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. Under the main discussion post, select **Oldest**, **Newest**, or **Top**. + + ![Buttons for sorting comments in discussions](/assets/images/help/discussions/sort-comments-buttons.png) + + - Sort by **Oldest** to display the oldest top-level comments first. + - Sort by **Newest** to display the newest top-level comments first. + - Sort by **Top** to display the most upvoted top-level comments first. + +## Converting an issue to a discussion + +{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." + +## Further reading + +- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +{%- ifversion fpt or ghec %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)" +{%- endif %} 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 2811907a67..ccfd537fc0 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,40 +1,66 @@ --- -title: ディスカッションに参加する -intro: '{% data variables.product.product_name %} のプロジェクトのリポジトリ内のフォーラムで、コミュニティやメンテナと会話することができます。' +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 access to a repository can participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can participate in discussions and polls in that organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions shortTitle: Participate in discussion -ms.openlocfilehash: 07db8d3583c218e592ca1b68171292e52fcfc12f -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410236' --- -## ディスカッションへの参加について -{% data reusables.discussions.about-discussions %} 詳細については、「[ディスカッションについて](/discussions/collaborating-with-your-community-using-discussions/about-discussions)」を参照してください。 -ディスカッションおよびポーリングの開始または表示に加えて、ディスカッションの作者のコメントに対してコメントすることができます。 また、ディスカッション内で別のコミュニティメンバーが行った個々のコメントに返信してコメントスレッドを作成し、絵文字でコメントにリアクションすることもできます。 +## About participation in a discussion -{% ifversion fpt or ghec %}{% data variables.product.product_name %} で、ユーザーをブロックし、破壊的なコンテンツを報告して、安全で快適な環境を維持できます。 詳しくは、「[{% data variables.product.prodname_dotcom %} での安全性を維持する](/communities/maintaining-your-safety-on-github)」をご覧ください。{% endif %} +{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." -## 前提条件 +In addition to starting or viewing discussions and polls, you can: -リポジトリまたは組織のディスカッションに参加するには、そのリポジトリまたは組織に対して {% data variables.product.prodname_discussions %} を有効にする必要があります。 詳細については、「[リポジトリの {% data variables.product.prodname_discussions %} の有効化または無効化](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)」および「[組織の GitHub ディスカッションの有効化または無効化](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)」を参照してください。 +- Comment in response to the original comment from the author of the discussion +- Create a comment thread by replying to an individual comment that another community member made within the discussion +- React to comments with emoji +- Upvote discussions and top-level comments to give them more visibility -## ディスカッションを作成する +{% ifversion fpt or ghec %}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 %}](/communities/maintaining-your-safety-on-github)."{% endif %} + +## Prerequisites + +{% data variables.product.prodname_discussions %} must be enabled for the repository or organization for you to participate in a discussion in the repository or organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)" and "[Enabling or disabling GitHub Discussions for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Creating a discussion {% data reusables.discussions.starting-a-discussion %} -## ポーリングの作成 +## Creating a poll {% data reusables.discussions.starting-a-poll %} -## コメントを回答としてマークする +## 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. +Similarly, discussion authors and users with the triage role or greater for the source repository for organization discussions can mark a comment as the answer to a discussion in the organization. {% data reusables.discussions.marking-a-comment-as-an-answer %} + +## Upvoting a discussion + +You can upvote discussions to give more visibility to the topics that matter to you, and sort discussions to see which have been upvoted the most. For more information on sorting discussions, see "[Sorting the list of discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-the-list-of-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +1. In the list of discussions, find the discussion you want to upvote. +1. To the left of the discussion, click the upvote arrow. + + ![Discussion list and upvote button for upvoting discussions](/assets/images/help/discussions/upvote-discussion-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. + +## Upvoting a comment + +You can upvote top-level comments in discussions, and sort top-level comments to see which comments have been upvoted the most. For more information on sorting comments, see "[Sorting top-level comments in discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-top-level-comments-in-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. In the discussion, find a top-level comment you want to upvote. +1. Click on the upvote arrow at the bottom left of the comment. + + ![Top-level comment and upvote button for upvoting comments](/assets/images/help/discussions/upvote-comment-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. diff --git a/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md b/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md index 4516f39f99..bbd743e04a 100644 --- a/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md +++ b/translations/ja-JP/content/get-started/using-github/keyboard-shortcuts.md @@ -50,7 +50,8 @@ The {% data variables.product.prodname_command_palette %} also gives you quick a | Keyboard shortcut | Description |-----------|------------{% ifversion fpt or ghec %} -|. | Opens a repository or pull request in the web-based editor. For more information, see "[Web-based editor](/codespaces/developing-in-codespaces/web-based-editor)."{% endif %} +|. | Opens a repository or pull request in the web-based editor in the same browser tab. You must be signed in to use the editor. For more information, see "[Web-based editor](/codespaces/developing-in-codespaces/web-based-editor)." +|> | Opens a repository or pull request in the web-based editor in a new browser tab. You must be signed in to use the editor. For more information, see "[Web-based editor](/codespaces/developing-in-codespaces/web-based-editor)."{% endif %} |Command+B (Mac) or
Ctrl+B (Windows/Linux) | Inserts Markdown formatting for bolding text |Command+I (Mac) or
Ctrl+I (Windows/Linux) | Inserts Markdown formatting for italicizing text |Command+K (Mac) or
Ctrl+K (Windows/Linux) | Inserts Markdown formatting for creating a link{% ifversion fpt or ghec or ghae or ghes > 3.3 %} diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/index.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/index.md index 7adcb50d83..0aa855634d 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/index.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/index.md @@ -11,6 +11,7 @@ children: - /managing-access-to-your-projects - /closing-and-deleting-your-projects - /adding-your-project-to-a-repository + - /adding-your-project-to-a-team allowTitleToDifferFromFilename: true ms.openlocfilehash: ca7c42e8dcb3daf477c70248eb79d12ca9670052 ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 diff --git a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md index 504549c08a..e5f823f24e 100644 --- a/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md +++ b/translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md @@ -1,115 +1,117 @@ --- -title: '{% data variables.projects.projects_v2 %} へのアクセスの管理' +title: 'Managing access to your {% data variables.projects.projects_v2 %}' shortTitle: 'Managing {% data variables.projects.project_v2 %} access' -intro: '{% data variables.projects.project_v2 %} へのチームと個人のアクセスを管理する方法について学習します。' +intro: 'Learn how to manage team and individual access to your {% data variables.projects.project_v2 %}.' miniTocMaxHeadingLevel: 3 versions: - feature: projects-v2 + feature: "projects-v2" redirect_from: - /issues/trying-out-the-new-projects-experience/managing-access-to-projects type: tutorial topics: - Projects allowTitleToDifferFromFilename: true -ms.openlocfilehash: 05fa60d5690074c217db87cd52a44b46433c014e -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147424044' --- -## プロジェクトへのアクセスについて -Organizationレベルのプロジェクトの管理者は、Organization全体、Team、個々のOrganizationのメンバー、外部のコラボレータのアクセスを管理できます。 -ユーザレベルのプロジェクトの管理者は、個々のコラボレータを招待し、そのアクセスを管理できます。 +## About project access -プロジェクトの管理者は、インターネット上のすべての人々に対するプロジェクトの可視性も制御できます。 詳細については、「[プロジェクトの可視性の管理](/issues/trying-out-the-new-projects-experience/managing-the-visibility-of-your-projects)」を参照してください。 +Admins of organization-level projects can manage access for the entire organization, for teams, for individual organization members, and for outside collaborators. -## Organizationレベルのプロジェクトのアクセス管理 +Admins of user-level projects can invite individual collaborators and manage their access. -### Organization内の全員に対するアクセス管理 +Project admins can also control the visibility of their project for everyone on the internet. For more information, see "[Managing the visibility of your projects](/issues/trying-out-the-new-projects-experience/managing-the-visibility-of-your-projects)." -既定の基本ロールは `write` であり、これは Organization 内の誰もがプロジェクトを表示して編集できるということです。 この基本ロールを変更すれば、Organizationの全員に対するプロジェクトのアクセスを変更できます。 基本ロールへの変更は、Organizationのオーナーではなく、個別にアクセス権を付与されていないOrganizaitonのメンバーにだけ影響します。 +## Managing access for organization-level projects + +### Managing access for everyone in your organization + +The default base role is `write`, meaning that everyone in the organization can see and edit your project. To change project access for everyone in the organization, you can change the base role. Changes to the base role only affect organization members who are not organization owners and who are not granted individual access. {% data reusables.projects.project-settings %} -1. **[アクセスの管理]** をクリックします。 - ![[アクセスの管理] 項目を示すスクリーンショット](/assets/images/help/projects-v2/manage-access.png) -2. **[基本ロール]** で、既定のロールを選択します。 - ![[基本ロール] メニューを示すスクリーンショット](/assets/images/help/projects-v2/base-role.png) - - **アクセス無し**: Organization のオーナーと、個別にアクセス権を付与されたユーザーだけがプロジェクトを表示できます。 Organizationのオーナーは、プロジェクトの管理者でもあります。 - - **読み取り**: 組織内のすべてのユーザーがプロジェクトを表示できます。 Organizationのオーナーは、プロジェクトの管理者でもあります。 - - **書き込み**: 組織内のすべてのユーザーがプロジェクトを表示して編集できます。 Organizationのオーナーは、プロジェクトの管理者でもあります。 - - **管理者**: 組織内のすべてのユーザーがプロジェクトの管理者です。 +1. Click **Manage access**. + ![Screenshot showing the "Manage access" item](/assets/images/help/projects-v2/manage-access.png) +2. Under **Base role**, select the default role. + ![Screenshot showing the base role menu](/assets/images/help/projects-v2/base-role.png) + - **No access**: Only organization owners and users granted individual access can see the project. Organization owners are also admins for the project. + - **Read**: Everyone in the organization can see the project. Organization owners are also admins for the project. + - **Write**: Everyone in the organization can see and edit the project. Organization owners are also admins for the project. + - **Admin**: Everyone in the organization is an admin for the project. -### Team及びOrganizationの個々のメンバーのアクセス管理 +### Managing access for teams and individual members of your organization -Organizationレベルのプロジェクトには、Team、外部のコラボレータ、個々のOrganizationのメンバーをコラボレータとして追加することもできます。 詳細については、「[Team について](/organizations/organizing-members-into-teams/about-teams)」を参照してください。 +You can also add teams, external collaborators, and individual organization members as collaborators for an organization-level project. For more information, see "[About teams](/organizations/organizing-members-into-teams/about-teams)." -個人ユーザが既にOrganizationのメンバーになっているか、Organizationの少なくとも1つのリポジトリで外部のコラボレータになっている場合にのみ、Organizationレベルのプロジェクトに共同作業をするように招待できます。 +{% ifversion projects-v2-add-to-team %} + +If you grant a team read permissions or greater for a project, the project is also displayed on the team's projects page. You can also add projects to a team on the team's projects page. For more information, see "[Adding your project to a team](/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team)." + +{% endif %} + +You can only invite an individual user to collaborate on your organization-level project if they are already a member of the organization or an outside collaborator on at least one repository in the organization. {% data reusables.projects.project-settings %} -1. **[アクセスの管理]** をクリックします。 - ![[アクセスの管理] 項目を示すスクリーンショット](/assets/images/help/projects-v2/manage-access.png) -2. **[コラボレーターの招待]** で、招待するチームまたは個人ユーザーを検索します。 - ![コラボレーターの検索を示すスクリーンショット](/assets/images/help/projects-v2/access-search.png) -3. コラボレータのロールを選択してください。 - ![ロールの選択を示すスクリーンショット](/assets/images/help/projects-v2/access-role.png) - - **読み取り**: そのチームまたは個人がプロジェクトを表示できます。 - - **書き込み**: そのチームまたは個人がプロジェクトを表示して編集できます。 - - **管理者**: そのチームまたは個人が、プロジェクトの表示、編集、新しいコラボレーターの追加が可能です。 -4. **[招待]** をクリックします。 - ![[招待] ボタンを示すスクリーンショット](/assets/images/help/projects-v2/access-invite.png) +1. Click **Manage access**. + ![Screenshot showing the "Manage access" item](/assets/images/help/projects-v2/manage-access.png) +2. Under **Invite collaborators**, search for the team or individual user that you want to invite. + ![Screenshot showing searching for a collaborator](/assets/images/help/projects-v2/access-search.png) +3. Select the role for the collaborator. + ![Screenshot showing selecting a role](/assets/images/help/projects-v2/access-role.png) + - **Read**: The team or individual can view the project. + - **Write**: The team or individual can view and edit the project. + - **Admin**: The team or individual can view, edit, and add new collaborators to the project. +4. Click **Invite**. + ![Screenshot showing the invite button](/assets/images/help/projects-v2/access-invite.png) -### プロジェクトの既存のコラボレータのアクセス管理 +### Managing access of an existing collaborator on your project {% data reusables.projects.project-settings %} -1. **[アクセスの管理]** をクリックします。 - ![[アクセスの管理] 項目を示すスクリーンショット](/assets/images/help/projects-v2/manage-access.png) -1. **[アクセスの管理]** で、権限を変更するコラボレーターを見つけます。 +1. Click **Manage access**. + ![Screenshot showing the "Manage access" item](/assets/images/help/projects-v2/manage-access.png) +1. Under **Manage access**, find the collaborator(s) whose permissions you want to modify. - **[種類]** ドロップダウン メニューと **[ロール]** ドロップダウン メニューを使用して、アクセス リストをフィルター処理できます。 - ![コラボレーターを示すスクリーンショット](/assets/images/help/projects-v2/access-find-member.png) + You can use the **Type** and **Role** drop-down menus to filter the access list. + ![Screenshot showing a collaborator](/assets/images/help/projects-v2/access-find-member.png) -1. コラボレーターのロールを編集します。 - ![コラボレーターのロールの変更を示すスクリーンショット](/assets/images/help/projects-v2/access-change-role.png) -1. 必要に応じて、 **[削除]** をクリックしてコラボレーターを削除します。 - ![コラボレーターの削除を示すスクリーンショット](/assets/images/help/projects-v2/access-remove-member.png) +1. Edit the role for the collaborator(s). + ![Screenshot showing changing a collaborator's role](/assets/images/help/projects-v2/access-change-role.png) +1. Optionally, click **Remove** to remove the collaborator(s). + ![Screenshot showing removing a collaborator](/assets/images/help/projects-v2/access-remove-member.png) -## ユーザレベルプロジェクトのアクセス管理 +## Managing access for user-level projects -### プロジェクトへのコラボレータのアクセスの付与 +### Granting a collaborator access to your project {% note %} -これはプロジェクトのコラボレータにのみ影響し、プロジェクトのリポジトリには影響しません。 プロジェクト上のアイテムを見るためには、ユーザはアイテムが属するリポジトリに対する必要な権限を持っていなければなりません。 プロジェクトにプライベートリポジトリのアイテムが含まれているなら、そのリポジトリのコラボレータではないユーザは、そのリポジトリのアイテムを見ることはできません。 詳細については、「[リポジトリの可視性を設定する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility)」および「[リポジトリへのアクセス権を持つチームと人を管理する](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)」を参照してください。 +This only affects collaborators for your project, not for repositories in your project. To view an item on the project, someone must have the required permissions for the repository that the item belongs to. If your project includes items from a private repository, people who are not collaborators in the repository will not be able to view items from that repository. For more information, see "[Setting repository visibility](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/setting-repository-visibility)" and "[Managing teams and people with access to your repository](/repositories/managing-your-repositorys-settings-and-features/managing-repository-settings/managing-teams-and-people-with-access-to-your-repository)." {% endnote %} {% data reusables.projects.project-settings %} -1. **[アクセスの管理]** をクリックします。 - ![[アクセスの管理] 項目を示すスクリーンショット](/assets/images/help/projects-v2/manage-access.png) -2. **[コラボレーターの招待]** で、招待するユーザーを検索します。 - ![コラボレーターの検索を示すスクリーンショット](/assets/images/help/projects-v2/access-search.png) -3. コラボレータのロールを選択してください。 - ![ロールの選択を示すスクリーンショット](/assets/images/help/projects-v2/access-role.png) - - **読み取り**: その個人がプロジェクトを表示できます。 - - **書き込み**: その個人がプロジェクトを表示して編集できます。 - - **管理者**: その個人が、プロジェクトの表示、編集、新しいコラボレーターの追加が可能です。 -4. **[招待]** をクリックします。 - ![[招待] ボタンを示すスクリーンショット](/assets/images/help/projects-v2/access-invite.png) +1. Click **Manage access**. + ![Screenshot showing the "Manage access" item](/assets/images/help/projects-v2/manage-access.png) +2. Under **Invite collaborators**, search for the user that you want to invite. + ![Screenshot showing searching for a collaborator](/assets/images/help/projects-v2/access-search.png) +3. Select the role for the collaborator. + ![Screenshot showing selecting a role](/assets/images/help/projects-v2/access-role.png) + - **Read**: The individual can view the project. + - **Write**: The individual can view and edit the project. + - **Admin**: The individual can view, edit, and add new collaborators to the project. +4. Click **Invite**. + ![Screenshot showing the invite button](/assets/images/help/projects-v2/access-invite.png) -### プロジェクトの既存のコラボレータのアクセス管理 +### Managing access of an existing collaborator on your project {% data reusables.projects.project-settings %} -1. **[アクセスの管理]** をクリックします。 - ![[アクセスの管理] 項目を示すスクリーンショット](/assets/images/help/projects-v2/manage-access.png) -1. **[アクセスの管理]** で、権限を変更するコラボレーターを見つけます。 +1. Click **Manage access**. + ![Screenshot showing the "Manage access" item](/assets/images/help/projects-v2/manage-access.png) +1. Under **Manage access**, find the collaborator(s) whose permissions you want to modify. - **[種類]** ドロップダウン メニューと **[ロール]** ドロップダウン メニューを使用して、アクセス リストをフィルター処理できます。 - ![コラボレーターを示すスクリーンショット](/assets/images/help/projects-v2/access-find-member.png) + You can use the **Type** and **Role** drop-down menus to filter the access list. + ![Screenshot showing a collaborator](/assets/images/help/projects-v2/access-find-member.png) -1. コラボレーターのロールを編集します。 - ![コラボレーターのロールの変更を示すスクリーンショット](/assets/images/help/projects-v2/access-change-role.png) -1. 必要に応じて、 **[削除]** をクリックしてコラボレーターを削除します。 - ![コラボレーターの削除を示すスクリーンショット](/assets/images/help/projects-v2/access-remove-member.png) +1. Edit the role for the collaborator(s). + ![Screenshot showing changing a collaborator's role](/assets/images/help/projects-v2/access-change-role.png) +1. Optionally, click **Remove** to remove the collaborator(s). + ![Screenshot showing removing a collaborator](/assets/images/help/projects-v2/access-remove-member.png) diff --git a/translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md b/translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md index f0b0092726..522bc91b7a 100644 --- a/translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md +++ b/translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md @@ -1,6 +1,6 @@ --- -title: 'Organization の {% data variables.product.prodname_project_v1 %} への Team のアクセスを管理する' -intro: 'Organization オーナーまたは {% data variables.projects.projects_v1_board %} 管理者は、Organization が所有する {% data variables.projects.projects_v1_board %} へのアクセス権を Team に付与できます。' +title: Managing team access to an organization {% data variables.product.prodname_project_v1 %} +intro: 'As an organization owner or {% data variables.projects.projects_v1_board %} admin, you can give a team access to a {% data variables.projects.projects_v1_board %} owned by your organization.' redirect_from: - /articles/managing-team-access-to-an-organization-project-board - /github/setting-up-and-managing-organizations-and-teams/managing-team-access-to-an-organization-project-board @@ -14,46 +14,58 @@ topics: - Teams shortTitle: Manage team access allowTitleToDifferFromFilename: true -ms.openlocfilehash: 9672dddc31d39349ec99488313e021bca0c12c60 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147422868' --- + {% data reusables.projects.project_boards_old %} {% warning %} -**警告:** -- Team が {% data variables.projects.projects_v1_board %} に直接アクセスできる場合、そのチームのアクセス許可レベルを変更できます。 {% data variables.projects.projects_v1_board %} への Team のアクセスが親 Team から継承された場合、{% data variables.projects.projects_v1_board %} への親 Team のアクセスを変更する必要があります。 -- 親 Team の {% data variables.projects.projects_v1_board %} へのアクセスを追加または削除した場合、その親の各子 Team も {% data variables.projects.projects_v1_board %} へのアクセスを受け取るか、または失います。 詳細については、「[Team について](/articles/about-teams)」を参照してください。 +**Warnings:** +- You can change a team's permission level if the team has direct access to a {% data variables.projects.projects_v1_board %}. If the team's access to the {% data variables.projects.projects_v1_board %} is inherited from a parent team, you must change the parent team's access to the {% data variables.projects.projects_v1_board %}. +- If you add or remove {% data variables.projects.projects_v1_board %} access for a parent team, each of that parent's child teams will also receive or lose access to the {% data variables.projects.projects_v1_board %}. For more information, see "[About teams](/articles/about-teams)." {% endwarning %} -## {% data variables.projects.projects_v1_board %} へのアクセス権を Team に付与する +## Giving a team access to a {% data variables.projects.projects_v1_board %} -{% data variables.projects.projects_v1_board %} への同じアクセス許可レベルを Team 全体に付与できます。 +You can give an entire team the same permission level to a {% data variables.projects.projects_v1_board %}. {% note %} -**注:** {% data reusables.project-management.cascading-permissions %} たとえば、Organization オーナーが {% data variables.projects.projects_v1_board %} への読み取りアクセス許可をチームに付与しており、{% data variables.projects.projects_v1_board %} 管理者が個別のコラボレーターとしてそのボードへの管理者アクセス許可を Team メンバーの 1 人に付与した場合、そのメンバーは {% data variables.projects.projects_v1_board %} への管理者アクセス許可を持つことになります。 詳しい情報については、「[Organization の {% data variables.product.prodname_project_v1_caps %} へのアクセス許可](/articles/project-board-permissions-for-an-organization)」を参照してください。 +**Note:** {% data reusables.project-management.cascading-permissions %} For example, if an organization owner has given a team read permissions to a {% data variables.projects.projects_v1_board %}, and a {% data variables.projects.projects_v1_board %} admin gives one of the team members admin permissions to that board as an individual collaborator, that person would have admin permissions to the {% data variables.projects.projects_v1_board %}. For more information see, "[{% data variables.product.prodname_project_v1_caps %} permissions for an organization](/articles/project-board-permissions-for-an-organization)." {% endnote %} -{% data reusables.profile.access_org %} {% data reusables.user-settings.access_org %} {% data reusables.organizations.organization-wide-project %}{% ifversion projects-v2 %} -1. **[Project (classic)]** をクリックします{% endif %} {% data reusables.project-management.select-project %} {% data reusables.project-management.click-menu %} {% data reusables.project-management.access-collaboration-settings %} -8. 左側のサイドバーで、 **[Team]** をクリックします。 -9. Team を追加するには、 **[Team の追加: Team の選択]** をクリックします。 次に、ドロップダウン メニューからチームを選択するか、追加したいチームを検索します。 - ![Organization の Team のリストが表示されている [Team の追加] ドロップダウン メニュー](/assets/images/help/projects/add-a-team.png) -10. Team 名の横にあるドロップダウン メニューを使用して、目的の権限レベル (**読み取り**、**書き込み**、または **管理者**) を選択します。![読み取り、書き込み、管理者オプションを含む [Team のアクセス許可] ドロップダウン メニュー](/assets/images/help/projects/org-project-team-choose-permissions.png) +{% data reusables.profile.access_org %} +{% data reusables.user-settings.access_org %} +{% data reusables.organizations.organization-wide-project %}{% ifversion projects-v2 %} +1. Click **Projects (classic)**{% endif %} +{% data reusables.project-management.select-project %} +{% data reusables.project-management.click-menu %} +{% data reusables.project-management.access-collaboration-settings %} +8. In the left sidebar, click **Teams**. +9. To add a team, click **Add a team: Select team**. Then, choose a team from the drop-down menu or search for the team you'd like to add. + ![Add a team drop-down menu with list of teams in organization](/assets/images/help/projects/add-a-team.png) +10. Next to the team name, use the drop-down menu to select the desired permission level: **Read**, **Write**, or **Admin**. + ![Team permissions drop-down menu with read, write, and admin options](/assets/images/help/projects/org-project-team-choose-permissions.png) -## {% data variables.projects.projects_v1_board %} への Team のアクセスを構成する +## Configuring a team's access to a {% data variables.projects.projects_v1_board %} -{% data variables.projects.projects_v1_board %} への Team のアクセスが親 Team から継承された場合、子 Team へのアクセスを更新するには、{% data variables.projects.projects_v1_board %} への親 Team のアクセスを変更する必要があります。 +If a team's access to a {% data variables.projects.projects_v1_board %} is inherited from a parent team, you must change the parent team's access to the {% data variables.projects.projects_v1_board %} to update access to the child teams. -{% data reusables.profile.access_org %} {% data reusables.user-settings.access_org %} {% data reusables.organizations.specific_team %} -4. Team の会話の上の、{% octicon "project" aria-label="The Projects icon" %} **[プロジェクト]** をクリックします。 - ![Team の [リポジトリ] タブ](/assets/images/help/organizations/team-project-board-button.png) -5. アクセス許可レベルを変更するには、更新する {% data variables.projects.projects_v1_board %} の右側にあるドロップダウンを使用します。 {% data variables.projects.projects_v1_board %} を削除するには、 **{% octicon "trash" aria-label="The trash icon" %}** をクリックします。 - ![Team からプロジェクト ボードを削除するごみ箱ボタン](/assets/images/help/organizations/trash-button.png) +{% data reusables.profile.access_org %} +{% data reusables.user-settings.access_org %} +{% data reusables.organizations.specific_team %} +4. Above the team's conversation, click {% octicon "project" aria-label="The Projects icon" %} **Projects**. + ![The team repositories tab](/assets/images/help/organizations/team-project-board-button.png) +5. To change permissions levels, to the right of the {% data variables.projects.projects_v1_board %} you want to update, use the drop-down. To remove a {% data variables.projects.projects_v1_board %}, click **{% octicon "trash" aria-label="The trash icon" %}**. + ![Remove a project board from your team trash button](/assets/images/help/organizations/trash-button.png) + +{% ifversion projects-v2-add-to-team %} + +## Further reading + +- [Adding your project to a team](/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team) + + +{% endif %} \ No newline at end of file diff --git a/translations/ja-JP/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md b/translations/ja-JP/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md index 2e9ed9e35e..dd8c5100cd 100644 --- a/translations/ja-JP/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md +++ b/translations/ja-JP/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Organization のフォークポリシーを管理する -intro: 'Organization が所有するプライベート{% ifversion ghes or ghae or ghec %}および内部{% endif %}リポジトリのフォークを許可または禁止できます。' +title: Managing the forking policy for your organization +intro: 'You can allow or prevent the forking of any private{% ifversion ghes or ghae or ghec %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -15,24 +15,30 @@ topics: - Organizations - Teams shortTitle: Manage forking policy -ms.openlocfilehash: 11aad8ee3c08b62f6bc352f91b6d804f35eee6e6 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: '145119301' --- -既定では、新しい組織はプライベート{% ifversion ghes or ghec or ghae %}および内部{% endif %}リポジトリのフォークを禁止するように構成されます。 -組織レベルでプライベート{% ifversion ghes or ghec or ghae %}および内部{% endif %}リポジトリのフォークを許可する場合は、特定のプライベート{% ifversion ghes or ghec or ghae %}または内部{% endif %}リポジトリをフォークする機能を構成することもできます。 詳細については、「[リポジトリのフォーク ポリシーを管理する](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)」を参照してください。 +By default, new organizations are configured to disallow the forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories. -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.profile.org_member_privileges %} -1. [リポジトリのフォーク] の下で、 **[プライベート{% ifversion ghec or ghes or ghae %}および内部{% endif %}リポジトリのフォークを許可する]** を選択します。 +If you allow forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% ifversion ghes or ghec or ghae %} 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)." - {%- ifversion fpt %} ![組織でのフォークを許可または禁止するためのチェックボックス](/assets/images/help/repository/allow-disable-forking-fpt.png) {%- elsif ghes or ghec or ghae %} ![組織でのフォークを許可または禁止するためのチェックボックス](/assets/images/help/repository/allow-disable-forking-organization.png) {%- endif %} -6. **[保存]** をクリックします。 +{% ifversion org-owners-limit-forks-creation %} +{% ifversion ghec %}If your organization is owned by an enterprise account, you{% else %}You{% endif %} may not be able to configure this setting for your organization, if an enterprise owner has set a policy at the enterprise level. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-forking-private-or-internal-repositories)."{% endif %} -## 参考資料 +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.profile.org_member_privileges %} +1. Under "Repository forking", select **Allow forking of private {% ifversion ghec or ghes or ghae %}and internal {% endif %}repositories**. -- 「[フォークについて](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)」 -- 「[Organization のリポジトリ ロール](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)」 + {%- ifversion fpt %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-fpt.png) + {%- elsif ghes or ghec or ghae %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-organization.png) + {%- endif %}{% ifversion org-owners-limit-forks-creation %} +2. Optionally, if forking is enabled, you can specify where users are allowed to fork repositories. If your organization belongs to a {% data variables.product.prodname_enterprise %} account and a more restrictive default has been selected in the enterprise settings, you won't be able to select the more permissive default in your organization settings. Review the information about changing the setting and choose a policy. + ![Screenshot showing the list of repository forking policy options](/assets/images/help/business-accounts/org-repository-forking-policy-settings.png){%- endif %} +3. Click **Save**. + +## Further reading + +- "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" +- "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)" diff --git a/translations/ja-JP/content/repositories/archiving-a-github-repository/archiving-repositories.md b/translations/ja-JP/content/repositories/archiving-a-github-repository/archiving-repositories.md index b866e36b70..2257eb1ecd 100644 --- a/translations/ja-JP/content/repositories/archiving-a-github-repository/archiving-repositories.md +++ b/translations/ja-JP/content/repositories/archiving-a-github-repository/archiving-repositories.md @@ -49,9 +49,20 @@ You can search for archived repositories. For more information, see "[Searching {% data reusables.repositories.navigate-to-repo %} {% data reusables.repositories.sidebar-settings %} -3. Under "Danger Zone", click **Archive this repository** or **Unarchive this repository**. +3. Under "Danger Zone", click **Archive this repository** ![Archive this repository button](/assets/images/help/repository/archive-repository.png) 4. Read the warnings. -5. Type the name of the repository you want to archive or unarchive. +5. Type the name of the repository you want to archive. ![Archive repository warnings](/assets/images/help/repository/archive-repository-warnings.png) 6. Click **I understand the consequences, archive this repository**. + +## Unarchiving a repository + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.repositories.sidebar-settings %} +3. Under "Danger Zone", click **Unarchive this repository** + ![Unarchive this repository button](/assets/images/help/repository/unarchive-repository.png) +4. Read the warnings. +5. Type the name of the repository you want to unarchive. + ![Unarchive repository warnings](/assets/images/help/repository/unarchive-repository-warnings.png) +6. Click **I understand the consequences, unarchive this repository**. diff --git a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md index c52b1f4f18..53cf00e556 100644 --- a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md +++ b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md @@ -47,7 +47,16 @@ To reduce the size of your CODEOWNERS file, consider using wildcard patterns to ## CODEOWNERS syntax -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). The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. +{% warning %} + +**Warning:** 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 + +{% endwarning %} + +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. The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. {% ifversion fpt or ghec%}In most cases, you{% else %}You{% endif %} can also refer to a user by an email address that has been added to their account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, for example `user@example.com`. {% ifversion fpt or ghec %} You cannot use an email address to refer to a {% data variables.product.prodname_managed_user %}. For more information about {% data variables.product.prodname_managed_users %}, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}{% endif %} @@ -117,15 +126,6 @@ apps/ @octocat /apps/github ``` -{% warning %} - -**Warning:** 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 - -{% endwarning %} - ## CODEOWNERS and branch protection Repository owners can add branch protection rules to ensure that changed code is reviewed by the owners of the changed files. For more information, see "[About protected branches](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)." diff --git a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md index ac0814041c..70049d7c6e 100644 --- a/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md +++ b/translations/ja-JP/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md @@ -119,9 +119,9 @@ By default, when you create a new repository in your personal account, `GITHUB_T {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.settings-sidebar-actions-general %} 1. Under "Workflow permissions", choose whether you want the `GITHUB_TOKEN` to have read and write access for all scopes, or just read access for the `contents` scope. - - ![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository{% ifversion allow-actions-to-approve-pr-with-ent-repo %}-with-pr-approval{% endif %}.png) - + + {% ifversion allow-actions-to-approve-pr-with-ent-repo %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository-with-pr-approval.png){% else %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository.png){% endif %} + 1. Click **Save** to apply the settings. {% ifversion allow-actions-to-approve-pr-with-ent-repo %} diff --git a/translations/ja-JP/data/release-notes/enterprise-server/3-5/4.yml b/translations/ja-JP/data/release-notes/enterprise-server/3-5/4.yml index 8a687f91ff..b5a846e1c3 100644 --- a/translations/ja-JP/data/release-notes/enterprise-server/3-5/4.yml +++ b/translations/ja-JP/data/release-notes/enterprise-server/3-5/4.yml @@ -27,4 +27,4 @@ sections: - The {% data variables.product.prodname_registry %} npm registry no longer returns a time value in metadata responses. This was done to allow for substantial performance improvements. We continue to have all the data necessary to return a time value as part of the metadata response and will resume returning this value in the future once we have solved the existing performance issues. - Resource limits that are specific to processing pre-receive hooks may cause some pre-receive hooks to fail. - Actions services need to be restarted after restoring an appliance from a backup taken on a different host. - - '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}' + - '{% data reusables.release-notes.ghas-3.4-secret-scanning-known-issue %}' \ No newline at end of file diff --git a/translations/ja-JP/data/release-notes/enterprise-server/3-6/1.yml b/translations/ja-JP/data/release-notes/enterprise-server/3-6/1.yml index 05d73e8f28..14749e4e64 100644 --- a/translations/ja-JP/data/release-notes/enterprise-server/3-6/1.yml +++ b/translations/ja-JP/data/release-notes/enterprise-server/3-6/1.yml @@ -1,41 +1,33 @@ date: '2022-08-30' sections: bugs: - - After unlocking a repository for temporary access, a site administrator was unable to manage settings for security products in the repository. - - Duplicate administrative SSH keys could appear in both the Management Console and the `/home/admin/.ssh/authorized_keys` file. - - The site admin page for individual users at http(s)://HOSTNAME/stafftools/users/USERNAME/admin contained functionality not intended for GitHub Enterprise Server. - - In some cases, running `ghe-cluster-config-apply` could replicate an empty configuration to existing nodes in a cluster. - - In some cases, configuration runs started with `ghe-config-apply` did not complete, or returned a `Container count mismatch` error. - - After updating a self-signed TLS certificate on a GitHub Enterprise Server instance, UI elements on some pages in the web interface did not appear. - - In some cases, background tasks could stall due to a library that was used concurrently despite not being thread-safe. - - The site admin bar at the top of the web interface contained a broken link to the SHA for the currently running version of the application. - - Organization owners were unable to set the level of access required to create discussions. - - Discussions users were incorrectly directed to the community guidelines for GitHub.com. - - In some cases, users were incorrectly instructed to verify their email before creating a discussion. - - Alerts from secret scanning for GitHub Advanced Security customers were missing in the web UI and REST API if a site administrator did not upgrade directly to GitHub Enterprise Server 3.4. The alerts are now visible. + - 一時的なアクセスのためにリポジトリのロックを解除した後、サイト管理者はリポジトリのセキュリティ製品の設定を管理できませんでした。 + - 管理コンソールと `/home/admin/.ssh/authorized_keys` ファイルの両方に、重複する管理 SSH キーが表示されることがありました。 + - "http(s)://<ホスト名>/stafftools/users/<ユーザー名>/admin の個人ユーザー向けサイト管理者ページに、GitHub Enterprise Server には意図されていない機能が含まれました。" + - 場合によっては、`ghe-cluster-config-apply` を実行して空の構成をクラスターの既存のノードにレプリケートできました。 + - "`ghe-config-apply` で開始された構成の実行が、完了しないこと、または`Container count mismatch` エラーを返すことがありました。" + - GitHub Enterprise Server インスタンス上の自己署名 TLS 証明書を更新した後、Web インターフェイスの一部のページの UI 要素が表示されませんでした。 + - 場合によっては、スレッドセーフではないにも関わらず同時に使われたライブラリのため、バックグラウンド タスクが停止することがありました。 + - Web インターフェイスの上部のサイト管理者バーに含まれる、現在実行中のアプリケーションのバージョンに対する SHA へのリンクが、壊れていました。 + - Organization 所有者は、ディスカッションの作成に必要なアクセスのレベルを設定できませんでした。 + - ディスカッションのユーザーは、GitHub.com のコミュニティ ガイドラインに誤って誘導されました。 + - ユーザーは、ディスカッションを作成する前にメールを検証するよう、誤って指示されることがありました。 + - サイト管理者が GitHub Enterprise Server 3.4 に直接アップグレードしなかった場合、GitHub Advanced Security のお客様に対するシークレット スキャンからのアラートが、Web UI と REST API に表示されませんでした。現在は、アラートが表示されます。 changes: - - Generation of support bundles is faster as a result of parallelized log sanitization. For more information about support bundles, see "[Providing data to GitHub Support](/support/contacting-github-support/providing-data-to-github-support)." - - APIs that contain the `organization` or `org` route now accept either the organization's slug or ID. Previously, the APIs only accepted slugs, which caused `Link` headers for GitHub Advanced Security endpoints to be inaccessible. For more information, see "[Organizations](https://docs.github.com/rest/orgs/orgs)" in the REST API documentation. - - The enterprise audit log now includes more user-generated events, such as `project.create`. The REST API also returns additional user-generated events, such as `repo.create`. For more information, see "[Accessing the audit log for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise)" and "[Using the audit log API for your enterprise](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise#querying-the-audit-log-rest-api)." - - In some cases, cache replicas could reject some Git operations on recently updated repositories. For more information about repository caching, see "[About repository caching](/admin/enterprise-management/caching-repositories/about-repository-caching)." - - You can now configure the global announcement banner to be dismissable using the REST API. For more information, see "[Customizing user messages for your enterprise](/admin/user-management/managing-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner)." + - "並列化されたログ サニタイズの結果、サポート バンドルの生成が速くなっています。サポート バンドルについて詳しくは、「[GitHub Support へのデータの提供](/support/contacting-github-support/providing-data-to-github-support)」をご覧ください。" + - "`organization` または `org` ルートを含む API が、Organization のスラッグまたは ID を受け取るようになりました。以前の API はスラッグのみを受け取っており、そのために GitHub Advanced Security エンドポイントの `Link` ヘッダーにアクセスできませんでした。詳しくは、REST API のドキュメントの「[組織](https://docs.github.com/rest/orgs/orgs)」をご覧ください。" + - "Enterprise の監査ログに含まれるユーザー生成イベントが増えました (`project.create` など)。REST API からも、追加のユーザー生成イベントが返されます (`repo.create` など)。詳しくは、「[企業の監査ログにアクセスする](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/accessing-the-audit-log-for-your-enterprise)」と「[Enterprise 用の監査ログ API の使用](/admin/monitoring-activity-in-your-enterprise/reviewing-audit-logs-for-your-enterprise/using-the-audit-log-api-for-your-enterprise#querying-the-audit-log-rest-api)」をご覧ください。" + - "キャッシュ レプリカが、最近更新されたリポジトリでの一部の Git 操作を拒否することがありました。リポジトリのキャッシュについて詳しくは、「[リポジトリのキャッシュについて](/admin/enterprise-management/caching-repositories/about-repository-caching)」をご覧ください。" + - "REST API を使って閉じることができるよう、グローバル通知バナーを構成できるようになりました。詳しくは、「[Enterprise のユーザメッセージをカスタマイズする](/admin/user-management/managing-users-in-your-enterprise/customizing-user-messages-for-your-enterprise#creating-a-global-announcement-banner)」をご覧ください。" known_issues: - - On a freshly set up {% data variables.product.prodname_ghe_server %} instance without any users, an attacker could create the first admin user. - - Custom firewall rules are removed during the upgrade process. - - 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. - - Issues cannot be closed if they contain a permalink to a blob in the same repository, where the blob's file path is longer than 255 characters. - - 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. - - The {% data variables.product.prodname_registry %} npm registry no longer returns a time value in metadata responses. This was done to allow for substantial performance improvements. We continue to have all the data necessary to return a time value as part of the metadata response and will resume returning this value in the future once we have solved the existing performance issues. - - Resource limits that are specific to processing pre-receive hooks may cause some pre-receive hooks to fail. - - Actions services need to be restarted after restoring an instance from a backup taken on a different host. - - In a repository's settings, enabling the option to allow users with read access to create discussions does not enable this functionality. - - In some cases, users cannot convert existing issues to discussions. - - Custom patterns for secret scanning have `.*` as an end delimiter, specifically in the "After secret" field. This delimiter causes inconsistencies in scans for secrets across repositories, and you may notice gaps in a repository's history where no scans completed. Incremental scans may also be impacted. To prevent issues with scans, modify the end of the pattern to remove the `.*` delimiter. - - | - Running `ghe-repl-status` while upgrading a replica node may indicate `WARNING: git replication is behind the primary`. This warning is due to a change in how GitHub Enterprise Server 3.6.0 and later stores repositories. You can safely ignore this message, and the upgrade will proceed normally. [Updated: 2022-09-26] - - | - Hotpatch upgrades to {% data variables.product.prodname_ghe_server %} 3.6.2 may fail. Upgrades with the full `.pkg` are unaffected. If the upgrade fails for your instance, you can work around the issue in one of two ways. - 1. SSH into the affected node and run `sudo dpkg --configure -a`, then start the upgrade again. - 2. Alternatively, run the full `.pkg` upgrade. - - If you're unable to upgrade, or if you need further assistance, contact GitHub Support. For more information, see "[Creating a support ticket](/support/contacting-github-support/creating-a-support-ticket)." [Updated: 2022-09-26] \ No newline at end of file + - "{% data variables.product.prodname_ghe_server %} インスタンスを設定したばかりでユーザーがいない場合、攻撃者が最初の管理者ユーザーを作成できました。" + - カスタムのファイアウォール規則は、アップグレード プロセス中に削除されます。 + - "[Web インターフェイスからアップロードされた](https://github.com/blog/2105-upload-files-to-your-repositories) Git LFS 追跡ファイルが誤ってリポジトリに直接追加されます。" + - 同じリポジトリ内の BLOB への固定リンクが含まれ、その BLOB のファイル パスが 255 文字を超える場合、issue はクローズできません。 + - "GitHub Connect で [Users can search GitHub.com]\\(ユーザーが GitHub.com を検索できる\\) が有効になっている場合、プライベートと内部リポジトリのイシューが GitHub.com の検索結果に含まれません。" + - "{% data variables.product.prodname_registry %} npm レジストリが、メタデータ応答で時刻値を返さなくなります。これは、パフォーマンスの大幅な向上を見込んで行われました。メタデータ応答の一部として時刻値を返すために必要なすべてのデータを引き続き保持します。また、既存のパフォーマンスの問題を解決したら、将来的にはこの値を再び返す予定です。" + - pre-receive フックの処理に固有のリソース制限が、一部の pre-receive フックのエラーを引き起こす場合があります。 + - 別のホストで作成されたバックアップからインスタンスを復元した後、Actions のサービスを再起動する必要があります。 + - リポジトリの設定で、読み取りアクセス権を持つユーザーにディスカッションの作成を許可するオプションを有効にしても、この機能は有効になりません。 + - ユーザーが既存の issue をディスカッションに変換できない場合があります。 + - "シークレット スキャンのカスタム パターンの末尾の区切り記号は `.*` です (具体的には [After secret]\\(シークレットの後\\) フィールド)。この区切り記号のためにリポジトリ間でのシークレットのスキャンで不整合が発生し、リポジトリの履歴にスキャンが完了していないギャップができる場合があります。増分スキャンも影響を受ける場合があります。スキャンでの問題を避けるには、パターンの末尾を変更して、`.*` 区切り記号を削除します。" diff --git a/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md index 7133590c96..4cb42a307d 100644 --- a/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -1,17 +1,11 @@ ---- -ms.openlocfilehash: bd2ea7e2ff0c8e9f60c3d011ee30573e3702cbed -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147878832" ---- -{% ifversion ghae %} セルフホスト ランナーを {% data variables.product.prodname_dotcom %} と通信できるようにするためには、セルフホスト ランナーの IP アドレスもしくは IP アドレスの範囲を IP 許可リストに追加してください。 詳細については、「[許可 IP アドレスの追加する](#adding-an-allowed-ip-address)」を参照してください。 -{% else %} {% warning %} +{% ifversion ghae %} +To allow your self-hosted runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your self-hosted runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +{% else %} +{% warning %} -**警告**: IP 許可リストを使い、{% data variables.product.prodname_actions %} も使いたい場合には、セルフホスト ランナーを使わなければなりません。 詳細については、「[自分のランナーをホストする](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)」を参照してください。 +**Warning**: If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with a static IP address range{% endif %}. For more information, see "[Hosting your own runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[Using larger runners](/actions/using-github-hosted-runners/using-larger-runners)"{% endif %}. {% endwarning %} -セルフホストランナーが{% data variables.product.prodname_dotcom %}と通信できるようにするためには、セルフホストランナーのIPアドレスもしくはIPアドレスの範囲をIP許可リストに追加してください。 詳細については、「[許可 IP アドレスの追加する](#adding-an-allowed-ip-address)」を参照してください。 +To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." {% endif %} diff --git a/translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md b/translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md index 5a8b7d88ea..1140778695 100644 --- a/translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md +++ b/translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md @@ -1,22 +1,17 @@ ---- -ms.openlocfilehash: 53dbd22ad351ec7a1abc92107b366ecd8c71a3a9 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/05/2022 -ms.locfileid: "147064539" ---- -## サンプルワークフローを作成する +## Create an example workflow -{% data variables.product.prodname_actions %} では、YAML 構文を使用してワークフローを定義します。 各ワークフローは、コード リポジトリ内の `.github/workflows` という名前のディレクトリに個別の YAML ファイルとして格納されます。 +{% data variables.product.prodname_actions %} uses YAML syntax to define the workflow. Each workflow is stored as a separate YAML file in your code repository, in a directory named `.github/workflows`. -コードがプッシュされるたびに一連のコマンドを自動的にトリガーするサンプルワークフローをリポジトリに作成できます。 このワークフローでは、{% data variables.product.prodname_actions %} がプッシュされたコードをチェックアウトし、[bats](https://www.npmjs.com/package/bats) テスト フレームワークをインストールし、bats バージョンを出力する基本コマンド `bats -v` を実行します。 +You can create an example workflow in your repository that automatically triggers a series of commands whenever code is pushed. In this workflow, {% data variables.product.prodname_actions %} checks out the pushed code, installs the [bats](https://www.npmjs.com/package/bats) testing framework, and runs a basic command to output the bats version: `bats -v`. -1. 自身のリポジトリで、ワークフロー ファイルを格納するための `.github/workflows/` ディレクトリを作成します。 -1. `.github/workflows/` ディレクトリで、`learn-github-actions.yml` という名前の新しいファイルを作成し、次のコードを追加します。 +1. In your repository, create the `.github/workflows/` directory to store your workflow files. +1. In the `.github/workflows/` directory, create a new file called `learn-github-actions.yml` and add the following code. - ```yaml + ```yaml{:copy} name: learn-github-actions + {%- ifversion actions-run-name %} + run-name: {% raw %}${{ github.actor }}{% endraw %} is learning GitHub Actions + {%- endif %} on: [push] jobs: check-bats-version: @@ -29,13 +24,13 @@ ms.locfileid: "147064539" - run: npm install -g bats - run: bats -v ``` -1. これらの変更をコミットして、{% data variables.product.prodname_dotcom %} リポジトリにプッシュします。 +1. Commit these changes and push them to your {% data variables.product.prodname_dotcom %} repository. -これで、新しい {% data variables.product.prodname_actions %} ワークフローファイルがリポジトリにインストールされ、別のユーザがリポジトリに変更をプッシュするたびに自動的に実行されます。 ワークフローの実行履歴に関する詳細については、「[ワークフロー実行時のアクティビティを見る](#viewing-the-activity-for-a-workflow-run)」を参照してください。 +Your new {% data variables.product.prodname_actions %} workflow file is now installed in your repository and will run automatically each time someone pushes a change to the repository. To see the details about a workflow's execution history, see "[Viewing the activity for a workflow run](#viewing-the-activity-for-a-workflow-run)." -## ワークフローファイルを理解する +## Understanding the workflow file -YAML 構文を使用してワークフローファイルを作成する方法を理解しやすくするために、このセクションでは、導入例の各行について説明します。 +To help you understand how YAML syntax is used to create a workflow file, this section explains each line of the introduction's example: @@ -46,9 +41,23 @@ YAML 構文を使用してワークフローファイルを作成する方法を ``` +{%- ifversion actions-run-name %} + + + + +{%- endif %} @@ -68,7 +77,7 @@ YAML 構文を使用してワークフローファイルを作成する方法を ``` @@ -79,7 +88,7 @@ YAML 構文を使用してワークフローファイルを作成する方法を ``` @@ -90,7 +99,7 @@ YAML 構文を使用してワークフローファイルを作成する方法を ``` @@ -101,7 +110,7 @@ Ubuntu Linux ランナーの最新バージョンで実行されるようにジ ``` @@ -112,7 +121,7 @@ Ubuntu Linux ランナーの最新バージョンで実行されるようにジ ``` @@ -125,7 +134,7 @@ Ubuntu Linux ランナーの最新バージョンで実行されるようにジ ``` @@ -136,7 +145,7 @@ Ubuntu Linux ランナーの最新バージョンで実行されるようにジ ``` @@ -147,34 +156,34 @@ Ubuntu Linux ランナーの最新バージョンで実行されるようにジ ```
- 省略可能 - {% data variables.product.prodname_dotcom %} リポジトリの [アクション] タブに表示されるワークフローの名前。 + Optional - The name of the workflow as it will appear in the "Actions" tab of the {% data variables.product.prodname_dotcom %} repository.
+ + ```yaml + run-name: {% raw %}${{ github.actor }}{% endraw %} is learning GitHub Actions + ``` + + + Optional - The name for workflow runs generated from the workflow, which will appear in the list of workflow runs on your repository's "Actions" tab. This example uses an expression with the `github` context to display the username of the actor that triggered the workflow run. For more information, see "[Workflow syntax for {% data variables.product.prodname_actions %}](/actions/using-workflows/workflow-syntax-for-github-actions#run-name)." +
@@ -57,7 +66,7 @@ YAML 構文を使用してワークフローファイルを作成する方法を ``` -このワークフローのトリガーを指定します。 この例では、push イベントを使用しているため、変更がリポジトリにプッシュされるか、pull request がマージされるたびに、ワークフロー実行がトリガーされます。 これは、すべてのブランチへのプッシュによってトリガーされます。特定のブランチ、パス、またはタブへのプッシュでのみ実行される構文の例については、「{% data variables.product.prodname_actions %} のワークフロー構文」を参照してください。 +Specifies the trigger for this workflow. This example uses the push event, so a workflow run is triggered every time someone pushes a change to the repository or merges a pull request. This is triggered by a push to every branch; for examples of syntax that runs only on pushes to specific branches, paths, or tags, see "Workflow syntax for {% data variables.product.prodname_actions %}."
-learn-github-actions ワークフローで実行されるすべてのジョブをグループ化します。 + Groups together all the jobs that run in the learn-github-actions workflow.
-check-bats-version という名前のジョブを定義します。 子キーは、ジョブのプロパティを定義します。 +Defines a job named check-bats-version. The child keys will define properties of the job.
-Ubuntu Linux ランナーの最新バージョンで実行されるようにジョブを構成します。 これは、ジョブが GitHub によってホストされている新しい仮想マシンで実行されるということです。 他のランナーを使う構文例については、「{% data variables.product.prodname_actions %} のワークフロー構文」を参照してください。 + Configures the job to run on the latest version of an Ubuntu Linux runner. This means that the job will execute on a fresh virtual machine hosted by GitHub. For syntax examples using other runners, see "Workflow syntax for {% data variables.product.prodname_actions %}."
-check-bats-version ジョブで実行されるすべてのステップをグループ化します。 このセクションで入れ子になった各項目は、個別のアクションまたはシェル スクリプトです。 + Groups together all the steps that run in the check-bats-version job. Each item nested under this section is a separate action or shell script.
-uses キーワードは、このステップが actions/checkout アクションの v3 を実行することを指定します。 これは、リポジトリをランナーにチェックアウトするアクションであり、コードに対してスクリプトまたは他のアクション (ビルド ツールやテスト ツールなど) を実行できます。 チェックアウト アクションは、リポジトリのコードに対してワークフローが実行されるたびに使用する必要があります。 +The uses keyword specifies that this step will run v3 of the actions/checkout action. This is an action that checks out your repository onto the runner, allowing you to run scripts or other actions against your code (such as build and test tools). You should use the checkout action any time your workflow will run against the repository's code.
-このステップでは、{% data reusables.actions.action-setup-node %} アクションを使用して、指定されたバージョン (この例では、v14 を使用) の Node.js をインストールします。 これにより、node と npm の両方のコマンドが PATH にプッシュされます。 + This step uses the {% data reusables.actions.action-setup-node %} action to install the specified version of the Node.js (this example uses v14). This puts both the node and npm commands in your PATH.
-run キーワードは、ランナーでコマンドを実行するようにジョブに指示します。 この場合は、npm を使用して bats ソフトウェア テスト パッケージをインストールします。 + The run keyword tells the job to execute a command on the runner. In this case, you are using npm to install the bats software testing package.
-最後に、ソフトウェアのバージョンを出力するパラメーターを指定して bats を実行します。 + Finally, you'll run the bats command with a parameter that outputs the software version.
-### ワークフローファイルの視覚化 +### Visualizing the workflow file -この図では、作成したワークフローファイルと、{% data variables.product.prodname_actions %} コンポーネントが階層にどのように整理されているかを確認できます。 各ステップでは、単一のアクションまたはシェル スクリプトが実行されます。 ステップ 1 と 2 ではアクションが実行され、ステップ 3 と 4 ではシェル スクリプトが実行されます。 ワークフローの事前構築済みアクションの詳細については、「[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)」 (アクションの検出とカスタマイズ) を参照してください。 +In this diagram, you can see the workflow file you just created and how the {% data variables.product.prodname_actions %} components are organized in a hierarchy. Each step executes a single action or shell script. Steps 1 and 2 run actions, while steps 3 and 4 run shell scripts. To find more prebuilt actions for your workflows, see "[Finding and customizing actions](/actions/learn-github-actions/finding-and-customizing-actions)." -![ワークフローの概要](/assets/images/help/images/overview-actions-event.png) +![Workflow overview](/assets/images/help/images/overview-actions-event.png) -## ワークフロー実行のアクティビティの表示 +## Viewing the activity for a workflow run -ワークフローがトリガーされると、 _ワークフローを実行するワークフロー実行_ が作成されます。 ワークフロー実行の開始後に、実行の進行状況を示す視覚化グラフが表示され、{% data variables.product.prodname_dotcom %} での各ステップのアクティビティを表示できます。 +When your workflow is triggered, a _workflow run_ is created that executes the workflow. After a workflow run has started, you can see a visualization graph of the run's progress and view each step's activity on {% data variables.product.prodname_dotcom %}. {% data reusables.repositories.navigate-to-repo %} -1. リポジトリ名の下にある **[アクション]** をクリックします。 +1. Under your repository name, click **Actions**. - ![リポジトリに移動](/assets/images/help/images/learn-github-actions-repository.png) -1. 左サイドバーで、表示するワークフローをクリックします。 + ![Navigate to repository](/assets/images/help/images/learn-github-actions-repository.png) +1. In the left sidebar, click the workflow you want to see. - ![ワークフロー結果のスクリーンショット](/assets/images/help/images/learn-github-actions-workflow.png) -1. [Workflow runs] で、表示する実行の名前をクリックします。 + ![Screenshot of workflow results](/assets/images/help/images/learn-github-actions-workflow.png) +1. Under "Workflow runs", click the name of the run you want to see. - ![ワークフロー実行のスクリーンショット](/assets/images/help/images/learn-github-actions-run.png) -1. **[ジョブ]** の下、または視覚化グラフ内で、表示するジョブをクリックします。 + ![Screenshot of workflow runs](/assets/images/help/images/learn-github-actions-run.png) +1. Under **Jobs** or in the visualization graph, click the job you want to see. - ![ジョブを選択](/assets/images/help/images/overview-actions-result-navigate.png) -1. 各ステップの結果を表示します。 + ![Select job](/assets/images/help/images/overview-actions-result-navigate.png) +1. View the results of each step. - ![ワークフロー実行の詳細のスクリーンショット](/assets/images/help/images/overview-actions-result-updated-2.png) + ![Screenshot of workflow run details](/assets/images/help/images/overview-actions-result-updated-2.png) diff --git a/translations/ja-JP/data/reusables/repositories/navigate-to-commit-page.md b/translations/ja-JP/data/reusables/repositories/navigate-to-commit-page.md index bff74bffc5..d712c518b8 100644 --- a/translations/ja-JP/data/reusables/repositories/navigate-to-commit-page.md +++ b/translations/ja-JP/data/reusables/repositories/navigate-to-commit-page.md @@ -1,10 +1,2 @@ ---- -ms.openlocfilehash: af420b118bb0fcb0bdad8e2c88f02e5b546fa4f1 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: ja-JP -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147065227" ---- -1. リポジトリのメイン ページで、コミットをクリックしてコミット ページに移動します。 - ![コミットが強調されたリポジトリのメイン ページのスクリーンショット](/assets/images/help/commits/commits-page.png) +1. On the main page of the repository, click {% octicon "history" aria-label="The history icon" %} **commits** to navigate to the commits page. + ![Screenshot of the repository main page with the commits emphasized](/assets/images/help/commits/commits-page.png) diff --git a/translations/log/msft-es-resets.csv b/translations/log/msft-es-resets.csv index ee23a366b2..f1285c7e5b 100644 --- a/translations/log/msft-es-resets.csv +++ b/translations/log/msft-es-resets.csv @@ -295,6 +295,7 @@ translations/es-ES/content/actions/using-workflows/reusing-workflows.md,renderin translations/es-ES/content/actions/using-workflows/sharing-workflows-secrets-and-runners-with-your-organization.md,rendering error translations/es-ES/content/actions/using-workflows/triggering-a-workflow.md,rendering error translations/es-ES/content/actions/using-workflows/workflow-syntax-for-github-actions.md,rendering error +translations/es-ES/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,broken liquid tags translations/es-ES/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error translations/es-ES/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,rendering error @@ -343,6 +344,7 @@ translations/es-ES/content/code-security/dependabot/dependabot-alerts/editing-se translations/es-ES/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md,rendering error translations/es-ES/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,rendering error translations/es-ES/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md,rendering error +translations/es-ES/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md,broken liquid tags translations/es-ES/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md,rendering error translations/es-ES/content/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates.md,rendering error translations/es-ES/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md,rendering error @@ -356,6 +358,7 @@ translations/es-ES/content/code-security/security-overview/about-the-security-ov translations/es-ES/content/code-security/security-overview/viewing-the-security-overview.md,rendering error translations/es-ES/content/code-security/supply-chain-security/end-to-end-supply-chain/securing-code.md,rendering error translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review.md,rendering error +translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md,broken liquid tags translations/es-ES/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,rendering error translations/es-ES/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags translations/es-ES/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags @@ -410,8 +413,14 @@ translations/es-ES/content/codespaces/troubleshooting/troubleshooting-your-conne translations/es-ES/content/communities/documenting-your-project-with-wikis/about-wikis.md,rendering error translations/es-ES/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error translations/es-ES/content/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-personal-account.md,rendering error +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags +translations/es-ES/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags +translations/es-ES/content/copilot/quickstart.md,broken liquid tags translations/es-ES/content/developers/overview/about-githubs-apis.md,broken liquid tags translations/es-ES/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md,rendering error +translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md,broken liquid tags +translations/es-ES/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags translations/es-ES/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md,broken liquid tags @@ -431,7 +440,7 @@ translations/es-ES/content/issues/tracking-your-work-with-issues/linking-a-pull- translations/es-ES/content/issues/tracking-your-work-with-issues/planning-and-tracking-work-for-your-team-or-project.md,broken liquid tags translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/es-ES/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error -translations/es-ES/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,broken liquid tags +translations/es-ES/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error translations/es-ES/content/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization.md,rendering error translations/es-ES/content/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository.md,rendering error translations/es-ES/content/organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository.md,rendering error @@ -440,6 +449,7 @@ translations/es-ES/content/organizations/managing-access-to-your-organizations-r translations/es-ES/content/organizations/managing-access-to-your-organizations-repositories/viewing-people-with-access-to-your-repository.md,rendering error translations/es-ES/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md,rendering error translations/es-ES/content/organizations/managing-organization-settings/integrating-jira-with-your-organization-project-board.md,rendering error +translations/es-ES/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md,broken liquid tags translations/es-ES/content/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization.md,rendering error translations/es-ES/content/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team.md,rendering error translations/es-ES/content/packages/learn-github-packages/about-permissions-for-github-packages.md,rendering error @@ -535,6 +545,7 @@ translations/es-ES/data/reusables/actions/changing-the-name-of-a-runner-group.md translations/es-ES/data/reusables/actions/create-runner-group.md,rendering error translations/es-ES/data/reusables/actions/creating-a-runner-group-for-an-organization.md,rendering error translations/es-ES/data/reusables/actions/enterprise-storage-ha-backups.md,broken liquid tags +translations/es-ES/data/reusables/actions/ip-allow-list-self-hosted-runners.md,broken liquid tags translations/es-ES/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error translations/es-ES/data/reusables/actions/ref_name-description.md,broken liquid tags translations/es-ES/data/reusables/actions/reusable-workflow-artifacts.md,rendering error @@ -596,6 +607,7 @@ translations/es-ES/data/reusables/policies/abuse.md,rendering error translations/es-ES/data/reusables/pull_requests/resolving-conversations.md,broken liquid tags translations/es-ES/data/reusables/repositories/changed-files.md,broken liquid tags translations/es-ES/data/reusables/repositories/navigate-to-code-security-and-analysis.md,rendering error +translations/es-ES/data/reusables/repositories/navigate-to-commit-page.md,broken liquid tags translations/es-ES/data/reusables/repositories/repository-branches.md,rendering error translations/es-ES/data/reusables/repositories/sidebar-notifications.md,rendering error translations/es-ES/data/reusables/repositories/suggest-changes.md,broken liquid tags diff --git a/translations/log/msft-ja-resets.csv b/translations/log/msft-ja-resets.csv index 2ca2535317..df568d1f75 100644 --- a/translations/log/msft-ja-resets.csv +++ b/translations/log/msft-ja-resets.csv @@ -281,6 +281,7 @@ translations/ja-JP/content/actions/learn-github-actions/finding-and-customizing- translations/ja-JP/content/actions/learn-github-actions/understanding-github-actions.md,rendering error translations/ja-JP/content/actions/managing-workflow-runs/re-running-workflows-and-jobs.md,rendering error translations/ja-JP/content/actions/publishing-packages/publishing-docker-images.md,rendering error +translations/ja-JP/content/actions/quickstart.md,broken liquid tags translations/ja-JP/content/actions/security-guides/automatic-token-authentication.md,rendering error translations/ja-JP/content/actions/security-guides/encrypted-secrets.md,rendering error translations/ja-JP/content/actions/security-guides/security-hardening-for-github-actions.md,rendering error @@ -292,6 +293,7 @@ translations/ja-JP/content/actions/using-workflows/reusing-workflows.md,renderin translations/ja-JP/content/actions/using-workflows/sharing-workflows-secrets-and-runners-with-your-organization.md,rendering error translations/ja-JP/content/actions/using-workflows/triggering-a-workflow.md,rendering error translations/ja-JP/content/actions/using-workflows/workflow-syntax-for-github-actions.md,rendering error +translations/ja-JP/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,broken liquid tags translations/ja-JP/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/about-github-actions-for-enterprises.md,rendering error translations/ja-JP/content/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise.md,rendering error @@ -333,6 +335,7 @@ translations/ja-JP/content/code-security/dependabot/dependabot-alerts/editing-se translations/ja-JP/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md,rendering error translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,rendering error translations/ja-JP/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md,rendering error +translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md,broken liquid tags translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md,rendering error translations/ja-JP/content/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates.md,rendering error translations/ja-JP/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md,rendering error @@ -347,6 +350,7 @@ translations/ja-JP/content/code-security/security-overview/about-the-security-ov translations/ja-JP/content/code-security/security-overview/viewing-the-security-overview.md,rendering error translations/ja-JP/content/code-security/supply-chain-security/end-to-end-supply-chain/securing-code.md,rendering error translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review.md,rendering error +translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md,broken liquid tags translations/ja-JP/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,rendering error translations/ja-JP/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags translations/ja-JP/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags @@ -398,9 +402,15 @@ translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-dotfiles-f translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-prebuilds.md,broken liquid tags translations/ja-JP/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,broken liquid tags translations/ja-JP/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error +translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags +translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags +translations/ja-JP/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags +translations/ja-JP/content/copilot/quickstart.md,broken liquid tags translations/ja-JP/content/desktop/installing-and-configuring-github-desktop/installing-and-authenticating-to-github-desktop/authenticating-to-github.md,rendering error translations/ja-JP/content/developers/overview/about-githubs-apis.md,broken liquid tags translations/ja-JP/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md,rendering error +translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md,broken liquid tags +translations/ja-JP/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags translations/ja-JP/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags translations/ja-JP/content/get-started/learning-about-github/about-github-advanced-security.md,rendering error @@ -414,10 +424,12 @@ translations/ja-JP/content/get-started/writing-on-github/working-with-advanced-f translations/ja-JP/content/graphql/guides/migrating-from-rest-to-graphql.md,broken liquid tags translations/ja-JP/content/graphql/overview/about-the-graphql-api.md,broken liquid tags translations/ja-JP/content/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects.md,broken liquid tags +translations/ja-JP/content/issues/planning-and-tracking-with-projects/managing-your-project/managing-access-to-your-projects.md,broken liquid tags translations/ja-JP/content/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests.md,rendering error translations/ja-JP/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/ja-JP/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error +translations/ja-JP/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,broken liquid tags translations/ja-JP/content/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization.md,rendering error translations/ja-JP/content/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository.md,rendering error translations/ja-JP/content/organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository.md,rendering error @@ -426,6 +438,7 @@ translations/ja-JP/content/organizations/managing-access-to-your-organizations-r translations/ja-JP/content/organizations/managing-access-to-your-organizations-repositories/viewing-people-with-access-to-your-repository.md,rendering error translations/ja-JP/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md,rendering error translations/ja-JP/content/organizations/managing-organization-settings/integrating-jira-with-your-organization-project-board.md,rendering error +translations/ja-JP/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md,broken liquid tags translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/adding-a-billing-manager-to-your-organization.md,rendering error translations/ja-JP/content/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization.md,rendering error translations/ja-JP/content/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team.md,rendering error @@ -509,13 +522,13 @@ translations/ja-JP/data/release-notes/enterprise-server/3-4/8.yml,rendering erro translations/ja-JP/data/release-notes/enterprise-server/3-5/0-rc1.yml,rendering error translations/ja-JP/data/release-notes/enterprise-server/3-5/4.yml,rendering error translations/ja-JP/data/release-notes/enterprise-server/3-6/0-rc1.yml,rendering error -translations/ja-JP/data/release-notes/enterprise-server/3-6/1.yml,broken liquid tags translations/ja-JP/data/reusables/actions/actions-audit-events-workflow.md,rendering error translations/ja-JP/data/reusables/actions/artifact-log-retention-statement.md,broken liquid tags translations/ja-JP/data/reusables/actions/changing-the-access-policy-of-a-runner-group.md,rendering error translations/ja-JP/data/reusables/actions/changing-the-name-of-a-runner-group.md,rendering error translations/ja-JP/data/reusables/actions/create-runner-group.md,rendering error translations/ja-JP/data/reusables/actions/creating-a-runner-group-for-an-organization.md,rendering error +translations/ja-JP/data/reusables/actions/ip-allow-list-self-hosted-runners.md,broken liquid tags translations/ja-JP/data/reusables/actions/moving-a-runner-to-a-group.md,rendering error translations/ja-JP/data/reusables/actions/ref_name-description.md,broken liquid tags translations/ja-JP/data/reusables/actions/reusable-workflow-artifacts.md,rendering error @@ -530,6 +543,7 @@ translations/ja-JP/data/reusables/actions/settings-ui/settings-actions-runner-gr translations/ja-JP/data/reusables/actions/settings-ui/settings-actions-runners.md,rendering error translations/ja-JP/data/reusables/actions/sidebar-secret.md,rendering error translations/ja-JP/data/reusables/actions/usage-workflow-run-time.md,rendering error +translations/ja-JP/data/reusables/actions/workflow-basic-example-and-explanation.md,broken liquid tags translations/ja-JP/data/reusables/actions/workflow-dispatch-inputs.md,rendering error translations/ja-JP/data/reusables/advanced-security/secret-scanning-add-custom-pattern-details.md,rendering error translations/ja-JP/data/reusables/advanced-security/secret-scanning-create-custom-pattern.md,rendering error @@ -582,6 +596,7 @@ translations/ja-JP/data/reusables/repositories/blocked-passwords.md,broken liqui translations/ja-JP/data/reusables/repositories/changed-files.md,broken liquid tags translations/ja-JP/data/reusables/repositories/desktop-fork.md,broken liquid tags translations/ja-JP/data/reusables/repositories/navigate-to-code-security-and-analysis.md,rendering error +translations/ja-JP/data/reusables/repositories/navigate-to-commit-page.md,broken liquid tags translations/ja-JP/data/reusables/repositories/repository-branches.md,rendering error translations/ja-JP/data/reusables/repositories/sidebar-notifications.md,rendering error translations/ja-JP/data/reusables/repositories/suggest-changes.md,broken liquid tags diff --git a/translations/log/msft-pt-resets.csv b/translations/log/msft-pt-resets.csv index 98bc619c2a..e6ffc7c66f 100644 --- a/translations/log/msft-pt-resets.csv +++ b/translations/log/msft-pt-resets.csv @@ -284,6 +284,7 @@ translations/pt-BR/content/actions/using-workflows/triggering-a-workflow.md,rend translations/pt-BR/content/actions/using-workflows/workflow-commands-for-github-actions.md,rendering error translations/pt-BR/content/actions/using-workflows/workflow-syntax-for-github-actions.md,rendering error translations/pt-BR/content/admin/configuration/configuring-github-connect/about-github-connect.md,broken liquid tags +translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-email-for-notifications.md,broken liquid tags translations/pt-BR/content/admin/configuration/configuring-your-enterprise/configuring-rate-limits.md,rendering error translations/pt-BR/content/admin/configuration/configuring-your-enterprise/restricting-network-traffic-to-your-enterprise.md,broken liquid tags @@ -340,6 +341,7 @@ translations/pt-BR/content/code-security/dependabot/dependabot-alerts/editing-se translations/pt-BR/content/code-security/dependabot/dependabot-alerts/viewing-and-updating-dependabot-alerts.md,rendering error translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md,rendering error translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates.md,rendering error +translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md,broken liquid tags translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file.md,rendering error translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates.md,rendering error translations/pt-BR/content/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions.md,rendering error @@ -354,6 +356,7 @@ translations/pt-BR/content/code-security/security-overview/about-the-security-ov translations/pt-BR/content/code-security/security-overview/viewing-the-security-overview.md,rendering error translations/pt-BR/content/code-security/supply-chain-security/end-to-end-supply-chain/securing-code.md,rendering error translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review.md,rendering error +translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md,broken liquid tags translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph.md,rendering error translations/pt-BR/content/codespaces/codespaces-reference/allowing-your-codespace-to-access-a-private-image-registry.md,broken liquid tags translations/pt-BR/content/codespaces/codespaces-reference/disaster-recovery-for-github-codespaces.md,broken liquid tags @@ -408,10 +411,16 @@ translations/pt-BR/content/codespaces/troubleshooting/troubleshooting-prebuilds. translations/pt-BR/content/codespaces/troubleshooting/troubleshooting-your-connection-to-github-codespaces.md,broken liquid tags translations/pt-BR/content/codespaces/troubleshooting/working-with-support-for-github-codespaces.md,broken liquid tags translations/pt-BR/content/communities/documenting-your-project-with-wikis/editing-wiki-content.md,rendering error +translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md,broken liquid tags +translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md,broken liquid tags +translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md,broken liquid tags +translations/pt-BR/content/copilot/quickstart.md,broken liquid tags translations/pt-BR/content/developers/apps/building-github-apps/authenticating-with-github-apps.md,rendering error translations/pt-BR/content/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app.md,rendering error translations/pt-BR/content/developers/overview/about-githubs-apis.md,broken liquid tags translations/pt-BR/content/developers/webhooks-and-events/webhooks/webhook-events-and-payloads.md,rendering error +translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md,broken liquid tags +translations/pt-BR/content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md,broken liquid tags translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/integrate-github-classroom-with-an-ide.md,broken liquid tags translations/pt-BR/content/education/manage-coursework-with-github-classroom/integrate-github-classroom-with-an-ide/using-github-codespaces-with-github-classroom.md,broken liquid tags translations/pt-BR/content/education/manage-coursework-with-github-classroom/teach-with-github-classroom/connect-a-learning-management-system-to-github-classroom.md,broken liquid tags @@ -432,7 +441,7 @@ translations/pt-BR/content/issues/tracking-your-work-with-issues/filtering-and-s translations/pt-BR/content/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-the-audit-log-for-your-organization.md,rendering error translations/pt-BR/content/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/reviewing-your-organizations-installed-integrations.md,rendering error -translations/pt-BR/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,broken liquid tags +translations/pt-BR/content/organizations/managing-access-to-your-organizations-project-boards/managing-team-access-to-an-organization-project-board.md,rendering error translations/pt-BR/content/organizations/managing-access-to-your-organizations-repositories/adding-outside-collaborators-to-repositories-in-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-access-to-your-organizations-repositories/managing-an-individuals-access-to-an-organization-repository.md,rendering error translations/pt-BR/content/organizations/managing-access-to-your-organizations-repositories/managing-team-access-to-an-organization-repository.md,rendering error @@ -442,6 +451,7 @@ translations/pt-BR/content/organizations/managing-access-to-your-organizations-r translations/pt-BR/content/organizations/managing-organization-settings/allowing-project-visibility-changes-in-your-organization.md,broken liquid tags translations/pt-BR/content/organizations/managing-organization-settings/disabling-project-boards-in-your-organization.md,rendering error translations/pt-BR/content/organizations/managing-organization-settings/integrating-jira-with-your-organization-project-board.md,rendering error +translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md,broken liquid tags translations/pt-BR/content/organizations/managing-peoples-access-to-your-organization-with-roles/managing-security-managers-in-your-organization.md,rendering error translations/pt-BR/content/organizations/organizing-members-into-teams/managing-code-review-settings-for-your-team.md,rendering error translations/pt-BR/content/packages/learn-github-packages/about-permissions-for-github-packages.md,rendering error @@ -543,6 +553,7 @@ translations/pt-BR/data/reusables/actions/actions-audit-events-workflow.md,rende translations/pt-BR/data/reusables/actions/actions-billing.md,broken liquid tags translations/pt-BR/data/reusables/actions/actions-do-not-trigger-workflows.md,broken liquid tags translations/pt-BR/data/reusables/actions/create-runner-group.md,rendering error +translations/pt-BR/data/reusables/actions/ip-allow-list-self-hosted-runners.md,broken liquid tags translations/pt-BR/data/reusables/actions/jobs/section-running-jobs-in-a-container.md,broken liquid tags translations/pt-BR/data/reusables/actions/ref_name-description.md,broken liquid tags translations/pt-BR/data/reusables/actions/reusable-workflow-artifacts.md,rendering error @@ -609,6 +620,7 @@ translations/pt-BR/data/reusables/pull_requests/resolving-conversations.md,broke translations/pt-BR/data/reusables/release-notes/ghas-3.4-secret-scanning-known-issue.md,rendering error translations/pt-BR/data/reusables/repositories/changed-files.md,broken liquid tags translations/pt-BR/data/reusables/repositories/navigate-to-code-security-and-analysis.md,rendering error +translations/pt-BR/data/reusables/repositories/navigate-to-commit-page.md,broken liquid tags translations/pt-BR/data/reusables/repositories/repository-branches.md,rendering error translations/pt-BR/data/reusables/repositories/sidebar-notifications.md,rendering error translations/pt-BR/data/reusables/repositories/suggest-changes.md,broken liquid tags diff --git a/translations/pt-BR/content/actions/learn-github-actions/contexts.md b/translations/pt-BR/content/actions/learn-github-actions/contexts.md index 0ba85ebbd1..a4fdab860d 100644 --- a/translations/pt-BR/content/actions/learn-github-actions/contexts.md +++ b/translations/pt-BR/content/actions/learn-github-actions/contexts.md @@ -214,6 +214,9 @@ The `github` context contains information about the workflow run and the event t {%- ifversion fpt or ghec or ghes > 3.5 or ghae > 3.4 %} | `github.run_attempt` | `string` | A unique number for each attempt of a particular workflow run in a repository. This number begins at 1 for the workflow run's first attempt, and increments with each re-run. | {%- endif %} +{%- ifversion fpt or ghec or ghes > 3.3 or ghae > 3.3 %} +| `github.secret_source` | `string` | The source of a secret used in a workflow. Possible values are `None`, `Actions`, `Dependabot`, or `Codespaces`. | +{%- endif %} | `github.server_url` | `string` | The URL of the GitHub server. For example: `https://github.com`. | | `github.sha` | `string` | {% data reusables.actions.github_sha_description %} | | `github.token` | `string` | A token to authenticate on behalf of the GitHub App installed on your repository. This is functionally equivalent to the `GITHUB_TOKEN` secret. For more information, see "[Automatic token authentication](/actions/security-guides/automatic-token-authentication)."
Note: This context property is set by the Actions runner, and is only available within the execution `steps` of a job. Otherwise, the value of this property will be `null`. |{% ifversion actions-stable-actor-ids %} diff --git a/translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md b/translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md index bf4579335d..fa49ebc9f5 100644 --- a/translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md +++ b/translations/pt-BR/content/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise.md @@ -1,6 +1,6 @@ --- -title: Habilitando o Dependabot para sua empresa -intro: 'Você pode permitir que os usuários do {% data variables.product.product_location %} encontrem e corrijam vulnerabilidades em dependências de código, habilitando {% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} e {% data variables.product.prodname_dependabot_updates %}{% endif %}.' +title: Enabling Dependabot for your enterprise +intro: 'You can allow users of {% data variables.product.product_location %} to find and fix vulnerabilities in code dependencies by enabling {% data variables.product.prodname_dependabot_alerts %}{% ifversion ghes > 3.2 %} and {% data variables.product.prodname_dependabot_updates %}{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Dependabot redirect_from: @@ -22,107 +22,112 @@ topics: - Security - Dependency graph - Dependabot -ms.openlocfilehash: 271e0ad3a81ea8c8cefac9c4a4db6e18ecad5069 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '146455570' --- -## Sobre {% data variables.product.prodname_dependabot %} para {% data variables.product.product_name %} -O {% data variables.product.prodname_dependabot %} ajuda os usuários do {% data variables.product.product_location %} a encontrar e corrigir vulnerabilidades nas dependências.{% ifversion ghes > 3.2 %} Você pode habilitar os {% data variables.product.prodname_dependabot_alerts %} para notificar os usuários sobre dependências vulneráveis e {% data variables.product.prodname_dependabot_updates %} para corrigir as vulnerabilidades e manter as dependências atualizadas para a última versão. +## About {% data variables.product.prodname_dependabot %} for {% data variables.product.product_name %} -### Sobre {% data variables.product.prodname_dependabot_alerts %} +{% data variables.product.prodname_dependabot %} helps users of {% data variables.product.product_location %} find and fix vulnerabilities in their dependencies.{% ifversion ghes > 3.2 %} You can enable {% data variables.product.prodname_dependabot_alerts %} to notify users about vulnerable dependencies and {% data variables.product.prodname_dependabot_updates %} to fix the vulnerabilities and keep dependencies updated to the latest version. + +### About {% data variables.product.prodname_dependabot_alerts %} {% endif %} {% data reusables.dependabot.dependabot-alerts-beta %} -Com {% data variables.product.prodname_dependabot_alerts %}, o {% data variables.product.prodname_dotcom %} identifica dependências vulneráveis nos repositórios e cria alertas no {% data variables.product.product_location %}, usando dados do {% data variables.product.prodname_advisory_database %} e o serviço grafo de dependência. +With {% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dotcom %} identifies insecure dependencies in repositories and creates alerts on {% data variables.product.product_location %}, using data from the {% data variables.product.prodname_advisory_database %} and the dependency graph service. {% data reusables.repositories.tracks-vulnerabilities %} -Após habilitar o recurso {% data variables.product.prodname_dependabot_alerts %} para a sua empresa, os dados de vulnerabilidade serão sincronizados entre o {% data variables.product.prodname_advisory_database %} e a sua instância uma vez a cada hora. Apenas as consultorias revisadas por {% data variables.product.company_short %} estão sincronizados. {% data reusables.security-advisory.link-browsing-advisory-db %} +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, vulnerability data is synced from the {% data variables.product.prodname_advisory_database %} to your instance once every hour. Only {% data variables.product.company_short %}-reviewed advisories are synchronized. {% data reusables.security-advisory.link-browsing-advisory-db %} -Também é possível sincronizar os dados de vulnerabilidade manualmente a qualquer momento. Para obter mais informações, confira "[Como ver os dados de vulnerabilidade da sua empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)". +You can also choose to manually sync vulnerability data at any time. For more information, see "[Viewing the vulnerability data for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/viewing-the-vulnerability-data-for-your-enterprise)." {% note %} -**Observação:** quando você habilita os {% data variables.product.prodname_dependabot_alerts %}, nenhum código ou informação sobre o código do {% data variables.product.product_location %} é carregado no {% data variables.product.prodname_dotcom_the_website %}. +**Note:** When you enable {% data variables.product.prodname_dependabot_alerts %}, no code or information about code from {% data variables.product.product_location %} is uploaded to {% data variables.product.prodname_dotcom_the_website %}. {% endnote %} -Quando {% data variables.product.product_location %} recebe informações sobre uma vulnerabilidade, ele identifica repositórios em {% data variables.product.product_location %} que usam a versão afetada da dependência e gera {% data variables.product.prodname_dependabot_alerts %}. Você pode escolher se quer ou não notificar os usuários automaticamente sobre o novo {% data variables.product.prodname_dependabot_alerts %}. +When {% data variables.product.product_location %} receives information about a vulnerability, it identifies repositories in {% data variables.product.product_location %} that use the affected version of the dependency and generates {% data variables.product.prodname_dependabot_alerts %}. You can choose whether or not to notify users automatically about new {% data variables.product.prodname_dependabot_alerts %}. -Para repositórios com {% data variables.product.prodname_dependabot_alerts %} habilitado, a digitalização é acionada em qualquer push para o branch padrão que contém um arquivo de manifesto ou arquivo de bloqueio. Além disso, quando um novo registro de vulnerabilidade é adicionado a {% data variables.product.product_location %}, {% data variables.product.product_name %} digitaliza todos os repositórios existentes em {% data variables.product.product_location %} e gera alertas para qualquer repositório que seja vulnerável. Para obter mais informações, confira "[Sobre os {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)". +For repositories with {% data variables.product.prodname_dependabot_alerts %} enabled, scanning is triggered on any push to the default branch that contains a manifest file or lock file. Additionally, when a new vulnerability record is added to {% data variables.product.product_location %}, {% data variables.product.product_name %} scans all existing repositories on {% data variables.product.product_location %} and generates alerts for any repository that is vulnerable. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/github/managing-security-vulnerabilities/about-alerts-for-vulnerable-dependencies)." {% ifversion ghes > 3.2 %} -### Sobre {% data variables.product.prodname_dependabot_updates %} +### About {% data variables.product.prodname_dependabot_updates %} {% data reusables.dependabot.beta-security-and-version-updates %} -Após habilitar {% data variables.product.prodname_dependabot_alerts %}, você poderá optar por habilitar {% data variables.product.prodname_dependabot_updates %}. Quando {% data variables.product.prodname_dependabot_updates %} está habilitado para {% data variables.product.product_location %}, os usuários podem configurar repositórios para que suas dependências sejam atualizadas e mantidas seguras automaticamente. +After you enable {% data variables.product.prodname_dependabot_alerts %}, you can choose to enable {% data variables.product.prodname_dependabot_updates %}. When {% data variables.product.prodname_dependabot_updates %} are enabled for {% data variables.product.product_location %}, users can configure repositories so that their dependencies are updated and kept secure automatically. {% note %} -**Observação:** As {% data variables.product.prodname_dependabot_updates %} do {% data variables.product.product_name %} exigem o {% data variables.product.prodname_actions %} com executores auto-hospedados. +**Note:** {% data variables.product.prodname_dependabot_updates %} on {% data variables.product.product_name %} requires {% data variables.product.prodname_actions %} with self-hosted runners. {% endnote %} -Por padrão, os executores do {% data variables.product.prodname_actions %} corredores usados pelo {% data variables.product.prodname_dependabot %} precisam de acesso à Internet para baixar pacotes atualizados de gerenciadores de pacotes upstream. Para {% data variables.product.prodname_dependabot_updates %} da plataforma {% data variables.product.prodname_github_connect %}, o acesso à Internet oferece aos executores um token que permite acesso a dependências e avisos hospedados no {% data variables.product.prodname_dotcom_the_website %}. +By default, {% data variables.product.prodname_actions %} runners used by {% data variables.product.prodname_dependabot %} need access to the internet, to download updated packages from upstream package managers. For {% data variables.product.prodname_dependabot_updates %} powered by {% data variables.product.prodname_github_connect %}, internet access provides your runners with a token that allows access to dependencies and advisories hosted on {% data variables.product.prodname_dotcom_the_website %}. -Com {% data variables.product.prodname_dependabot_updates %}, {% data variables.product.company_short %} cria automaticamente pull requests para atualizar dependências de duas maneiras. +With {% data variables.product.prodname_dependabot_updates %}, {% data variables.product.company_short %} automatically creates pull requests to update dependencies in two ways. -- **{% data variables.product.prodname_dependabot_version_updates %}** : os usuários adicionam um arquivo de configuração do {% data variables.product.prodname_dependabot %} ao repositório para habilitar o {% data variables.product.prodname_dependabot %} a fim de criar solicitações de pull quando uma nova versão de uma dependência rastreada for lançada. Para obter mais informações, confira "[Sobre as {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)". -- **{% data variables.product.prodname_dependabot_security_updates %}** : os usuários alternam uma configuração de repositório para habilitar o {% data variables.product.prodname_dependabot %} a fim de criar solicitações de pull quando o {% data variables.product.prodname_dotcom %} detecta uma vulnerabilidade em uma das dependências do grafo de dependência do repositório. Para obter mais informações, confira "[Sobre os {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)" e "[Sobre as {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)". +- **{% data variables.product.prodname_dependabot_version_updates %}**: Users add a {% data variables.product.prodname_dependabot %} configuration file to the repository to enable {% data variables.product.prodname_dependabot %} to create pull requests when a new version of a tracked dependency is released. For more information, see "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +- **{% data variables.product.prodname_dependabot_security_updates %}**: Users toggle a repository setting to enable {% data variables.product.prodname_dependabot %} to create pull requests when {% data variables.product.prodname_dotcom %} detects a vulnerability in one of the dependencies of the dependency graph for the repository. For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)" and "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)." {% endif %} -## Habilitando {% data variables.product.prodname_dependabot_alerts %} +## Enabling {% data variables.product.prodname_dependabot_alerts %} -Antes de poder habilitar {% data variables.product.prodname_dependabot_alerts %}: -- Você deve habilitar {% data variables.product.prodname_github_connect %}. Para obter mais informações, confira "[Como gerenciar o {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/managing-github-connect)".{% ifversion ghes %} -- Você deve habilitar o gráfico de dependências. Para obter mais informações, confira "[Como habilitar o grafo de dependência para sua empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)".{% endif %} +Before you can enable {% data variables.product.prodname_dependabot_alerts %}: +- You must enable {% data variables.product.prodname_github_connect %}. For more information, see "[Managing {% data variables.product.prodname_github_connect %}](/admin/configuration/configuring-github-connect/managing-github-connect)."{% ifversion ghes %} +- You must enable the dependency graph. For more information, see "[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)."{% endif %} -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} {%- ifversion dependabot-updates-github-connect %} -1. No "{% data variables.product.prodname_dependabot %}", à direita de "Os usuários podem receber alertas de vulnerabilidade de dependências do código-fonte", selecione o menu suspenso e clique em **Habilitado sem notificações**. Opcionalmente, para habilitar alertas com notificações, clique em **Habilitado com notificações**. +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +{%- ifversion dependabot-updates-github-connect %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can receive vulnerability alerts for open source code dependencies", select the dropdown menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. - ![Captura de tela do menu suspenso para habilitar a digitalização de repositórios com relação a vulnerabilidades](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) + ![Screenshot of the dropdown menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/dependabot-alerts-dropdown.png) {%- else %} -1. Em "Os repositórios podem ser verificados quanto a vulnerabilidades", selecione o menu suspenso e clique em **Habilitado sem notificações**. Opcionalmente, para habilitar alertas com notificações, clique em **Habilitado com notificações**. - ![Menu suspenso usado para habilitar a verificação de vulnerabilidades nos repositórios](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) {%- endif %} {% tip %} +1. Under "Repositories can be scanned for vulnerabilities", select the drop-down menu and click **Enabled without notifications**. Optionally, to enable alerts with notifications, click **Enabled with notifications**. + ![Drop-down menu to enable scanning repositories for vulnerabilities](/assets/images/enterprise/site-admin-settings/enable-vulnerability-scanning-in-repositories.png) +{%- endif %} + {% tip %} - **Dica**: recomendamos configurar os {% data variables.product.prodname_dependabot_alerts %} sem notificações nos primeiros dias para evitar uma sobrecarga de emails. Após alguns dias, você poderá habilitar as notificações para receber {% data variables.product.prodname_dependabot_alerts %}, como de costume. + **Tip**: We recommend configuring {% data variables.product.prodname_dependabot_alerts %} without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive {% data variables.product.prodname_dependabot_alerts %} as usual. {% endtip %} {% ifversion dependabot-updates-github-connect %} -## Habilitar o {% data variables.product.prodname_dependabot_updates %} +## Enabling {% data variables.product.prodname_dependabot_updates %} -Após habilitar {% data variables.product.prodname_dependabot_alerts %} para a sua empresa, você poderá habilitar {% data variables.product.prodname_dependabot_updates %}. +After you enable {% data variables.product.prodname_dependabot_alerts %} for your enterprise, you can enable {% data variables.product.prodname_dependabot_updates %}. -{% ifversion ghes %} Antes de habilitar as {% data variables.product.prodname_dependabot_updates %}, você precisará configurar o {% data variables.product.product_location %} para usar o {% data variables.product.prodname_actions %} com executores auto-hospedados. Para obter mais informações, confira "[Introdução ao {% data variables.product.prodname_actions %} para GitHub Enterprise Server](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)". +{% ifversion ghes %} +{% data reusables.dependabot.enabling-actions-for-ghes %} For more information, see "[Getting started with {% data variables.product.prodname_actions %} for GitHub Enterprise Server](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/getting-started-with-github-actions-for-github-enterprise-server)." -{% data variables.product.prodname_dependabot_updates %} não são compatíveis em {% data variables.product.product_name %} se sua empresa usar clustering. +{% data variables.product.prodname_dependabot_updates %} are not supported on {% data variables.product.product_name %} if your enterprise uses clustering. {% endif %} -{% data reusables.enterprise_site_admin_settings.sign-in %} {% data reusables.enterprise_site_admin_settings.access-settings %} {% data reusables.enterprise_site_admin_settings.management-console %} {% data reusables.enterprise_management_console.advanced-security-tab %} -1. Em "Segurança", selecione **{% data variables.product.prodname_dependabot_security_updates %}** . +{% data reusables.enterprise_site_admin_settings.sign-in %} +{% data reusables.enterprise_site_admin_settings.access-settings %} +{% data reusables.enterprise_site_admin_settings.management-console %} +{% data reusables.enterprise_management_console.advanced-security-tab %} +1. Under "Security", select **{% data variables.product.prodname_dependabot_security_updates %}**. - ![Captura de tela da caixa de seleção para habilitar ou desabilitar {% data variables.product.prodname_dependabot_security_updates %}](/assets/images/enterprise/management-console/enable-dependabot-updates.png) + ![Screenshot of the checkbox to enable or disable {% data variables.product.prodname_dependabot_security_updates %}](/assets/images/enterprise/management-console/enable-dependabot-updates.png) {% data reusables.enterprise_management_console.save-settings %} -1. Clique em **Acessar sua instância**. -1. Configure os executores auto-hospedados para criar os pull requests que atualizarão as dependências. Para obter mais informações, confira "[Como gerenciar executores auto-hospedados para {% data variables.product.prodname_dependabot_updates %} na sua empresa](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)". -{% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.github-connect-tab %} -1. No "{% data variables.product.prodname_dependabot %}", à direita de "Os usuários podem atualizar com facilidade as dependências não vulneráveis do código-fonte", clique em **Habilitar**. +1. Click **Visit your instance**. +1. Configure self-hosted runners to create the pull requests that will update dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." +{% data reusables.enterprise-accounts.access-enterprise %} +{% data reusables.enterprise-accounts.github-connect-tab %} +1. Under "{% data variables.product.prodname_dependabot %}", to the right of "Users can easily upgrade to non-vulnerable open source code dependencies", click **Enable**. - ![Captura de tela do menu suspenso para habilitar a atualização de dependências vulneráveis](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) - -{% endif %} {% ifversion ghes > 3.2 %} - -Ao habilitar {% data variables.product.prodname_dependabot_alerts %}, você também deve considerar relizar a configuração de {% data variables.product.prodname_actions %} para {% data variables.product.prodname_dependabot_security_updates %}. Este recurso permite aos desenvolvedores corrigir a vulnerabilidades nas suas dependências. Para obter mais informações, confira "[Como gerenciar executores auto-hospedados para {% data variables.product.prodname_dependabot_updates %} na sua empresa](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)". - -Se você precisar de segurança aprimorada, recomendamos a configuração do {% data variables.product.prodname_dependabot %} para usar registros privados. Para obter mais informações, confira "[Gerenciar segredos criptografados do {% data variables.product.prodname_dependabot %}](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)". + ![Screenshot of the dropdown menu to enable updating vulnerable dependencies](/assets/images/enterprise/site-admin-settings/dependabot-updates-button.png) + +{% endif %} +{% ifversion ghes > 3.2 %} + +When you enable {% data variables.product.prodname_dependabot_alerts %}, you should consider also setting up {% data variables.product.prodname_actions %} for {% data variables.product.prodname_dependabot_security_updates %}. This feature allows developers to fix vulnerabilities in their dependencies. For more information, see "[Managing self-hosted runners for {% data variables.product.prodname_dependabot_updates %} on your enterprise](/admin/github-actions/enabling-github-actions-for-github-enterprise-server/managing-self-hosted-runners-for-dependabot-updates)." + +If you need enhanced security, we recommend configuring {% data variables.product.prodname_dependabot %} to use private registries. For more information, see "[Managing encrypted secrets for {% data variables.product.prodname_dependabot %}](/code-security/dependabot/working-with-dependabot/managing-encrypted-secrets-for-dependabot)." {% endif %} diff --git a/translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md b/translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md index e4c5db0a41..5ec3ef3506 100644 --- a/translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md +++ b/translations/pt-BR/content/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise.md @@ -108,9 +108,12 @@ If you allow members to create repositories in your organizations, you can choos ![Screenshot showing the list of disabled options from forking policy](/assets/images/help/business-accounts/restrict-personal-namespace-enabled-setting.png){% endif %} ## Enforcing a policy for forking private or internal repositories - Across all organizations owned by your enterprise, you can allow people with access to a private or internal repository to fork the repository, never allow forking of private or internal repositories, or allow owners to administer the setting on the organization level. +{% ifversion org-owners-limit-forks-creation %} +People with admin permissions can set a more granular forking policy. For more information, see "[Managing the forking policy for your organization](/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization)." +{% endif %} + {% ifversion enterprise-namespace-repo-setting %} {% note %} @@ -122,8 +125,8 @@ Across all organizations owned by your enterprise, you can allow people with acc {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.enterprise-accounts.policies-tab %} {% data reusables.enterprise-accounts.repositories-tab %} -3. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} -4. Under "Repository forking", use the drop-down menu and choose a policy. +1. Under "Repository forking", review the information about changing the setting. {% data reusables.enterprise-accounts.view-current-policy-config-orgs %} +2. Under "Repository forking", use the dropdown menu and choose a policy. ![Drop-down menu with repository forking policy options](/assets/images/help/business-accounts/repository-forking-policy-drop-down.png){% ifversion innersource-fork-policies %} 5. If forking is enabled, you can specify where users are allowed to fork repositories. Review the information about changing the setting and choose a policy. diff --git a/translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md b/translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md index c653fba912..1885e6d052 100644 --- a/translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md +++ b/translations/pt-BR/content/code-security/dependabot/dependabot-security-updates/about-dependabot-security-updates.md @@ -37,6 +37,7 @@ topics: The {% data variables.product.prodname_dependabot_security_updates %} feature is available for repositories where you have enabled the dependency graph and {% data variables.product.prodname_dependabot_alerts %}. You will see a {% data variables.product.prodname_dependabot %} alert for every vulnerable dependency identified in your full dependency graph. However, security updates are triggered only for dependencies that are specified in a manifest or lock file. For more information, see "[About the dependency graph](/github/visualizing-repository-data-with-graphs/about-the-dependency-graph#dependencies-included)." {% ifversion dependabot-security-updates-unlock-transitive-dependencies %} + {% note %} **Note**: For npm, {% data variables.product.prodname_dependabot %} will raise a pull request to update an explicitly defined dependency to a secure version, even if it means updating the parent dependency or dependencies{% ifversion dependabot-security-updates-npm %}, or even removing a sub-dependency that is no longer needed by the parent{% endif %}. For other ecosystems, {% data variables.product.prodname_dependabot %} is unable to update an indirect or transitive dependency if it would also require an update to the parent dependency. For more information, see "[Dependabot tries to update dependencies without an alert](/en/code-security/dependabot/working-with-dependabot/troubleshooting-dependabot-errors#dependabot-tries-to-update-dependencies-without-an-alert)." @@ -47,6 +48,8 @@ You can enable a related feature, {% data variables.product.prodname_dependabot_ {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + ## About pull requests for security updates Each pull request contains everything you need to quickly and safely review and merge a proposed fix into your project. This includes information about the vulnerability like release notes, changelog entries, and commit details. Details of which vulnerability a pull request resolves are hidden from anyone who does not have access to {% data variables.product.prodname_dependabot_alerts %} for the repository. diff --git a/translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md b/translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md index 83daeeb1ec..7620498058 100644 --- a/translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md +++ b/translations/pt-BR/content/code-security/dependabot/dependabot-version-updates/about-dependabot-version-updates.md @@ -1,6 +1,6 @@ --- -title: Sobre as atualizações da versão do Dependabot -intro: 'Você pode usar o {% data variables.product.prodname_dependabot %} para manter os pacotes que usa atualizados para as versões mais recentes.' +title: About Dependabot version updates +intro: 'You can use {% data variables.product.prodname_dependabot %} to keep the packages you use updated to the latest versions.' redirect_from: - /github/administering-a-repository/about-dependabot - /github/administering-a-repository/about-github-dependabot @@ -21,53 +21,51 @@ topics: - Dependencies - Pull requests shortTitle: Dependabot version updates -ms.openlocfilehash: 56bac2fbf2fb42a418cffbd478aa526803b124d9 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '145186081' --- -{% data reusables.dependabot.beta-security-and-version-updates %} {% data reusables.dependabot.enterprise-enable-dependabot %} -## Sobre as {% data variables.product.prodname_dependabot_version_updates %} +{% data reusables.dependabot.beta-security-and-version-updates %} +{% data reusables.dependabot.enterprise-enable-dependabot %} -O {% data variables.product.prodname_dependabot %} facilita a manutenção de suas dependências. Você pode usá-lo para garantir que seu repositório se mantenha atualizado automaticamente com as versões mais recentes dos pacotes e aplicações do qual ele depende. +## About {% data variables.product.prodname_dependabot_version_updates %} -Habilite as {% data variables.product.prodname_dependabot_version_updates %} fazendo o check-in de um arquivo de configuração `dependabot.yml` em seu repositório. O arquivo de configuração especifica a localização do manifesto ou de outros arquivos de definição de pacote, armazenados no seu repositório. O {% data variables.product.prodname_dependabot %} usa essas informações para verificar se há pacotes e aplicativos desatualizados. O {% data variables.product.prodname_dependabot %} determina se há uma nova versão de uma dependência examinando o [semver](https://semver.org/) (controle de versão semântica) da dependência para decidir se ela deve ser atualizada para essa versão. Para certos gerentes de pacote, {% data variables.product.prodname_dependabot_version_updates %} também é compatível com armazenamento. Dependências de vendor (ou armazenadas) são dependências registradas em um diretório específico em um repositório, em vez de referenciadas em um manifesto. Dependências de vendor estão disponíveis no tempo de criação, ainda que os servidores de pacote estejam indisponíveis. {% data variables.product.prodname_dependabot_version_updates %} pode ser configurado para verificar as dependências de vendor para novas versões e atualizá-las, se necessário. +{% data variables.product.prodname_dependabot %} takes the effort out of maintaining your dependencies. You can use it to ensure that your repository automatically keeps up with the latest releases of the packages and applications it depends on. -Quando o {% data variables.product.prodname_dependabot %} identifica uma dependência desatualizada, ele gera uma solicitação de pull para atualizar o manifesto para a última versão da dependência. Para dependências de vendor, {% data variables.product.prodname_dependabot %} levanta um pull request para substituir diretamente a dependência desatualizada pela nova versão. Você verifica se os seus testes passam, revisa o changelog e lança observações incluídas no resumo do pull request e, em seguida, faz a mesclagem. Para obter mais informações, confira "[Como configurar as atualizações de versão do {% data variables.product.prodname_dependabot %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)". +You enable {% data variables.product.prodname_dependabot_version_updates %} by checking a `dependabot.yml` configuration file into your repository. The configuration file specifies the location of the manifest, or of other package definition files, stored in your repository. {% data variables.product.prodname_dependabot %} uses this information to check for outdated packages and applications. {% data variables.product.prodname_dependabot %} determines if there is a new version of a dependency by looking at the semantic versioning ([semver](https://semver.org/)) of the dependency to decide whether it should update to that version. For certain package managers, {% data variables.product.prodname_dependabot_version_updates %} also supports vendoring. Vendored (or cached) dependencies are dependencies that are checked in to a specific directory in a repository rather than referenced in a manifest. Vendored dependencies are available at build time even if package servers are unavailable. {% data variables.product.prodname_dependabot_version_updates %} can be configured to check vendored dependencies for new versions and update them if necessary. -Se você habilitar as _atualizações de segurança_, o {% data variables.product.prodname_dependabot %} também vai gerar solicitações de pull para atualizar as dependências vulneráveis. Para obter mais informações, confira "[Sobre as {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)". +When {% data variables.product.prodname_dependabot %} identifies an outdated dependency, it raises a pull request to update the manifest to the latest version of the dependency. For vendored dependencies, {% data variables.product.prodname_dependabot %} raises a pull request to replace the outdated dependency with the new version directly. You check that your tests pass, review the changelog and release notes included in the pull request summary, and then merge it. For more information, see "[Configuring {% data variables.product.prodname_dependabot %} version updates](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/enabling-and-disabling-dependabot-version-updates)." + +If you enable _security updates_, {% data variables.product.prodname_dependabot %} also raises pull requests to update vulnerable dependencies. For more information, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/github/managing-security-vulnerabilities/about-dependabot-security-updates)." {% data reusables.dependabot.pull-request-security-vs-version-updates %} +{% data reusables.dependabot.dependabot-updates-and-actions %} + {% data reusables.dependabot.dependabot-tos %} -## Frequência de {% data variables.product.prodname_dependabot %} pull requests +## Frequency of {% data variables.product.prodname_dependabot %} pull requests -Você especifica com que frequência verifica cada ecossistema para novas versões no arquivo de configuração: diariamente, semanalmente ou mensalmente. +You specify how often to check each ecosystem for new versions in the configuration file: daily, weekly, or monthly. {% data reusables.dependabot.initial-updates %} -Se tiver habilitado atualizações de segurança, às vezes você verá atualizações de segurança extras de pull requests. Elas são disparadas por um alerta do {% data variables.product.prodname_dependabot %} para uma dependência no branch padrão. {% data variables.product.prodname_dependabot %} gera automaticamente um pull request para atualizar a dependência vulnerável. +If you've enabled security updates, you'll sometimes see extra pull requests for security updates. These are triggered by a {% data variables.product.prodname_dependabot %} alert for a dependency on your default branch. {% data variables.product.prodname_dependabot %} automatically raises a pull request to update the vulnerable dependency. -## Repositórios e ecossistemas suportados +## Supported repositories and ecosystems -É possível configurar atualizações de versão para repositórios que contenham um manifesto de dependência ou arquivo de bloqueio para um dos gerentes de pacotes suportados. Para alguns gerenciadores de pacotes, você também pode configurar o armazenamento para dependências. Para obter mais informações, confira "[Opções de configuração para o arquivo dependabot.yml](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)".1 +You can configure version updates for repositories that contain a dependency manifest or lock file for one of the supported package managers. For some package managers, you can also configure vendoring for dependencies. For more information, see "[Configuration options for the dependabot.yml file](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/configuration-options-for-dependency-updates#vendor)." {% note %} {% data reusables.dependabot.private-dependencies-note %} -{% data variables.product.prodname_dependabot %} não é compatível com as dependências privadas de {% data variables.product.prodname_dotcom %} para todos os gerenciadores de pacote. Veja os detalhes na tabela abaixo. +{% 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. {% endnote %} {% data reusables.dependabot.supported-package-managers %} -Se o seu repositório já usa uma integração para gerenciamento de dependências, você precisará desativar isso antes de habilitar o {% data variables.product.prodname_dependabot %}. {% ifversion fpt or ghec %}Para obter mais informações, confira "[Sobre as integrações](/github/customizing-your-github-workflow/about-integrations)".{% endif %} +If your repository already uses an integration for dependency management, you will need to disable this before enabling {% data variables.product.prodname_dependabot %}. {% ifversion fpt or ghec %}For more information, see "[About integrations](/github/customizing-your-github-workflow/about-integrations)."{% endif %} -## Sobre notificações para atualizações de versão para {% data variables.product.prodname_dependabot %} +## About notifications for {% data variables.product.prodname_dependabot %} version updates -Você pode filtrar suas notificações em {% data variables.product.company_short %} para mostrar as notificações para pull requests criados por {% data variables.product.prodname_dependabot %}. Para obter mais informações, confira "[Como gerenciar notificações na sua caixa de entrada](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)". +You can filter your notifications on {% data variables.product.company_short %} to show notifications for pull requests created by {% data variables.product.prodname_dependabot %}. For more information, see "[Managing notifications from your inbox](/github/managing-subscriptions-and-notifications-on-github/managing-notifications-from-your-inbox)." diff --git a/translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md b/translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md index 7d6ff5d607..c5c6fdf15f 100644 --- a/translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md +++ b/translations/pt-BR/content/code-security/supply-chain-security/understanding-your-software-supply-chain/about-supply-chain-security.md @@ -1,6 +1,6 @@ --- -title: Sobre a segurança da cadeia de suprimento -intro: 'O {% data variables.product.product_name %} ajuda você a proteger a cadeia de fornecedores, oferecendo desde o entendimento das dependências do ambiente até a identificação de vulnerabilidades nessas dependências{% ifversion fpt or ghec or ghes > 3.2 %} e a aplicação de patch nelas{% endif %}.' +title: About supply chain security +intro: '{% data variables.product.product_name %} helps you secure your supply chain, from understanding the dependencies in your environment, to knowing about vulnerabilities in those dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and patching them{% endif %}.' miniTocMaxHeadingLevel: 3 shortTitle: Supply chain security redirect_from: @@ -19,136 +19,154 @@ topics: - Dependencies - Pull requests - Repositories -ms.openlocfilehash: 2ad16960d0445994d5414390a62e16d719a10e6c -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147064887' --- -## Sobre a segurança da cadeia de suprimentos no GitHub -Com o uso acelerado de código aberto, a maioria dos projetos depende de centenas de dependências de código aberto. Isso coloca um problema de segurança: e se as dependências que você estiver usando forem vulneráveis? Você poderia colocar os seus usuários em risco de ataque da cadeia de suprimentos. Uma das coisas mais importantes que você pode fazer para proteger a cadeia de fornecedores é corrigir as dependências vulneráveis{% ifversion GH-advisory-db-supports-malware %} e substituir os malwares{% endif %}. +## About supply chain security at GitHub -Você adiciona dependências diretamente à sua cadeia de suprimentos ao especificá-las em um arquivo de manifesto ou um arquivo de bloqueio. As dependências também podem ser incluídas transitoriamente, ou seja, até mesmo se você não especificar uma dependência em particular, mas a sua dependência a usa, portanto, você também depende dessa dependência. +With the accelerated use of open source, most projects depend on hundreds of open-source dependencies. This poses a security problem: what if the dependencies you're using are vulnerable? You could be putting your users at risk of a supply chain attack. One of the most important things you can do to protect your supply chain is to patch your vulnerable dependencies{% ifversion GH-advisory-db-supports-malware %} and replace any malware{% endif %}. -{% data variables.product.product_name %} oferece uma variedade de recursos para ajudar você a entender as dependências do seu ambiente{% ifversion ghes < 3.3 or ghae %} e conhecer as vulnerabilidades dessas dependências{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %},conhecer as vulnerabilidades nessas dependências e corrigi-las{% endif %}. +You add dependencies directly to your supply chain when you specify them in a manifest file or a lockfile. Dependencies can also be included transitively, that is, even if you don’t specify a particular dependency, but a dependency of yours uses it, then you’re also dependent on that dependency. -As funcionalidades da cadeia de suprimentos em {% data variables.product.product_name %} são: -- **Grafo de dependência** -- **Revisão de dependência** -- **{% data variables.product.prodname_dependabot_alerts %} ** {% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** +{% data variables.product.product_name %} offers a range of features to help you understand the dependencies in your environment{% ifversion ghes < 3.3 or ghae %} and know about vulnerabilities in those dependencies{% endif %}{% ifversion fpt or ghec or ghes > 3.2 %}, know about vulnerabilities in those dependencies, and patch them{% endif %}. + +The supply chain features on {% data variables.product.product_name %} are: +- **Dependency graph** +- **Dependency review** +- **{% data variables.product.prodname_dependabot_alerts %} ** +{% ifversion fpt or ghec or ghes > 3.2 %}- **{% data variables.product.prodname_dependabot_updates %}** - **{% data variables.product.prodname_dependabot_security_updates %}** - - **{% data variables.product.prodname_dependabot_version_updates %}** {% endif %} + - **{% data variables.product.prodname_dependabot_version_updates %}**{% endif %} -O gráfico de dependências é fundamental para fornecer segurança da cadeia de suprimentos. O gráfico de dependências identifica todas as dependências a montante e as dependências públicas a jusante de um repositório ou pacote. É possível ver as dependências e algumas de suas propriedades, como informações de vulnerabilidade, no gráfico de dependências do repositório. +The dependency graph is central to supply chain security. The dependency graph identifies all upstream dependencies and public downstream dependents of a repository or package. You can see your repository’s dependencies and some of their properties, like vulnerability information, on the dependency graph for the repository. -As outras funcionalidades da cadeia de suprimentos em {% data variables.product.prodname_dotcom %} dependem das informações fornecidas pelo gráfico de dependências. +Other supply chain features on {% data variables.product.prodname_dotcom %} rely on the information provided by the dependency graph. -- A revisão de dependências usa o gráfico de dependências para identificar mudanças de dependências e ajuda você a entender o impacto de segurança dessas alterações ao revisar pull requests. -- O {% data variables.product.prodname_dependabot %} faz a referência cruzada dos dados de dependência fornecidos pelo grafo de dependência com a lista de avisos publicadas no {% data variables.product.prodname_advisory_database %}, verifica as dependências e gera {% data variables.product.prodname_dependabot_alerts %} quando é detectada uma possível vulnerabilidade {% ifversion GH-advisory-db-supports-malware %}ou malware{% endif %}. -{% ifversion fpt or ghec or ghes > 3.2 %}– As {% data variables.product.prodname_dependabot_security_updates %} usam o grafo de dependência e os {% data variables.product.prodname_dependabot_alerts %} para ajudar você a atualizar as dependências com vulnerabilidades conhecidas no seu repositório. +- Dependency review uses the dependency graph to identify dependency changes and help you understand the security impact of these changes when you review pull requests. +- {% data variables.product.prodname_dependabot %} cross-references dependency data provided by the dependency graph with the list of advisories published in the {% data variables.product.prodname_advisory_database %}, scans your dependencies and generates {% data variables.product.prodname_dependabot_alerts %} when a potential vulnerability {% ifversion GH-advisory-db-supports-malware %}or malware{% endif %} is detected. +{% ifversion fpt or ghec or ghes > 3.2 %}- {% data variables.product.prodname_dependabot_security_updates %} use the dependency graph and {% data variables.product.prodname_dependabot_alerts %} to help you update dependencies with known vulnerabilities in your repository. -{% data variables.product.prodname_dependabot_version_updates %} não usa o gráfico de dependências e confia na versão semântica das dependências. {% data variables.product.prodname_dependabot_version_updates %} ajuda você a manter suas dependências atualizadas, mesmo quando elas não têm nenhuma vulnerabilidade. +{% data variables.product.prodname_dependabot_version_updates %} don't use the dependency graph and rely on the semantic versioning of dependencies instead. {% data variables.product.prodname_dependabot_version_updates %} help you keep your dependencies updated, even when they don’t have any vulnerabilities. {% endif %} -{% ifversion fpt or ghec or ghes %} Para obter guias de melhores práticas sobre a segurança da cadeia de suprimentos de ponta a ponta, incluindo a proteção de contas pessoais, códigos e processos de build, confira "[Como proteger sua cadeia de suprimentos de ponta a ponta](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)". +{% ifversion fpt or ghec or ghes %} +For best practice guides on end-to-end supply chain security including the protection of personal accounts, code, and build processes, see "[Securing your end-to-end supply chain](/code-security/supply-chain-security/end-to-end-supply-chain/end-to-end-supply-chain-overview)." {% endif %} -## Visão geral do recurso +## Feature overview -### Qual é o gráfico de dependências +### What is the dependency graph -Para gerar o gráfico de dependência, {% data variables.product.company_short %} analisa as dependências explícitas de um repositório declaradas no manifesto e no arquivo de bloqueio. Quando habilitado, o gráfico de dependências analisa automaticamente todos os arquivos de manifesto de pacote conhecidos no repositório, e usa isto para construir um gráfico com nomes e versões conhecidas das dependências. +To generate the dependency graph, {% data variables.product.company_short %} looks at a repository’s explicit dependencies declared in the manifest and lockfiles. When enabled, the dependency graph automatically parses all known package manifest files in the repository, and uses this to construct a graph with known dependency names and versions. -- O grafo de dependência inclui informações sobre as dependências _diretas_ e as dependências _transitivas_. -- O gráfico de dependência é atualizado automaticamente quando você faz push de um commit para {% data variables.product.company_short %} que altera ou adiciona um manifesto compatível ou um arquivo de bloqueio para o branch padrão, e quando alguém fizer uma alteração no repositório de uma de suas dependências. -- Veja o grafo de dependência abrindo a página principal do repositório no {% data variables.product.product_name %} e acessando a guia **Insights**. +- The dependency graph includes information on your _direct_ dependencies and _transitive_ dependencies. +- The dependency graph is automatically updated when you push a commit to {% data variables.product.company_short %} that changes or adds a supported manifest or lock file to the default branch, and when anyone pushes a change to the repository of one of your dependencies. +- You can see the dependency graph by opening the repository's main page on {% data variables.product.product_name %}, and navigating to the **Insights** tab. -{% ifversion dependency-submission-api %} {% data reusables.dependency-submission.dependency-submission-link %} {% endif %} - -Para obter mais informações sobre o grafo de dependência, confira "[Sobre o grafo de dependência](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)". - -### O que é revisão de dependências - -A revisão de dependências ajuda os revisores e colaboradores a entenderem as mudanças de dependência e seu impacto de segurança em cada pull request. - -- A revisão de dependências informa quais dependências foram adicionadas, removidas ou atualizadas em um pull request. Você pode usar as datas de versão, a popularidade das dependências e informações de vulnerabilidade para ajudar você a decidir se deseja aceitar a alteração. -- Veja a revisão de dependência para uma solicitação de pull mostrando a comparação avançada na guia **Arquivos Alterados**. - -Para obter mais informações sobre a revisão de dependência, confira "[Sobre a revisão de dependência](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)". - -### O que é o Dependabot - -O {% data variables.product.prodname_dependabot %} mantém as dependências atualizadas informando você de qualquer vulnerabilidade de segurança nas dependências{% ifversion fpt or ghec or ghes > 3.2 or ghae %} e abre automaticamente as solicitações de pull para atualizar as dependências para a próxima versão segura disponível quando um alerta do {% data variables.product.prodname_dependabot %} for disparado ou para a última versão quando uma versão for publicada{% else %}, de modo que você possa atualizar essa dependência{% endif %}. - -{% ifversion fpt or ghec or ghes > 3.2 %} O termo "{% data variables.product.prodname_dependabot %}" engloba os seguintes recursos: -- {% data variables.product.prodname_dependabot_alerts %} – Notificação exibida na guia **Segurança** do repositório e no grafo de dependência 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_dependabot_updates %}: - - {% data variables.product.prodname_dependabot_security_updates %}—Atualizações acionadas para atualizar suas dependências para uma versão segura quando um alerta é acionado. - - {% data variables.product.prodname_dependabot_version_updates %}— Atualizações agendadas para manter suas dependências atualizadas com a versão mais recente. +{% ifversion dependency-submission-api %} +{% data reusables.dependency-submission.dependency-submission-link %} {% endif %} -#### Quais são os alertas do Dependabot +For more information about the dependency graph, see "[About the dependency graph](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph)." -O {% data variables.product.prodname_dependabot_alerts %} destaca os repositórios afetados por uma vulnerabilidade recém-descoberta com base no grafo de dependência e no {% data variables.product.prodname_advisory_database %}, que contém os avisos de vulnerabilidades conhecidas {% ifversion GH-advisory-db-supports-malware %} e malwares{% endif %}. +### What is dependency review -- O {% data variables.product.prodname_dependabot %} faz a verificação para detectar dependências não seguras e envia {% data variables.product.prodname_dependabot_alerts %} quando: {% ifversion fpt or ghec %} - - Um novo aviso é adicionado ao {% data variables.product.prodname_advisory_database %}.{% else %} - - Novos dados de consultoria são sincronizados com a {% data variables.product.product_location %} a cada hora por meio do {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} - - O gráfico de dependências para as alterações no repositório. -- Os {% data variables.product.prodname_dependabot_alerts %} são exibidos {% ifversion fpt or ghec or ghes %} na guia **Segurança** do repositório e{% endif %} no grafo de dependência do repositório. O alerta inclui {% ifversion fpt or ghec or ghes %}um link para o arquivo afetado no projeto e {% endif %}informações sobre uma versão corrigida. +Dependency review helps reviewers and contributors understand dependency changes and their security impact in every pull request. -Para obter mais informações, confira "[Sobre os {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)". +- Dependency review tells you which dependencies were added, removed, or updated, in a pull request. You can use the release dates, popularity of dependencies, and vulnerability information to help you decide whether to accept the change. +- You can see the dependency review for a pull request by showing the rich diff on the **Files Changed** tab. + +For more information about dependency review, see "[About dependency review](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review)." + +### What is Dependabot + +{% data variables.product.prodname_dependabot %} keeps your dependencies up to date by informing you of any security vulnerabilities in your dependencies{% ifversion fpt or ghec or ghes > 3.2 %}, and automatically opens pull requests to upgrade your dependencies to the next available secure version when a {% data variables.product.prodname_dependabot %} alert is triggered, or to the latest version when a release is published{% else %} so that you can update that dependency{% endif %}. {% ifversion fpt or ghec or ghes > 3.2 %} -#### Quais são as atualizações do Dependabot +The term "{% data variables.product.prodname_dependabot %}" encompasses the following features: +- {% data variables.product.prodname_dependabot_alerts %}—Displayed notification on the **Security** tab for the repository, and in the repository's dependency graph. The alert includes a link to the affected file in the project, and information about a fixed version. +- {% data variables.product.prodname_dependabot_updates %}: + - {% data variables.product.prodname_dependabot_security_updates %}—Triggered updates to upgrade your dependencies to a secure version when an alert is triggered. + - {% data variables.product.prodname_dependabot_version_updates %}—Scheduled updates to keep your dependencies up to date with the latest version. -Há dois tipos de {% data variables.product.prodname_dependabot_updates %}: atualizações de _segurança_ e atualizações de _versão_ do {% data variables.product.prodname_dependabot %}. {% data variables.product.prodname_dependabot %} gera pull requests automáticos para atualizar suas dependências em ambos os casos, mas existem várias diferenças. - -{% data variables.product.prodname_dependabot_security_updates %}: - - Acionado por um alerta de {% data variables.product.prodname_dependabot %} - - Atualizar dependências para a versão mínima que resolve uma vulnerabilidade conhecida - - Compatível para os ecossistemas que o gráfico de dependências suporta - - Não requer um arquivo de configuração, mas você pode usar um para substituir o comportamento padrão - -{% data variables.product.prodname_dependabot_version_updates %}: - - Requer um arquivo de configuração - - Executar em um calendário que você configura - - Atualizar dependências para a última versão que corresponde à configuração - - Compatível para um grupo diferente de ecossistemas - -Para obter mais informações sobre as {% data variables.product.prodname_dependabot_updates %}, confira "[Sobre as {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)" e "[Sobre as {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)". {% endif %} -## Disponibilidade de recursos - {% ifversion fpt or ghec %} -Repositórios públicos: -- **Grafo de dependência** – habilitado por padrão, não podendo ser desabilitado. -- **Revisão de dependência** – habilitada por padrão, não podendo ser desabilitada. -- **{% data variables.product.prodname_dependabot_alerts %}** : não habilitado por padrão. O {% data variables.product.prodname_dotcom %} detecta dependências não seguras e exibe informações no grafo de dependência, mas não gera {% data variables.product.prodname_dependabot_alerts %} por padrão. Os proprietários do repositório ou pessoas com acesso de administrador podem habilitar {% data variables.product.prodname_dependabot_alerts %}. - Você também pode habilitar ou desabilitar alertas do Dependabot para todos os repositórios pertencentes à sua conta de usuário ou organização. Para obter mais informações, confira "[Como gerenciar as configurações de segurança e análise da sua conta de usuário](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" ou "[Como gerenciar as configurações de segurança e análise da sua organização](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)". +{% data variables.product.prodname_dependabot_alerts %}, {% data variables.product.prodname_dependabot_security_updates %}, and {% data variables.product.prodname_dependabot_version_updates %} do not use {% data variables.product.prodname_actions %} when they run on {% data variables.product.product_name %}. However, pull requests opened by {% data variables.product.prodname_dependabot %} can trigger workflows that run actions. For more information, see "[Automating {% data variables.product.prodname_dependabot %} with {% data variables.product.prodname_actions %}](/code-security/dependabot/working-with-dependabot/automating-dependabot-with-github-actions)." -Repositórios privados: -- **Grafo de dependência** – não habilitado por padrão. O recurso pode ser habilitado pelos administradores do repositório. Para obter mais informações, confira "[Como explorar as dependências de um repositório](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". +{% elsif ghes %} + +{% data variables.product.prodname_dependabot_security_updates %} and {% data variables.product.prodname_dependabot_version_updates %} require {% data variables.product.prodname_actions %} to run on {% data variables.product.product_name %}. {% data variables.product.prodname_dependabot_alerts %} do not require {% data variables.product.prodname_actions %}. For more information, see "[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." + +{% elsif ghae %} + +{% data variables.product.prodname_actions %} is not required for {% data variables.product.prodname_dependabot_alerts %} to run on {% data variables.product.product_name %}. + +{% endif %} + +#### What are Dependabot alerts + +{% data variables.product.prodname_dependabot_alerts %} highlight repositories affected by a newly discovered vulnerability based on the dependency graph and the {% data variables.product.prodname_advisory_database %}, which contains advisories for known vulnerabilities{% ifversion GH-advisory-db-supports-malware %} and malware{% endif %}. + +- {% data variables.product.prodname_dependabot %} performs a scan to detect insecure dependencies and sends {% data variables.product.prodname_dependabot_alerts %} when: +{% ifversion fpt or ghec %} + - A new advisory is added to the {% data variables.product.prodname_advisory_database %}.{% else %} + - New advisory data is synchronized to {% data variables.product.product_location %} each hour from {% data variables.product.prodname_dotcom_the_website %}. {% data reusables.security-advisory.link-browsing-advisory-db %}{% endif %} + - The dependency graph for the repository changes. +- {% data variables.product.prodname_dependabot_alerts %} are displayed {% ifversion fpt or ghec or ghes %} on the **Security** tab for the repository and{% endif %} in the repository's dependency graph. The alert includes {% ifversion fpt or ghec or ghes %}a link to the affected file in the project, and {% endif %}information about a fixed version. + +For more information, see "[About {% data variables.product.prodname_dependabot_alerts %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-alerts-for-vulnerable-dependencies)." + +{% ifversion fpt or ghec or ghes > 3.2 %} +#### What are Dependabot updates + +There are two types of {% data variables.product.prodname_dependabot_updates %}: {% data variables.product.prodname_dependabot %} _security_ updates and _version_ updates. {% data variables.product.prodname_dependabot %} generates automatic pull requests to update your dependencies in both cases, but there are several differences. + +{% data variables.product.prodname_dependabot_security_updates %}: + - Triggered by a {% data variables.product.prodname_dependabot %} alert + - Update dependencies to the minimum version that resolves a known vulnerability + - Supported for ecosystems the dependency graph supports + - Does not require a configuration file, but you can use one to override the default behavior + +{% data variables.product.prodname_dependabot_version_updates %}: + - Requires a configuration file + - Run on a schedule you configure + - Update dependencies to the latest version that matches the configuration + - Supported for a different group of ecosystems + +For more information about {% data variables.product.prodname_dependabot_updates %}, see "[About {% data variables.product.prodname_dependabot_security_updates %}](/code-security/supply-chain-security/managing-vulnerabilities-in-your-projects-dependencies/about-dependabot-security-updates)" and "[About {% data variables.product.prodname_dependabot_version_updates %}](/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)." +{% endif %} + +## Feature availability + +{% ifversion fpt or ghec %} + +Public repositories: +- **Dependency graph**—enabled by default and cannot be disabled. +- **Dependency review**—enabled by default and cannot be disabled. +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. {% data variables.product.prodname_dotcom %} detects insecure dependencies and displays information in the dependency graph, but does not generate {% data variables.product.prodname_dependabot_alerts %} by default. Repository owners or people with admin access can enable {% data variables.product.prodname_dependabot_alerts %}. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." + +Private repositories: +- **Dependency graph**—not enabled by default. The feature can be enabled by repository administrators. For more information, see "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." {% ifversion fpt %} -- **Revisão de dependência** – disponível em repositórios privados pertencentes a organizações que usam o {% data variables.product.prodname_ghe_cloud %} e têm uma licença do {% data variables.product.prodname_GH_advanced_security %}. Para obter mais informações, confira a [documentação do {% data variables.product.prodname_ghe_cloud %}](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). +- **Dependency review**—available in private repositories owned by organizations that use {% data variables.product.prodname_ghe_cloud %} and have a license for {% data variables.product.prodname_GH_advanced_security %}. For more information, see the [{% data variables.product.prodname_ghe_cloud %} documentation](/enterprise-cloud@latest/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review). {% elsif ghec %} -- **Revisão de dependência** – disponível em repositórios privados pertencentes a organizações, desde que você tenha uma licença do {% data variables.product.prodname_GH_advanced_security %} e o grafo de dependência habilitado. Para obter mais informações, confira "[Sobre o {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)" e "[Como explorar as dependências de um repositório](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)". {% endif %} -- **{% data variables.product.prodname_dependabot_alerts %}** : não habilitado por padrão. Os proprietários de repositórios privados ou pessoas com acesso de administrador, podem habilitar o {% data variables.product.prodname_dependabot_alerts %} ativando o gráfico de dependências e {% data variables.product.prodname_dependabot_alerts %} para seus repositórios. - Você também pode habilitar ou desabilitar alertas do Dependabot para todos os repositórios pertencentes à sua conta de usuário ou organização. Para obter mais informações, confira "[Como gerenciar as configurações de segurança e análise da sua conta de usuário](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" ou "[Como gerenciar as configurações de segurança e análise da sua organização](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)". +- **Dependency review**—available in private repositories owned by organizations provided you have a license for {% data variables.product.prodname_GH_advanced_security %} and the dependency graph enabled. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)" and "[Exploring the dependencies of a repository](/code-security/supply-chain-security/understanding-your-software-supply-chain/exploring-the-dependencies-of-a-repository#enabling-and-disabling-the-dependency-graph-for-a-private-repository)." +{% endif %} +- **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Owners of private repositories, or people with admin access, can enable {% data variables.product.prodname_dependabot_alerts %} by enabling the dependency graph and {% data variables.product.prodname_dependabot_alerts %} for their repositories. + You can also enable or disable Dependabot alerts for all repositories owned by your user account or organization. For more information, see "[Managing security and analysis settings for your user account](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-personal-account-settings/managing-security-and-analysis-settings-for-your-personal-account)" or "[Managing security and analysis settings for your organization](/organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-security-and-analysis-settings-for-your-organization)." -Qualquer tipo de repositório: -- **{% data variables.product.prodname_dependabot_security_updates %}** : não habilitado por padrão. É possível habilitar o {% data variables.product.prodname_dependabot_security_updates %} para qualquer repositório que use {% data variables.product.prodname_dependabot_alerts %} e o gráfico de dependências. Para obter informações sobre como habilitar as atualizações de segurança, confira "[Como configurar as {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)". -- **{% data variables.product.prodname_dependabot_version_updates %}** : não habilitado por padrão. As pessoas com permissões de gravação em um repositório podem habilitar {% data variables.product.prodname_dependabot_version_updates %}. Para obter informações sobre como habilitar as atualizações de versão, confira "[Como configurar as {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)". +Any repository type: +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} {% ifversion ghes or ghae %} -- **Grafo de dependência** e **{% data variables.product.prodname_dependabot_alerts %}** – não habilitados por padrão. Ambas as funcionalidades são configuradas a nível empresarial pelo proprietário da empresa. Para obter mais informações, confira {% ifversion ghes %}"[Como habilitar o grafo de dependência para sua empresa](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)" e {% endif %}"[Como habilitar o {% data variables.product.prodname_dependabot %} para sua empresa](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)". -- **Revisão de dependência** – disponível quando o grafo de dependência está habilitado para a {% data variables.product.product_location %} e a {% data variables.product.prodname_advanced_security %} está habilitada para a organização ou o repositório. Para obter mais informações, confira "[Sobre o {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)". -{% endif %} {% ifversion ghes > 3.2 %} -- **{% data variables.product.prodname_dependabot_security_updates %}** : não habilitado por padrão. É possível habilitar o {% data variables.product.prodname_dependabot_security_updates %} para qualquer repositório que use {% data variables.product.prodname_dependabot_alerts %} e o gráfico de dependências. Para obter informações sobre como habilitar as atualizações de segurança, confira "[Como configurar as {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)". -- **{% data variables.product.prodname_dependabot_version_updates %}** : não habilitado por padrão. As pessoas com permissões de gravação em um repositório podem habilitar {% data variables.product.prodname_dependabot_version_updates %}. Para obter informações sobre como habilitar as atualizações de versão, confira "[Como configurar as {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)". +- **Dependency graph** and **{% data variables.product.prodname_dependabot_alerts %}**—not enabled by default. Both features are configured at an enterprise level by the enterprise owner. For more information, see {% ifversion ghes %}"[Enabling the dependency graph for your enterprise](/admin/code-security/managing-supply-chain-security-for-your-enterprise/enabling-the-dependency-graph-for-your-enterprise)" and {% endif %}"[Enabling {% data variables.product.prodname_dependabot %} for your enterprise](/admin/configuration/configuring-github-connect/enabling-dependabot-for-your-enterprise)." +- **Dependency review**—available when dependency graph is enabled for {% data variables.product.product_location %} and {% data variables.product.prodname_advanced_security %} is enabled for the organization or repository. For more information, see "[About {% data variables.product.prodname_GH_advanced_security %}](/get-started/learning-about-github/about-github-advanced-security)." +{% endif %} +{% ifversion ghes > 3.2 %} +- **{% data variables.product.prodname_dependabot_security_updates %}**—not enabled by default. 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 information about enabling security updates, see "[Configuring {% data variables.product.prodname_dependabot_security_updates %}](/code-security/dependabot/dependabot-security-updates/configuring-dependabot-security-updates)." +- **{% data variables.product.prodname_dependabot_version_updates %}**—not enabled by default. People with write permissions to a repository can enable {% data variables.product.prodname_dependabot_version_updates %}. For information about enabling version updates, see "[Configuring {% data variables.product.prodname_dependabot_version_updates %}](/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates)." {% endif %} diff --git a/translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md b/translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md index 70b27849c7..5aca361ee0 100644 --- a/translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md +++ b/translations/pt-BR/content/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace.md @@ -1,7 +1,7 @@ --- title: Changing the machine type for your codespace shortTitle: Change the machine type -intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for work you''re doing.' +intro: 'You can change the type of machine that''s running your codespace, so that you''re using resources appropriate for the work you''re doing.' product: '{% data reusables.gated-features.codespaces %}' versions: fpt: '*' @@ -23,9 +23,17 @@ type: how_to {% data reusables.codespaces.codespaces-machine-types %} You can choose an alternative machine type either when you create a codespace or at any time after you've created a codespace. -For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." For information on changing the machine type within {% data variables.product.prodname_vscode %}, see "[Using {% data variables.product.prodname_github_codespaces %} in {% data variables.product.prodname_vscode %}](/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code#changing-the-machine-type-in-visual-studio-code)." +For information on choosing a machine type when you create a codespace, see "[Creating a codespace](/codespaces/developing-in-codespaces/creating-a-codespace#creating-a-codespace)." -## Changing the machine type in {% data variables.product.prodname_dotcom %} +## Changing the machine type + +{% note %} + +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} + +{% endnote %} + +{% webui %} {% data reusables.codespaces.your-codespaces-procedure-step %} @@ -37,33 +45,64 @@ For information on choosing a machine type when you create a codespace, see "[Cr 1. Click **Change machine type**. !['Change machine type' menu option](/assets/images/help/codespaces/change-machine-type-menu-option.png) - 1. If multiple machine types are available for your codespace, choose the type of machine you want to use. ![Dialog box showing available machine types to choose](/assets/images/help/codespaces/change-machine-type-choice.png) +1. Click **Update codespace**. - {% note %} +{% endwebui %} - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} +{% vscode %} - {% endnote %} +{% data reusables.codespaces.changing-machine-type-in-vscode %} -2. Click **Update codespace**. +{% endvscode %} - The change will take effect the next time your codespace restarts. +{% cli %} -## Force an immediate update of a currently running codespace +You can use the `gh codespace edit --machine MACHINE-TYPE-NAME` {% data variables.product.prodname_cli %} command to change the machine type of a codespace. To use this command, you'll first need to find out the available machine types for your codespace. -If you change the machine type of a codespace you are currently using, and you want to apply the changes immediately, you can force the codespace to restart. +1. To view your list of codespaces, in a terminal, enter the following command. + + ``` + gh codespace list + ``` +1. Optionally, to find the current machine type for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME + ``` -1. At the bottom left of your codespace window, click **{% data variables.product.prodname_codespaces %}**. + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. The permanent names are listed under the **NAME** column in the list returned by `gh codespace list`. - ![Click '{% data variables.product.prodname_codespaces %}'](/assets/images/help/codespaces/codespaces-button.png) + If you're prompted to request the `codespace` scope, follow the instructions in the terminal. -1. From the options that are displayed at the top of the page select **Codespaces: Stop Current Codespace**. + Details for the current machine are listed under the `machine` field. +1. To find the available machine types for a codespace, enter the following command. + + ``` + gh api /user/codespaces/CODESPACE-NAME/machines + ``` - !['Suspend Current Codespace' option](/assets/images/help/codespaces/suspend-current-codespace.png) + Replace `CODESPACE-NAME` with the permanent name of the codespace, for example `octocat-myrepo-gmc7`. +1. To change the machine type for a codespace, enter the following command. -1. After the codespace is stopped, click **Restart codespace**. + ``` + gh codespace edit --machine MACHINE-TYPE-NAME + ``` - ![Click 'Resume'](/assets/images/help/codespaces/resume-codespace.png) + Replace `MACHINE-TYPE-NAME` with the name of an available machine type for your codespace, for example `standardLinux32gb`. +1. Using the arrow keys, navigate to the codespace you want to change, then press Enter. + +{% endcli %} + +{% data reusables.codespaces.about-changing-storage-size %} + +{% cli %} + +## Further reading + +- "[Codespaces machines](/rest/codespaces/machines)" in the REST API documentation +- [`gh codespace edit`](https://cli.github.com/manual/gh_codespace_edit) in the {% data variables.product.prodname_cli %} manual + +{% endcli %} \ No newline at end of file diff --git a/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md b/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md index 349ed58b1a..1f866ccdd6 100644 --- a/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md +++ b/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-in-visual-studio-code.md @@ -78,28 +78,15 @@ Use the {% data variables.product.prodname_vscode_marketplace %} to install the {% data reusables.codespaces.codespaces-machine-types %} You can change the machine type of your codespace at any time. -1. In {% data variables.product.prodname_vscode_shortname %}, open the Command Palette (`shift command P` / `shift control P`). -1. Search for and select "Codespaces: Change Machine Type." +{% note %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-type-option.png) +**Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} -1. Click the codespace that you want to change. +{% endnote %} - ![Searching for a branch to create a new {% data variables.product.prodname_codespaces %}](/assets/images/help/codespaces/vscode-change-machine-choose-repo.png) +{% data reusables.codespaces.changing-machine-type-in-vscode %} -1. Choose the machine type you want to use. - - {% note %} - - **Note**: {% data reusables.codespaces.codespaces-machine-type-availability %} - - {% endnote %} - -1. If the codespace is currently running, a message is displayed asking if you would like to restart and reconnect to your codespace now. - - Click **Yes** if you want to change the machine type used for this codespace immediately. - - If you click **No**, or if the codespace is not currently running, the change will take effect the next time the codespace restarts. +{% data reusables.codespaces.about-changing-storage-size %} ## Deleting a codespace in {% data variables.product.prodname_vscode_shortname %} diff --git a/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md b/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md index 36f08bad58..0a582c1557 100644 --- a/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md +++ b/translations/pt-BR/content/codespaces/developing-in-codespaces/using-github-codespaces-with-github-cli.md @@ -31,6 +31,7 @@ You can work with {% data variables.product.prodname_github_codespaces %} in the - [Modify ports in a codespace](#modify-ports-in-a-codespace) - [Access codespace logs](#access-codespace-logs) - [Access remote resources](#access-remote-resources) + - [Change the machine type of a codespace](#change-the-machine-type-of-a-codespace) ## Installing {% data variables.product.prodname_cli %} @@ -206,4 +207,12 @@ You can use the {% data variables.product.prodname_cli %} extension to create a **Note**: The {% data variables.product.prodname_cli %} extension is currently in beta and subject to change. -{% endnote %} \ No newline at end of file +{% endnote %} + +### Change the machine type of a codespace + +```shell +gh codespace edit -m machine-type-name +``` + +For more information, see the "{% data variables.product.prodname_cli %}" tab of "[Changing the machine type for your codespace](/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace)." \ No newline at end of file diff --git a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md index a5f1df5902..784262db66 100644 --- a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md +++ b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-a-jetbrains-ide.md @@ -1,121 +1,121 @@ --- -title: Introdução ao GitHub Copilot em um IDE JetBrains +title: Getting started with GitHub Copilot in a JetBrains IDE shortTitle: JetBrains IDE -intro: 'Saiba como instalar o {% data variables.product.prodname_copilot %} em um IDE JetBrains e começar a ver sugestões enquanto você escreve comentários e código.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in a JetBrains IDE, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: e031d6155f4dacf9987bee21ff80eada0e079d97 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147110326' --- -## Sobre o {% data variables.product.prodname_copilot %} e IDEs JetBrains + +## About {% data variables.product.prodname_copilot %} and JetBrains IDEs {% data reusables.copilot.procedural-intro %} -Se você usar um IDE JetBrains, poderá exibir e incorporar sugestões do {% data variables.product.prodname_copilot %} diretamente no editor. Este guia demonstra como usar o {% data variables.product.prodname_copilot %} dentro de um IDE JetBrains para macOS, Windows ou Linux. +If you use a JetBrains IDE, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within a JetBrains IDE for macOS, Windows, or Linux. -## Pré-requisitos +## Prerequisites {% data reusables.copilot.jetbrains-ides %} -## Como instalar a extensão JetBrains +## Installing the JetBrains extension -Para usar o {% data variables.product.prodname_copilot %} em um IDE JetBrains, você deverá instalar a extensão do {% data variables.product.prodname_copilot %}. O procedimento a seguir guiará você pela instalação do plug-in do {% data variables.product.prodname_copilot %} no IntelliJ IDEA. As etapas para instalar o plug-in em outro IDE com suporte podem ser diferentes. +To use {% data variables.product.prodname_copilot %} in a JetBrains IDE, you must install the {% data variables.product.prodname_copilot %} extension. The following procedure will guide you through installation of the {% data variables.product.prodname_copilot %} plugin in IntelliJ IDEA. Steps to install the plugin in another supported IDE may differ. -1. No IDE JetBrains, no menu **Arquivo** do Windows, ou sob o nome do IDE para Mac (por exemplo, **PyCharm** ou **IntelliJ**), clique em **Configurações** para o Windows ou em **Preferências** para o Mac. -2. No menu esquerdo da caixa de diálogo **Configurações/Preferências**, clique em **Plug-ins**. -3. Na parte superior da caixa de diálogo **Configurações/Preferências**, clique em **Marketplace**. Na barra de pesquisa, pesquise **{% data variables.product.prodname_copilot %}** e clique em **Instalar**. - ![Captura de tela da pesquisa do Marketplace](/assets/images/help/copilot/jetbrains-marketplace.png) -1. Depois que o {% data variables.product.prodname_copilot %} estiver instalado, clique em **Reiniciar IDE**. -1. Depois que o IDE JetBrains for reiniciado, clique no menu **Ferramentas**. Clique em **{% data variables.product.prodname_copilot %}** e clique **Logon no {% data variables.product.prodname_dotcom %}** . - ![Captura de tela do menu de ferramentas do JetBrains](/assets/images/help/copilot/jetbrains-tools-menu.png) -1. Na caixa de diálogo "Entrar no {% data variables.product.prodname_dotcom %}", para copiar o código do dispositivo e abrir a janela de ativação do dispositivo, clique em **Copiar e Abrir**. - ![Captura de tela da cópia e abertura do código do dispositivo](/assets/images/help/copilot/device-code-copy-and-open.png) -1. Uma janela de ativação do dispositivo será aberta no navegador. Cole o código do dispositivo e clique em **Continuar**. +1. In your JetBrains IDE, under the **File** menu for Windows or under the name of your IDE for Mac (for example, **PyCharm** or **IntelliJ**), click **Settings** for Windows or **Preferences** for Mac. +2. In the left-side menu of the **Settings/Preferences** dialog box, click **Plugins**. +3. At the top of the **Settings/Preferences** dialog box, click **Marketplace**. In the search bar, search for **{% data variables.product.prodname_copilot %}**, then click **Install**. + ![Screenshot of Marketplace search](/assets/images/help/copilot/jetbrains-marketplace.png) +1. After {% data variables.product.prodname_copilot %} is installed, click **Restart IDE**. +1. After your JetBrains IDE has restarted, click the **Tools** menu. Click **{% data variables.product.prodname_copilot %}**, then click **Login to {% data variables.product.prodname_dotcom %}**. + ![Screenshot of JetBrains tools menu](/assets/images/help/copilot/jetbrains-tools-menu.png) +1. In the "Sign in to {% data variables.product.prodname_dotcom %}" dialog box, to copy the device code and open the device activation window, click **Copy and Open**. + ![Screenshot of device code copy and open](/assets/images/help/copilot/device-code-copy-and-open.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Para colar o código no Windows ou Linux, pressione Ctrl+v. - - Pra colar o código no macOS, pressione comando+v. -1. O {% data variables.product.prodname_dotcom %} solicitará as permissões necessárias para o {% data variables.product.prodname_copilot %}. Para aprovar essas permissões, clique em **Autorizar o plug-in do {% data variables.product.prodname_copilot %}** . -1. Depois que as permissões forem aprovadas, o IDE JetBrains mostrará uma confirmação. Para começar a usar o {% data variables.product.prodname_copilot %}, clique em **OK**. - ![Captura de tela da confirmação de permissões do IDE JetBrains](/assets/images/help/copilot/jetbrains-ide-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After the permissions have been approved, your JetBrains IDE will show a confirmation. To begin using {% data variables.product.prodname_copilot %}, click **OK**. + ![Screenshot of JetBrains IDE permissions confirmation](/assets/images/help/copilot/jetbrains-ide-confirmation.png) -## Como ver a primeira sugestão +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} Os exemplos a seguir estão em Java, mas outras linguagens funcionarão da mesma forma. +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in Java, but other languages will work similarly. {% data reusables.copilot.create-java-file %} -1. No arquivo Java, crie uma classe digitando `class Test`. - O {% data variables.product.prodname_copilot %} sugerirá automaticamente um corpo de classe em texto esmaecido, conforme mostrado abaixo. A sugestão exata pode variar. - ![Captura de tela da sugestão do corpo da classe Java](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} -1. Para solicitar que o {% data variables.product.prodname_copilot %} sugira um corpo de função, digite a linha a seguir abaixo do colchete da função `main`. A sugestão exata pode variar. +1. In the Java file, create a class by typing `class Test`. + {% data variables.product.prodname_copilot %} will automatically suggest a class body in grayed text, as shown below. The exact suggestion may vary. + ![Screenshot of the Java class body suggestion](/assets/images/help/copilot/java-class-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} +1. To prompt {% data variables.product.prodname_copilot %} to suggest a function body, type the following line below the bracket of the `main` function. The exact suggestion may vary. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} - ![Captura de tela da sugestão do corpo da função Java](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/java-function-body-suggestion-jetbrains.png) +{% data reusables.copilot.accept-suggestion %} -O {% data variables.product.prodname_copilot %} tentará fazer a correspondência entre o contexto e o estilo do seu código. Você sempre poderá editar o código sugerido. +{% data variables.product.prodname_copilot %} will attempt to match the context and style of your code. You can always edit the suggested code. -## Como ver sugestões alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que o {% data variables.product.prodname_copilot %} mostre uma sugestão, digite a linha a seguir no arquivo Java. -{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} {% data reusables.copilot.see-alternative-suggestions %} +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. +{% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} +{% data reusables.copilot.see-alternative-suggestions %} - | Sistema operacional | Ver a próxima sugestão | Ver a sugestão anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - | macOS | Opção+] | Opção+[ | + | macOS | Option+] | Option+[ | | Windows | Alt+] | Alt+[ | | Linux | Alt+] | Alt+[ | {% data reusables.copilot.accept-or-reject-suggestion %} -## Como ver várias sugestões em uma nova guia +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que o {% data variables.product.prodname_copilot %} mostre uma sugestão, digite a linha a seguir no arquivo Java. +1. To prompt {% data variables.product.prodname_copilot %} to show you a suggestion, type the following line in the Java file. {% indented_data_reference reusables.copilot.java-int-snippet spaces=3 %} -1. Abra uma nova guia com várias sugestões adicionais. - - No macOS, pressione Command+Shift+A e clique em **Abrir o GitHub Copilot** ou pressione Command+Shift+\ para abrir a nova guia imediatamente. - - No Windows ou Linux, pressione Ctrl+Enter e clique em **Abrir o GitHub Copilot**. - ![Captura de tela do diálogo para abrir o Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) -1. Para aceitar uma sugestão, acima da sugestão, clique em **Aceitar Solução**. Para rejeitar todas as sugestões, feche a guia. +1. Open a new tab with multiple additional suggestions. + - On macOS, press Command+Shift+A, then click **Open GitHub Copilot**, or press Command+Shift+\ to open the new tab immediately. + - On Windows or Linux, press Ctrl+Enter, then click **Open GitHub Copilot**. + ![Screenshot of dialogue to open Copilot](/assets/images/help/copilot/open-copilot-tab-jetbrains.png) +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Como gerar sugestões de código por meio de comentários +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-java-file %} -1. Para solicitar que o {% data variables.product.prodname_copilot %} sugira uma implementação de uma função no arquivo Java, digite as linhas a seguir. +1. To prompt {% data variables.product.prodname_copilot %} to suggest an implementation of a function in the Java file, type the following lines. ```java{:copy} // find all images without alternate text // and give them a red border void process () { ``` - ![Captura de tela da sugestão do corpo da função Java](/assets/images/help/copilot/comment-suggestion-jetbrains.png) + ![Screenshot of the Java function body suggestion](/assets/images/help/copilot/comment-suggestion-jetbrains.png) -## Como habilitar e desabilitar o {% data variables.product.prodname_copilot %} +## Enabling and disabling {% data variables.product.prodname_copilot %} -Você pode habilitar ou desabilitar o {% data variables.product.prodname_copilot %} para todas as linguagens ou para linguagens individuais. O ícone de status do {% data variables.product.prodname_copilot %} no painel inferior da janela do IDE JetBrains indica se o {% data variables.product.prodname_copilot %} está habilitado ou desabilitado. Quando habilitado, o ícone fica realçado. Quando desabilitado, o ícone fica esmaecido. +You can enable or disable {% data variables.product.prodname_copilot %} for all languages, or for individual languages. The {% data variables.product.prodname_copilot %} status icon in the bottom panel of your JetBrains IDE window indicates whether {% data variables.product.prodname_copilot %} is enabled or disabled. When enabled, the icon is highlighted. When disabled, the icon is grayed out. -1. Para habilitar ou desabilitar o {% data variables.product.prodname_copilot %}, clique no ícone de status no painel inferior da janela JetBrains. - ![Captura de tela do ícone de status no IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) -2. Se você estiver desabilitando o {% data variables.product.prodname_copilot %}, será perguntado se deseja desabilitá-lo globalmente ou para a linguagem do arquivo que está editando no momento. +1. To enable or disable {% data variables.product.prodname_copilot %}, click the status icon in the bottom panel of the JetBrains window. + ![Screenshot of the status icon in IntelliJ IDEA](/assets/images/help/copilot/status-icon-jetbrains.png) +2. If you are disabling {% data variables.product.prodname_copilot %}, you will be asked whether you want to disable it globally, or for the language of the file you are currently editing. - - Para desabilitar as sugestões do {% data variables.product.prodname_copilot %} globalmente, clique em **Desabilitar Preenchimentos**. - - Para desabilitar as sugestões do {% data variables.product.prodname_copilot %} para a linguagem especificada, clique em **Desabilitar Preenchimentos para _LINGUAGEM_**. - ![Captura de tela da opção para desabilitar o {% data variables.product.prodname_copilot %} globalmente ou para a linguagem atual](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) + - To disable suggestions from {% data variables.product.prodname_copilot %} globally, click **Disable Completions**. + - To disable suggestions from {% data variables.product.prodname_copilot %} for the specified language, click **Disable Completions for _LANGUAGE_**. + ![Screenshot of option to disable {% data variables.product.prodname_copilot %} globally or for the current language](/assets/images/help/copilot/disable-copilot-global-or-langugage-jetbrains.png) -## Leitura adicional +## Further reading -- [O site do {% data variables.product.prodname_copilot %}](https://copilot.github.com/) -- [Sobre o {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) +- [The {% data variables.product.prodname_copilot %} website](https://copilot.github.com/) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot#about-the-license-for-the-github-copilot-plugin-in-jetbrains-ides) diff --git a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md index 98087019cf..75694b710b 100644 --- a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md +++ b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio-code.md @@ -1,105 +1,103 @@ --- -title: Introdução ao GitHub Copilot no Visual Studio Code +title: Getting started with GitHub Copilot in Visual Studio Code shortTitle: Visual Studio Code -intro: 'Saiba como instalar o {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vscode %},e passar a ver sugestões enquanto escreve comentários e códigos.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, and start seeing suggestions as you write comments and code.' product: '{% data reusables.gated-features.copilot %}' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 854d489eaa90690dd670fb01068fe0166c134afb -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147079476' --- -## Sobre o {% data variables.product.prodname_copilot %} e o {% data variables.product.prodname_vscode %} + +## About {% data variables.product.prodname_copilot %} and {% data variables.product.prodname_vscode %} {% data reusables.copilot.procedural-intro %} -Usando o {% data variables.product.prodname_vscode %}, você pode ver e incorporar sugestões do {% data variables.product.prodname_copilot %} diretamente no editor. Este guia demonstra como usar o {% data variables.product.prodname_copilot %} dentro do {% data variables.product.prodname_vscode %} para macOS, Windows ou Linux. +If you use {% data variables.product.prodname_vscode %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vscode %} for macOS, Windows, or Linux. -## Pré-requisitos +## Prerequisites -Para usar o {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vscode %}, o {% data variables.product.prodname_vscode %} precisa estar instalado. Para obter mais informações, confira a [página de download do {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/Download). +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %} download page](https://code.visualstudio.com/Download). -## Como instalar a extensão {% data variables.product.prodname_vscode %} +## Installing the {% data variables.product.prodname_vscode %} extension -Para usar o {% data variables.product.prodname_copilot %}, primeiro você precisa instalar a extensão {% data variables.product.prodname_vscode %}. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. No {% data variables.product.prodname_vscode %} Marketplace, acesse a página da [extensão {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) e clique em **Instalar**. - ![Instalar a extensão {% data variables.product.prodname_vscode %} do {% data variables.product.prodname_copilot %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. Um pop-up será exibido, solicitando que você abra o {% data variables.product.prodname_vscode %}. Clique em **Abrir o {% data variables.product.prodname_vscode %}** . -1. Na guia "Extensão: {% data variables.product.prodname_copilot %}" no {% data variables.product.prodname_vscode %}, clique em **Instalar**. - ![Botão de instalação no {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. Se você ainda não tiver autorizado o {% data variables.product.prodname_vscode %} na conta do {% data variables.product.prodname_dotcom %}, será solicitado que você entre no {% data variables.product.prodname_dotcom %} no {% data variables.product.prodname_vscode %}. - - Se você já tiver autorizado o {% data variables.product.prodname_vscode %} para sua conta no {% data variables.product.prodname_dotcom %}, o {% data variables.product.prodname_copilot %} será autorizado automaticamente. - ![Captura da tela de autorização do {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. No navegador, o {% data variables.product.prodname_dotcom %} solicitará as permissões necessárias para o {% data variables.product.prodname_copilot %}. Para aprovar essas permissões, clique em **Autorizar o {% data variables.product.prodname_vscode %}** . -1. No {% data variables.product.prodname_vscode %}, na caixa de diálogo "{% data variables.product.prodname_vscode %}", para confirmar a autenticação, clique em **Abrir**. +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} for your account on {% data variables.product.prodname_dotcom %}, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialog box, to confirm the authentication, click **Open**. -## Como ver a primeira sugestão +## Seeing your first suggestion -{% data reusables.copilot.supported-languages %} Os exemplos a seguir estão em JavaScript, mas as outras linguagens funcionarão da mesma forma. +{% data reusables.copilot.code-examples-limitations %} + +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. {% data reusables.copilot.create-js-file %} -1. No arquivo JavaScript, digite o cabeçalho da função a seguir. O {% data variables.product.prodname_copilot %} vai sugerir automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` - ![Captura de tela de uma primeira sugestão {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -## Como ver sugestões alternativas +## Seeing alternative suggestions {% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-js-file %} -1. No arquivo JavaScript, digite o cabeçalho da função a seguir. {% data variables.product.prodname_copilot %} mostrará uma sugestão. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` {% data reusables.copilot.see-alternative-suggestions %} - | Sistema operacional | Ver a próxima sugestão | Ver a sugestão anterior | + | OS | See next suggestion | See previous suggestion | | :- | :- | :- | - |macOS|Opção (⌥) ou Alt+]|Opção (⌥) ou Alt+[| + |macOS|Option (⌥) or Alt+]|Option (⌥) or Alt+[| |Windows|Alt+]|Alt+[| |Linux|Alt+]|Alt+[| -1. Como alternativa, você pode focalizar a sugestão para ver a paleta de comandos do {% data variables.product.prodname_copilot %} e escolher sugestões. +1. Alternatively, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Como ver várias sugestões em uma nova guia +## Seeing multiple suggestions in a new tab {% data reusables.copilot.suggestions-new-tab %} {% data reusables.copilot.create-js-file %} -1. No arquivo JavaScript, digite o cabeçalho da função a seguir. {% data variables.product.prodname_copilot %} mostrará uma sugestão. +1. In the JavaScript file, type the following function header. {% data variables.product.prodname_copilot %} will show you a suggestion. ```javascript{:copy} function calculateDaysBetweenDates(begin, end) { ``` -1. Para abrir uma nova guia com várias opções adicionais, pressione Ctrl+Enter. -1. Para aceitar uma sugestão, acima da sugestão, clique em **Aceitar Solução**. Para rejeitar todas as sugestões, feche a guia. +1. To open a new tab with multiple additional options, press Ctrl+Enter. +1. To accept a suggestion, above the suggestion, click **Accept Solution**. To reject all suggestions, close the tab. -## Como gerar sugestões de código por meio de comentários +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-js-file %} -1. No arquivo JavaScript, digite o comentário a seguir. O {% data variables.product.prodname_copilot %} vai sugerir uma implementação da função. +1. In the JavaScript file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```javascript{:copy} // find all images without alternate text // and give them a red border function process() { ``` -## Como usar uma estrutura +## Using a framework -Você também pode usar o {% data variables.product.prodname_copilot %} para gerar sugestões de APIs e estruturas. O exemplo a seguir usa o {% data variables.product.prodname_copilot %} para criar um servidor Express simples que retorna a hora atual. +You can also use {% data variables.product.prodname_copilot %} to generate suggestions for APIs and frameworks. The following example uses {% data variables.product.prodname_copilot %} to create a simple Express server that returns the current time. {% data reusables.copilot.create-js-file %} -1. No arquivo JavaScript, digite o comentário a seguir e pressione Enter. O {% data variables.product.prodname_copilot %} vai sugerir uma implementação do aplicativo Express. +1. In the JavaScript file, type the following comment and then press Enter. {% data variables.product.prodname_copilot %} will suggest an implementation of the Express app. ```javascript{:copy} // Express server on port 3000 1. To accept each line, press Tab, then Enter. @@ -107,10 +105,10 @@ Você também pode usar o {% data variables.product.prodname_copilot %} para ger ```javascript{:copy} // Return the current time ``` -1. Para aceitar cada linha, pressione Tab. +1. To accept each line, press Tab. {% data reusables.copilot.enabling-or-disabling-in-vsc %} -## Leitura adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md index 8a5fd57430..0aaade3943 100644 --- a/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md +++ b/translations/pt-BR/content/copilot/getting-started-with-github-copilot/getting-started-with-github-copilot-in-visual-studio.md @@ -1,83 +1,82 @@ --- -title: Introdução ao GitHub Copilot no Visual Studio +title: Getting started with GitHub Copilot in Visual Studio shortTitle: Visual Studio product: '{% data reusables.gated-features.copilot %}' -intro: 'Saiba como instalar o {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vs %},e passar a ver sugestões enquanto escreve comentários e códigos.' +intro: 'Learn how to install {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, and start seeing suggestions as you write comments and code.' versions: feature: copilot topics: - Copilot -ms.openlocfilehash: 1d3c65cf1709ece9ea7b0eae9e6fadaa0df0c7f0 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147098022' --- -## Sobre o {% data variables.product.prodname_copilot %} e o Visual Studio + +## About {% data variables.product.prodname_copilot %} and Visual Studio {% data reusables.copilot.procedural-intro %} -Usando o {% data variables.product.prodname_vs %}, você pode ver e incorporar sugestões do {% data variables.product.prodname_copilot %} diretamente no editor. Este guia demonstra como usar o {% data variables.product.prodname_copilot %} dentro do {% data variables.product.prodname_vs %} para Windows. +If you use {% data variables.product.prodname_vs %}, you can view and incorporate suggestions from {% data variables.product.prodname_copilot %} directly within the editor. This guide demonstrates how to use {% data variables.product.prodname_copilot %} within {% data variables.product.prodname_vs %} for Windows. -## Pré-requisitos +## Prerequisites -Para usar o {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vs %}, você deverá ter o {% data variables.product.prodname_vs %} 2022 17.2 ou posterior instalado. Para obter mais informações, confira a documentação do [IDE do Visual Studio](https://visualstudio.microsoft.com/vs/). +To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vs %}, you must have {% data variables.product.prodname_vs %} 2022 17.2 or later installed. For more information, see the [Visual Studio IDE](https://visualstudio.microsoft.com/vs/) documentation. {% note %} -**Observação**: o {% data variables.product.prodname_copilot %} não está disponível no momento para uso com Visual Studio para Mac. +**Note**: {% data variables.product.prodname_copilot %} is not currently available for use with Visual Studio for Mac. {% endnote %} -## Como instalar a extensão {% data variables.product.prodname_vs %} +## Installing the {% data variables.product.prodname_vs %} extension -Para usar o {% data variables.product.prodname_copilot %}, você primeiro deve instalar a extensão {% data variables.product.prodname_vs %}. -1. Na barra de ferramentas do Visual Studio, clique em **Extensões** e em **Gerenciar Extensões**. - ![Captura de tela da barra de ferramentas do Visual Studio](/assets/images/help/copilot/visual-studio-toolbar.png) -1. Na janela "Gerenciar Extensões", clique no **Visual Studio Marketplace**, pesquise a extensão do {% data variables.product.prodname_copilot %} e clique em **Baixar**. - ![Captura de tela da extensão do GitHub Copilot para Visual Studio com o botão de download enfatizado](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) -1. Feche a janela "Gerenciar Extensões", saia e inicie {% data variables.product.prodname_vs %}. -1. Opcionalmente, para verificar se o {% data variables.product.prodname_copilot %} está instalado e habilitado, volte para **Gerenciar Extensões**, clique em **Instalado** para exibir suas extensões instaladas no momento e clique em **{% data variables.product.prodname_copilot %}** para ver informações de status. - ![Captura de tela das extensões instaladas no Visual Studio com o GitHub Copilot destacado](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) -1. Abra ou crie um novo projeto no {% data variables.product.prodname_vs %}. -1. Na caixa de diálogo "Microsoft {% data variables.product.prodname_vs %}", para copiar o código de ativação do dispositivo, clique em **OK**. - ![Captura de tela da caixa de diálogo Microsoft {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-auth-dialogue.png) -1. Uma janela de ativação do dispositivo será aberta no navegador. Cole o código do dispositivo e clique em **Continuar**. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vs %} extension. +1. In the Visual Studio toolbar, click **Extensions**, then click **Manage Extensions**. + ![Screenshot of the Visual Studio toolbar](/assets/images/help/copilot/visual-studio-toolbar.png) +1. In the "Manage Extensions" window, click **Visual Studio Marketplace**, search for the {% data variables.product.prodname_copilot %} extension, then click **Download**. + ![Screenshot of GitHub Copilot extension for Visual Studio with the download button emphasized](/assets/images/help/copilot/install-copilot-extension-visual-studio.png) +1. Close the "Manage Extensions" window, then exit and relaunch {% data variables.product.prodname_vs %}. +1. Optionally, to check that {% data variables.product.prodname_copilot %} is installed and enabled, go back to **Manage Extensions**, click **Installed** to view your currently installed extensions, then click **{% data variables.product.prodname_copilot %}** to see status information. + ![Screenshot of installed extensions in Visual Studio with GitHub Copilot emphasized](/assets/images/help/copilot/installed-copilot-extension-visual-studio.png) +1. Open or create a new project in {% data variables.product.prodname_vs %}. +1. In the "Microsoft {% data variables.product.prodname_vs %}" dialog box, to copy your device activation code, click **OK**. + ![Screenshot of the Microsoft {% data variables.product.prodname_vs %} dialogue box](/assets/images/help/copilot/vs-auth-dialogue.png) +1. A device activation window will open in your browser. Paste the device code, then click **Continue**. - - Para colar o código no Windows ou Linux, pressione Ctrl+v. - - Pra colar o código no macOS, pressione comando+v. -1. O {% data variables.product.prodname_dotcom %} solicitará as permissões necessárias para o {% data variables.product.prodname_copilot %}. Para aprovar essas permissões, clique em **Autorizar o plugin do {% data variables.product.prodname_copilot %}** . -1. Depois de aprovar as permissões, o {% data variables.product.prodname_vs %} mostrará uma confirmação. - ![Captura de tela da confirmação de permissões do {% data variables.product.prodname_vs %}](/assets/images/help/copilot/vs-confirmation.png) + - To paste the code in Windows or Linux, press Ctrl+v. + - To paste the code in macOS, press command+v. +1. {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_copilot %} Plugin**. +1. After you approve the permissions, {% data variables.product.prodname_vs %} will show a confirmation. + ![Screenshot of {% data variables.product.prodname_vs %} permissions confirmation](/assets/images/help/copilot/vs-confirmation.png) -## Como ver a primeira sugestão -{% data reusables.copilot.supported-languages %} Os exemplos a seguir estão em C#, mas as outras linguagens funcionarão da mesma forma. +## Seeing your first suggestion + +{% data reusables.copilot.code-examples-limitations %} +{% data reusables.copilot.supported-languages %} The following samples are in C#, but other languages will work similarly. {% data reusables.copilot.create-c-file %} -1. No arquivo #C, digite a seguinte assinatura de função. O {% data variables.product.prodname_copilot %} sugerirá automaticamente um corpo inteiro da função em texto esmaecido, como é mostrado abaixo. A sugestão exata pode variar. +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. ```csharp{:copy} int CalculateDaysBetweenDates( ``` - ![Captura de tela de uma primeira sugestão do Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) {% data reusables.copilot.accept-suggestion %} + ![Screenshot of a first suggestion Visual Studio Code](/assets/images/help/copilot/first-suggestion-visual-studio.png) +{% data reusables.copilot.accept-suggestion %} -## Como ver sugestões alternativas -{% data reusables.copilot.alternative-suggestions %} {% data reusables.copilot.create-c-file %} -1. No arquivo #C, digite a seguinte assinatura de função. {% data variables.product.prodname_copilot %} will show you a suggestion. +## Seeing alternative suggestions +{% data reusables.copilot.alternative-suggestions %} +{% data reusables.copilot.create-c-file %} +1. In the C# file, type the following function signature. {% data variables.product.prodname_copilot %} will show you a suggestion. ```csharp{:copy} int CalculateDaysBetweenDates( ``` -1. Se sugestões alternativas estiverem disponíveis, você poderá ver essas alternativas pressionando Alt+] (ou Alt+[). -1. Como opção, você pode focalizar a sugestão para ver a paleta de comandos do {% data variables.product.prodname_copilot %} e escolher sugestões. +1. If alternative suggestions are available, you can see these alternatives by pressing Alt+] (or Alt+[). +1. Optionally, you can hover over the suggestion to see the {% data variables.product.prodname_copilot %} command palette for choosing suggestions. {% data reusables.copilot.accept-or-reject-suggestion %} -## Gerar sugestões de código por meio de comentários +## Generating code suggestions from comments {% data reusables.copilot.generating-suggestions-from-comments %} {% data reusables.copilot.create-c-file %} -1. No arquivo C#, digite o comentário a seguir. O {% data variables.product.prodname_copilot %} sugerirá uma implementação da função. +1. In the C# file, type the following comment. {% data variables.product.prodname_copilot %} will suggest an implementation of the function. ```csharp{:copy} using System.Xml.Linq; @@ -90,6 +89,6 @@ Para usar o {% data variables.product.prodname_copilot %}, você primeiro deve i {% data reusables.copilot.enabling-or-disabling-vs %} -## Leitura adicional +## Further reading - [{% data variables.product.prodname_copilot %}](https://copilot.github.com/) diff --git a/translations/pt-BR/content/copilot/quickstart.md b/translations/pt-BR/content/copilot/quickstart.md index be89ce5ae5..bde85097a6 100644 --- a/translations/pt-BR/content/copilot/quickstart.md +++ b/translations/pt-BR/content/copilot/quickstart.md @@ -1,6 +1,6 @@ --- -title: Início Rápido para o GitHub Copilot -intro: 'O {% data variables.product.prodname_copilot %} pode ajudar com o seu trabalho, oferecendo sugestões embutidas à medida que você codifica.' +title: Quickstart for GitHub Copilot +intro: '{% data variables.product.prodname_copilot %} can help you work, by offering inline suggestions as you code.' product: '{% data reusables.gated-features.copilot %}' allowTitleToDifferFromFilename: true versions: @@ -8,60 +8,60 @@ versions: shortTitle: Quickstart topics: - Copilot -ms.openlocfilehash: 5aa3071cddc2bf83e7ee7082eabea00f79a66ea5 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147079506' --- -## Introdução -O {% data variables.product.prodname_copilot %} é um programador de par de IA. Você pode usar o {% data variables.product.prodname_copilot %} para obter sugestões para linhas inteiras ou funções inteiras diretamente dentro do editor. +## Introduction -Este guia mostrará como se inscrever no {% data variables.product.prodname_copilot %}, instalar a extensão {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vscode %} e obter sua primeira sugestão. Para obter informações sobre o {% data variables.product.prodname_copilot %}, confira "[Sobre o {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)". Para obter informações mais detalhadas sobre como usar o {% data variables.product.prodname_copilot %} em vários ambientes, confira "[Introdução](/copilot/getting-started-with-github-copilot)". +{% data variables.product.prodname_copilot %} is an AI pair programmer. You can use {% data variables.product.prodname_copilot %} to get suggestions for whole lines or entire functions right inside your editor. -## Pré-requisitos +This guide will show you how to sign up for {% data variables.product.prodname_copilot %}, install the {% data variables.product.prodname_copilot %} extension in {% data variables.product.prodname_vscode %}, and get your first suggestion. For more information on {% data variables.product.prodname_copilot %}, see "[About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot)." For more in-depth information on how to use {% data variables.product.prodname_copilot %} in a variety of environments, see "[Getting Started](/copilot/getting-started-with-github-copilot)." + +## Prerequisites {% data reusables.copilot.copilot-prerequisites %} -- Para usar o {% data variables.product.prodname_copilot %} no {% data variables.product.prodname_vscode %}, o {% data variables.product.prodname_vscode %} precisa estar instalado. Para obter mais informações, confira a [documentação do {% data variables.product.prodname_vscode %}](https://code.visualstudio.com/). +- To use {% data variables.product.prodname_copilot %} in {% data variables.product.prodname_vscode %}, you must have {% data variables.product.prodname_vscode %} installed. For more information, see the [{% data variables.product.prodname_vscode %}](https://code.visualstudio.com/) documentation. -## Inscrever-se no {% data variables.product.prodname_copilot %} +## Signing up for {% data variables.product.prodname_copilot %} {% data reusables.copilot.signup-procedure %} -## Instalação da extensão {% data variables.product.prodname_copilot %} do {% data variables.product.prodname_vscode %} +## Installing the {% data variables.product.prodname_copilot %} extension for {% data variables.product.prodname_vscode %} -Para usar o {% data variables.product.prodname_copilot %}, você primeiro deve instalar a extensão {% data variables.product.prodname_vscode %}. +To use {% data variables.product.prodname_copilot %}, you must first install the {% data variables.product.prodname_vscode %} extension. -1. No {% data variables.product.prodname_vscode %} Marketplace, acesse a página da [extensão {% data variables.product.prodname_copilot %}](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) e clique em **Instalar**. - ![Instalar a extensão {% data variables.product.prodname_vscode %} do {% data variables.product.prodname_copilot %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) -1. Um pop-up será exibido, solicitando que você abra o {% data variables.product.prodname_vscode %}. Clique em **Abrir o {% data variables.product.prodname_vscode %}** . -1. Na guia "Extensão: {% data variables.product.prodname_copilot %}" no {% data variables.product.prodname_vscode %}, clique em **Instalar**. - ![Botão de instalação no {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) -1. Se você ainda não tiver autorizado o {% data variables.product.prodname_vscode %} na conta do {% data variables.product.prodname_dotcom %}, será solicitado que você entre no {% data variables.product.prodname_dotcom %} no {% data variables.product.prodname_vscode %}. - - Se você já tiver autorizado o {% data variables.product.prodname_vscode %} em sua conta do {% data variables.product.prodname_dotcom %}, o {% data variables.product.prodname_copilot %} será autorizado automaticamente. - ![Captura da tela de autorização do {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/vsc-copilot-authorize.png) -1. No navegador, o {% data variables.product.prodname_dotcom %} solicitará as permissões necessárias para o {% data variables.product.prodname_copilot %}. Para aprovar essas permissões, clique em **Autorizar o {% data variables.product.prodname_vscode %}** . -1. No {% data variables.product.prodname_vscode %}, na caixa de diálogo "{% data variables.product.prodname_vscode %}", para confirmar a autenticação, clique em **Abrir**. +1. In the {% data variables.product.prodname_vscode %} Marketplace, go to the [{% data variables.product.prodname_copilot %} extension](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) page and click **Install**. + ![Install {% data variables.product.prodname_copilot %} extension {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/install-copilot-extension-visual-studio-code.png) +1. A popup will appear, asking to open {% data variables.product.prodname_vscode %}. Click **Open {% data variables.product.prodname_vscode %}**. +1. In the "Extension: {% data variables.product.prodname_copilot %}" tab in {% data variables.product.prodname_vscode %}, click **Install**. + ![Install button in {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/in-visual-studio-code-install-button.png) +1. If you have not previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, you will be prompted to sign in to {% data variables.product.prodname_dotcom %} in {% data variables.product.prodname_vscode %}. + - If you have previously authorized {% data variables.product.prodname_vscode %} in your {% data variables.product.prodname_dotcom %} account, {% data variables.product.prodname_copilot %} will be automatically authorized. + ![Screen shot of {% data variables.product.prodname_vscode %} authorization screen](/assets/images/help/copilot/vsc-copilot-authorize.png) +1. In your browser, {% data variables.product.prodname_dotcom %} will request the necessary permissions for {% data variables.product.prodname_copilot %}. To approve these permissions, click **Authorize {% data variables.product.prodname_vscode %}**. +1. In {% data variables.product.prodname_vscode %}, in the "{% data variables.product.prodname_vscode %}" dialogue box, to confirm the authentication, click **Open**. -## Obter sua primeira sugestão +## Getting your first suggestion -{% data reusables.copilot.supported-languages %} Os exemplos a seguir estão em JavaScript, mas as outras linguagens funcionarão da mesma forma. +{% data reusables.copilot.code-examples-limitations %} -1. Abra o {% data variables.product.prodname_vscode %}. -O {% data reusables.copilot.create-js-file %} {% data reusables.copilot.type-function-header %} {% data variables.product.prodname_copilot %} sugerirá automaticamente todo um corpo da função em texto esmaecido, como mostrado abaixo. A sugestão exata pode variar. -![Primeira sugestão {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) {% data reusables.copilot.accept-suggestion %} +{% data reusables.copilot.supported-languages %} The following samples are in JavaScript, but other languages will work similarly. -## Próximas etapas +1. Open {% data variables.product.prodname_vscode %}. +{% data reusables.copilot.create-js-file %} +{% data reusables.copilot.type-function-header %} + {% data variables.product.prodname_copilot %} will automatically suggest an entire function body in grayed text, as shown below. The exact suggestion may vary. + ![First suggestion {% data variables.product.prodname_vscode %}](/assets/images/help/copilot/first-suggestion-visual-studio-code.png) +{% data reusables.copilot.accept-suggestion %} -Você instalou com êxito o {% data variables.product.prodname_copilot %} e recebeu sua primeira sugestão, mas isso é apenas o começo! Confira alguns recursos úteis para dar seus próximos passos com o {% data variables.product.prodname_copilot %}. +## Next Steps -- [Introdução](/copilot/getting-started-with-github-copilot): você aprendeu a obter sua primeira sugestão no {% data variables.product.prodname_vscode %}. Esses guias mostram como configurar e navegar pelas várias funções do {% data variables.product.prodname_copilot %} em todos os ambientes com suporte. -- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): confira exemplos práticos de como o {% data variables.product.prodname_copilot %} pode ajudar você a trabalhar. -- [Configurar o {% data variables.product.prodname_copilot %}](/copilot/configuring-github-copilot): esses guias fornecem detalhes sobre como configurar o {% data variables.product.prodname_copilot %} para suas preferências pessoais. +You successfully installed {% data variables.product.prodname_copilot %} and received your first suggestion, but that's just the beginning! Here are some helpful resources for taking your next steps with {% data variables.product.prodname_copilot %}. + +- [Getting Started](/copilot/getting-started-with-github-copilot): You've learned how to get your first suggestion in {% data variables.product.prodname_vscode %}. These guides show you how to set up and navigate the various functions of {% data variables.product.prodname_copilot %} across all of the supported environments. +- [{% data variables.product.prodname_copilot %}](https://copilot.github.com/): See practical examples of how {% data variables.product.prodname_copilot %} can help you work. +- [Configuring {% data variables.product.prodname_copilot %}](/copilot/configuring-github-copilot): These guides provide details on how to configure {% data variables.product.prodname_copilot %} to your personal preferences. -## Leitura adicional +## Further reading -- [Sobre o {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) +- [About {% data variables.product.prodname_copilot %}](/copilot/overview-of-github-copilot/about-github-copilot) 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 8e4f5f1bd1..00f75ff588 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,60 +1,89 @@ --- -title: Colaboração com mantenedores usando as discussões +title: Collaborating with maintainers using discussions shortTitle: Collaborating with maintainers -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.' +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 access to a repository can start and participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can start and participate in discussions and polls in the organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions -ms.openlocfilehash: f090088d55e946e67c1f0b5d790deca9fd794a90 -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410248' --- -## Sobre colaboração com mantenedores que usam {% data variables.product.prodname_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, confira "[Sobre as discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". + +## About collaboration with maintainers using {% data variables.product.prodname_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-categories-and-formats %} {% data reusables.discussions.about-announcement-format %} -Os administradores de repositório e mantenedores de projeto podem excluir uma discussão nesse repositório. Da mesma forma, administradores e responsáveis do repositório de origem para discussões de uma organização podem excluir uma discussão nessa organização. Para obter mais informações, confira "[Gerenciar discussões](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)". +Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "[Managing discussions](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)." -{% 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, confira "[Como conceder permissões mais elevadas aos principais colaboradores](/discussions/guides/granting-higher-permissions-to-top-contributors)" +{% 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)" -![Contribuidores mais úteis para discussões para um projeto](/assets/images/help/discussions/most-helpful.png) +![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png) -Para obter mais informações sobre a participação nas discussões, confira "[Como participar de uma discussão](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)". +Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value. -## Pré-requisitos +For more information about participation in discussions, see "[Participating in a discussion](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion)." -Para colaborar com responsáveis em discussões no repositório, um administrador ou mantenedor do projeto deverá habilitar {% data variables.product.prodname_discussions %} para o repositório. Para obter mais informações, confira "[Como habilitar ou desabilitar o {% data variables.product.prodname_discussions %} para um repositório](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)". +## Prerequisites -Para colaborar com responsáveis em discussões da organização, o {% data variables.product.prodname_discussions %} deve estar habilitado para a organização. Para obter mais informações, confira "[Como habilitar ou desabilitar o {% data variables.product.prodname_discussions %} em uma organização](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)". +To collaborate with maintainers in repository discussions, a repository administrator or project maintainer must enable {% data variables.product.prodname_discussions %} for the repository. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)." -## Iniciar uma discussão +To collaborate with maintainers in organization discussions, {% data variables.product.prodname_discussions %} must be enabled for the organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Starting a discussion {% data reusables.discussions.starting-a-discussion %} -## Iniciar um poll +## Starting a poll {% data reusables.discussions.starting-a-poll %} -## Filtrar a lista de discussões +## Filtering the list of discussions -É possível pesquisar discussões e filtrar a lista de discussões em um repositório ou uma organização. Para obter mais informações, confira "[Pesquisa nas discussões](/search-github/searching-on-github/searching-discussions)". +You can search for discussions and filter the list of discussions in a repository or organization. For more information, see "[Searching discussions](/search-github/searching-on-github/searching-discussions)." -{% data reusables.discussions.navigate-to-repo-or-org %} {% data reusables.discussions.discussions-tab %} -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 pesquisa de discussões](/assets/images/help/discussions/search-result.png) +{% data reusables.discussions.navigate-to-repo-or-org %} +{% 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) -## Converter um problema em uma discussão +## Sorting the list of discussions -{% data reusables.discussions.you-can-convert-an-issue %} Para obter mais informações, confira "[Como moderar discussões](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)". +You can choose how to sort the list of discussions. -## Leitura adicional +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +1. To the right of the **Search all discussions** field, select **New**, or select **Top** and choose a time period from the drop down menu. -- "[Sobre a escrita e a formatação no {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" {%- ifversion fpt or ghec %} -- "[Como manter a sua segurança em {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)" {%- endif %} + ![Buttons for sorting discussions](/assets/images/help/discussions/sort-discussions-buttons.png) + + - Sort by **New** to display the discussions with the most recent activity at the top of the list. + - Sort by **Top** to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period. + +## Sorting top-level comments in discussions + +You can choose how to sort top-level comments in discussions. Comment threads do not impact the order comments are sorted in. + +{% data reusables.discussions.navigate-to-repo-or-org %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. Under the main discussion post, select **Oldest**, **Newest**, or **Top**. + + ![Buttons for sorting comments in discussions](/assets/images/help/discussions/sort-comments-buttons.png) + + - Sort by **Oldest** to display the oldest top-level comments first. + - Sort by **Newest** to display the newest top-level comments first. + - Sort by **Top** to display the most upvoted top-level comments first. + +## Converting an issue to a discussion + +{% data reusables.discussions.you-can-convert-an-issue %} For more information, see "[Moderating discussions](/discussions/managing-discussions-for-your-community/moderating-discussions#converting-an-issue-to-a-discussion)." + +## Further reading + +- "[About writing and formatting on {% data variables.product.prodname_dotcom %}](/github/writing-on-github/about-writing-and-formatting-on-github)" +{%- ifversion fpt or ghec %} +- "[Maintaining your safety on {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)" +{%- endif %} 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 dd3a65f420..ccfd537fc0 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,40 +1,66 @@ --- -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 %}.' +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 access to a repository can participate in discussions and polls in the repository. People with read access to the source repository for organization discussions can participate in discussions and polls in that organization. {% data reusables.enterprise-accounts.emu-permission-interact %}' versions: feature: discussions shortTitle: Participate in discussion -ms.openlocfilehash: 07db8d3583c218e592ca1b68171292e52fcfc12f -ms.sourcegitcommit: 47bd0e48c7dba1dde49baff60bc1eddc91ab10c5 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/05/2022 -ms.locfileid: '147410232' --- -## Sobre a participação em uma discussão -{% data reusables.discussions.about-discussions %} Para obter mais informações, confira "[Sobre as discussões](/discussions/collaborating-with-your-community-using-discussions/about-discussions)". -Além de começar ou visualizar discussões e polls, você poderá 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. +## About participation in a discussion -{% ifversion fpt or ghec %}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, confira "[Como manter sua segurança no {% data variables.product.prodname_dotcom %}](/communities/maintaining-your-safety-on-github)".{% endif %} +{% data reusables.discussions.about-discussions %} For more information, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)." -## Pré-requisitos +In addition to starting or viewing discussions and polls, you can: -{% data variables.product.prodname_discussions %} deve estar habilitado para o repositório ou a organização para que você participe de uma discussão no repositório ou na organização. Para obter mais informações, confira "[Habilitar ou desabilitar {% data variables.product.prodname_discussions %} para um repositório](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)" e "[Habilitar ou desabilitar Discussões GitHub de uma organização](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." +- Comment in response to the original comment from the author of the discussion +- Create a comment thread by replying to an individual comment that another community member made within the discussion +- React to comments with emoji +- Upvote discussions and top-level comments to give them more visibility -## Criar uma discussão +{% ifversion fpt or ghec %}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 %}](/communities/maintaining-your-safety-on-github)."{% endif %} + +## Prerequisites + +{% data variables.product.prodname_discussions %} must be enabled for the repository or organization for you to participate in a discussion in the repository or organization. For more information, see "[Enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/github/administering-a-repository/enabling-or-disabling-github-discussions-for-a-repository)" and "[Enabling or disabling GitHub Discussions for an organization](/organizations/managing-organization-settings/enabling-or-disabling-github-discussions-for-an-organization)." + +## Creating a discussion {% data reusables.discussions.starting-a-discussion %} -## Criar um poll +## Creating a poll {% data reusables.discussions.starting-a-poll %} -## Marcar um comentário como uma resposta +## Marking a comment as an answer -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. -Da mesma forma, autores de discussão e usuários com a função de triagem ou maior para o repositório de origem para discussões da organização podem marcar um comentário como a resposta a uma discussão na organização. +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. +Similarly, discussion authors and users with the triage role or greater for the source repository for organization discussions can mark a comment as the answer to a discussion in the organization. {% data reusables.discussions.marking-a-comment-as-an-answer %} + +## Upvoting a discussion + +You can upvote discussions to give more visibility to the topics that matter to you, and sort discussions to see which have been upvoted the most. For more information on sorting discussions, see "[Sorting the list of discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-the-list-of-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +1. In the list of discussions, find the discussion you want to upvote. +1. To the left of the discussion, click the upvote arrow. + + ![Discussion list and upvote button for upvoting discussions](/assets/images/help/discussions/upvote-discussion-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. + +## Upvoting a comment + +You can upvote top-level comments in discussions, and sort top-level comments to see which comments have been upvoted the most. For more information on sorting comments, see "[Sorting top-level comments in discussions](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions#sorting-top-level-comments-in-discussions)." + +{% data reusables.repositories.navigate-to-repo %} +{% data reusables.discussions.discussions-tab %} +{% data reusables.discussions.click-discussion-in-list %} +1. In the discussion, find a top-level comment you want to upvote. +1. Click on the upvote arrow at the bottom left of the comment. + + ![Top-level comment and upvote button for upvoting comments](/assets/images/help/discussions/upvote-comment-button.png) +1. Optionally, click the upvote arrow again to remove your upvote. diff --git a/translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md b/translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md index 4e5620c52d..dd8c5100cd 100644 --- a/translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md +++ b/translations/pt-BR/content/organizations/managing-organization-settings/managing-the-forking-policy-for-your-organization.md @@ -1,6 +1,6 @@ --- -title: Gerenciar a política de bifurcação da sua organização -intro: 'Você pode permitir ou impedir a bifurcação de qualquer repositório privado{% ifversion ghes or ghae or ghec %} e interno{% endif %} pertencente à sua organização.' +title: Managing the forking policy for your organization +intro: 'You can allow or prevent the forking of any private{% ifversion ghes or ghae or ghec %} and internal{% endif %} repositories owned by your organization.' redirect_from: - /articles/allowing-people-to-fork-private-repositories-in-your-organization - /github/setting-up-and-managing-organizations-and-teams/allowing-people-to-fork-private-repositories-in-your-organization @@ -15,24 +15,30 @@ topics: - Organizations - Teams shortTitle: Manage forking policy -ms.openlocfilehash: 11aad8ee3c08b62f6bc352f91b6d804f35eee6e6 -ms.sourcegitcommit: fcf3546b7cc208155fb8acdf68b81be28afc3d2d -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/10/2022 -ms.locfileid: '145095623' --- -Por padrão, as novas organizações são configuradas para não permitirem a criação de forks de repositórios privados{% ifversion ghes or ghec or ghae %} e internos{% endif %}. -Se você permitir a criação de forks de repositórios privados{% ifversion ghes or ghec or ghae %} e internos{% endif %} no nível da organização, também poderá configurar a capacidade de criar forks de um repositório privado{% ifversion ghes or ghec or ghae %} ou interno{% endif %} específico. Para obter mais informações, confira "[Como gerenciar a política de criação de forks para seu repositório](/github/administering-a-repository/managing-the-forking-policy-for-your-repository)". +By default, new organizations are configured to disallow the forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories. -{% data reusables.profile.access_org %} {% data reusables.profile.org_settings %} {% data reusables.profile.org_member_privileges %} -1. Em "Criação de forks do repositório", selecione **Permitir a criação de forks de repositórios privados {% ifversion ghec or ghes or ghae %}e internos{% endif %}** . +If you allow forking of private{% ifversion ghes or ghec or ghae %} and internal{% endif %} repositories at the organization level, you can also configure the ability to fork a specific private{% ifversion ghes or ghec or ghae %} 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)." - {%- ifversion fpt %} ![Caixa de seleção usada para permitir ou não a criação de forks na organização](/assets/images/help/repository/allow-disable-forking-fpt.png) {%- elsif ghes or ghec or ghae %} ![Caixa de seleção usada para permitir ou não a criação de forks na organização](/assets/images/help/repository/allow-disable-forking-organization.png) {%- endif %} -6. Clique em **Salvar**. +{% ifversion org-owners-limit-forks-creation %} +{% ifversion ghec %}If your organization is owned by an enterprise account, you{% else %}You{% endif %} may not be able to configure this setting for your organization, if an enterprise owner has set a policy at the enterprise level. For more information, see "[Enforcing repository management policies in your enterprise](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-repository-management-policies-in-your-enterprise#enforcing-a-policy-for-forking-private-or-internal-repositories)."{% endif %} -## Leitura adicional +{% data reusables.profile.access_org %} +{% data reusables.profile.org_settings %} +{% data reusables.profile.org_member_privileges %} +1. Under "Repository forking", select **Allow forking of private {% ifversion ghec or ghes or ghae %}and internal {% endif %}repositories**. -- "[Sobre os forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" -- "[Funções de repositório para uma organização](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)" + {%- ifversion fpt %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-fpt.png) + {%- elsif ghes or ghec or ghae %} + ![Checkbox to allow or disallow forking in the organization](/assets/images/help/repository/allow-disable-forking-organization.png) + {%- endif %}{% ifversion org-owners-limit-forks-creation %} +2. Optionally, if forking is enabled, you can specify where users are allowed to fork repositories. If your organization belongs to a {% data variables.product.prodname_enterprise %} account and a more restrictive default has been selected in the enterprise settings, you won't be able to select the more permissive default in your organization settings. Review the information about changing the setting and choose a policy. + ![Screenshot showing the list of repository forking policy options](/assets/images/help/business-accounts/org-repository-forking-policy-settings.png){%- endif %} +3. Click **Save**. + +## Further reading + +- "[About forks](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)" +- "[Repository roles for an organization](/organizations/managing-access-to-your-organizations-repositories/repository-roles-for-an-organization)" diff --git a/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md b/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md index c52b1f4f18..53cf00e556 100644 --- a/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md +++ b/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners.md @@ -47,7 +47,16 @@ To reduce the size of your CODEOWNERS file, consider using wildcard patterns to ## CODEOWNERS syntax -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). The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. +{% warning %} + +**Warning:** 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 + +{% endwarning %} + +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. The pattern is followed by one or more {% data variables.product.prodname_dotcom %} usernames or team names using the standard `@username` or `@org/team-name` format. Users and teams must have explicit `write` access to the repository, even if the team's members already have access. {% ifversion fpt or ghec%}In most cases, you{% else %}You{% endif %} can also refer to a user by an email address that has been added to their account on {% ifversion ghae %}{% data variables.product.product_name %}{% else %}{% data variables.product.product_location %}{% endif %}, for example `user@example.com`. {% ifversion fpt or ghec %} You cannot use an email address to refer to a {% data variables.product.prodname_managed_user %}. For more information about {% data variables.product.prodname_managed_users %}, see "[About {% data variables.product.prodname_emus %}](/enterprise-cloud@latest/admin/identity-and-access-management/managing-iam-with-enterprise-managed-users/about-enterprise-managed-users){% ifversion fpt %}" in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}."{% endif %}{% endif %} @@ -117,15 +126,6 @@ apps/ @octocat /apps/github ``` -{% warning %} - -**Warning:** 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 - -{% endwarning %} - ## CODEOWNERS and branch protection Repository owners can add branch protection rules to ensure that changed code is reviewed by the owners of the changed files. For more information, see "[About protected branches](/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches)." diff --git a/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md b/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md index ac0814041c..70049d7c6e 100644 --- a/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md +++ b/translations/pt-BR/content/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/managing-github-actions-settings-for-a-repository.md @@ -119,9 +119,9 @@ By default, when you create a new repository in your personal account, `GITHUB_T {% data reusables.repositories.sidebar-settings %} {% data reusables.repositories.settings-sidebar-actions-general %} 1. Under "Workflow permissions", choose whether you want the `GITHUB_TOKEN` to have read and write access for all scopes, or just read access for the `contents` scope. - - ![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository{% ifversion allow-actions-to-approve-pr-with-ent-repo %}-with-pr-approval{% endif %}.png) - + + {% ifversion allow-actions-to-approve-pr-with-ent-repo %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository-with-pr-approval.png){% else %}![Set GITHUB_TOKEN permissions for this repository](/assets/images/help/settings/actions-workflow-permissions-repository.png){% endif %} + 1. Click **Save** to apply the settings. {% ifversion allow-actions-to-approve-pr-with-ent-repo %} diff --git a/translations/pt-BR/data/reusables/actions/ip-allow-list-self-hosted-runners.md b/translations/pt-BR/data/reusables/actions/ip-allow-list-self-hosted-runners.md index 7dbfa4f50b..4cb42a307d 100644 --- a/translations/pt-BR/data/reusables/actions/ip-allow-list-self-hosted-runners.md +++ b/translations/pt-BR/data/reusables/actions/ip-allow-list-self-hosted-runners.md @@ -1,17 +1,11 @@ ---- -ms.openlocfilehash: bd2ea7e2ff0c8e9f60c3d011ee30573e3702cbed -ms.sourcegitcommit: 5b1461b419dbef60ae9dbdf8e905a4df30fc91b7 -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147875606" ---- -{% ifversion ghae %} Para permitir que os executores auto-hospedados se comuniquem com o {% data variables.product.prodname_dotcom %}, adicione o endereço IP ou o intervalo de endereços IP dos seus executores auto-hospedados à lista de IPs permitidos. Para obter mais informações, confira "[Como adicionar um endereço IP permitido](#adding-an-allowed-ip-address)". -{% else %} {% warning %} +{% ifversion ghae %} +To allow your self-hosted runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your self-hosted runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." +{% else %} +{% warning %} -**Aviso**: se você usar uma lista de IPs permitidos e desejar usar o {% data variables.product.prodname_actions %}, use executores auto-hospedados. Para obter mais informações, confira ["Como hospedar seus executores](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)". +**Warning**: If you use an IP allow list and would also like to use {% data variables.product.prodname_actions %}, you must use self-hosted runners{% ifversion actions-hosted-runners %} or {% data variables.product.prodname_dotcom %}-hosted larger runners with a static IP address range{% endif %}. For more information, see "[Hosting your own runners](/actions/automating-your-workflow-with-github-actions/about-self-hosted-runners)" {% ifversion actions-hosted-runners %} or "[Using larger runners](/actions/using-github-hosted-runners/using-larger-runners)"{% endif %}. {% endwarning %} -Para permitir que seus executores auto-hospedados se comuniquem com {% data variables.product.prodname_dotcom %}, adicione o endereço IP ou o intervalo de endereços IP dos seus executores auto-hospedados para à lista de permitir IP. Para obter mais informações, confira "[Como adicionar um endereço IP permitido](#adding-an-allowed-ip-address)". +To allow your self-hosted {% ifversion actions-hosted-runners %}or larger hosted{% endif %} runners to communicate with {% data variables.product.prodname_dotcom %}, add the IP address or IP address range of your runners to the IP allow list. For more information, see "[Adding an allowed IP address](#adding-an-allowed-ip-address)." {% endif %} diff --git a/translations/pt-BR/data/reusables/repositories/navigate-to-commit-page.md b/translations/pt-BR/data/reusables/repositories/navigate-to-commit-page.md index 763759ca1c..d712c518b8 100644 --- a/translations/pt-BR/data/reusables/repositories/navigate-to-commit-page.md +++ b/translations/pt-BR/data/reusables/repositories/navigate-to-commit-page.md @@ -1,10 +1,2 @@ ---- -ms.openlocfilehash: af420b118bb0fcb0bdad8e2c88f02e5b546fa4f1 -ms.sourcegitcommit: 1309b46201604c190c63bfee47dce559003899bf -ms.translationtype: HT -ms.contentlocale: pt-BR -ms.lasthandoff: 09/10/2022 -ms.locfileid: "147065223" ---- -1. Na página principal do repositório, clique nos commits para navegar até a página de commits. - ![Captura de tela da página principal do repositório com os commits em destaque](/assets/images/help/commits/commits-page.png) +1. On the main page of the repository, click {% octicon "history" aria-label="The history icon" %} **commits** to navigate to the commits page. + ![Screenshot of the repository main page with the commits emphasized](/assets/images/help/commits/commits-page.png)