Merge pull request #29932 from github/repo-sync

Repo sync
This commit is contained in:
docs-bot 2023-11-13 13:31:00 -05:00 коммит произвёл GitHub
Родитель b374e495b1 c2b8cb6f5f
Коммит 66be239524
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
22 изменённых файлов: 124 добавлений и 37 удалений

Просмотреть файл

@ -18,7 +18,12 @@ permissions:
jobs:
find-pr-and-post-comment:
if: ${{ github.repository == 'github/docs-internal' }}
if: >-
${{
github.repository == 'github/docs-internal' &&
(github.event_name != 'workflow_run' ||
github.event.workflow_run.conclusion == 'success')
}}
runs-on: ubuntu-latest
steps:
- name: Check out repo

7
.github/workflows/purge-fastly.yml поставляемый
Просмотреть файл

@ -30,7 +30,12 @@ env:
jobs:
send-purges:
if: ${{ github.repository == 'github/docs-internal' && (github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success') }}
if: >-
${{
github.repository == 'github/docs-internal' &&
(github.event_name != 'workflow_run' ||
github.event.workflow_run.conclusion == 'success')
}}
runs-on: ubuntu-latest
steps:
- name: Check out repo

Просмотреть файл

@ -14,7 +14,7 @@ topics:
- Profiles
shortTitle: Pin items
---
You can pin a public repository if you own the repository or you've made contributions to the repository. Commits to forks don't count as contributions, so you can't pin a fork that you don't own. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile)"
You can pin a public repository if you own the repository or you've made contributions to the repository within the last year. Commits to forks don't count as contributions, so you can't pin a fork that you don't own. For more information, see "[AUTOTITLE](/account-and-profile/setting-up-and-managing-your-github-profile/managing-contribution-settings-on-your-profile/why-are-my-contributions-not-showing-up-on-my-profile)"
You can pin any public gist you own.

Просмотреть файл

@ -9,7 +9,10 @@ topics:
- Errors
- Troubleshooting
versions:
feature: code-scanning-tool-status-page
fpt: '*'
ghes: '*'
ghae: '*'
ghec: '*'
---
## About this error

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'Alerts found in generated code'
shortTitle: 'Alerts in generated code'
title: Alerts found in generated code
shortTitle: Alerts in generated code
intro: 'When analyzing your code with {% data variables.product.prodname_code_scanning %}, you may wish to build only the code which you wish to analyze.'
allowTitleToDifferFromFilename: true
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/alerts-found-in-generated-code
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'Code scanning analysis takes too long'
shortTitle: 'Analysis takes too long'
title: Code scanning analysis takes too long
shortTitle: Analysis takes too long
intro: 'You can fine tune your {% data variables.product.prodname_code_scanning %} configuration to minimize analysis time.'
allowTitleToDifferFromFilename: true
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/build-is-taking-too-long
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'Automatic build failed for a compiled language'
shortTitle: 'Automatic build failed'
title: Automatic build failed for a compiled language
shortTitle: Automatic build failed
allowTitleToDifferFromFilename: true
intro: 'If automatic build fails, you can configure {% data variables.product.prodname_code_scanning %} to use specific build steps for compiled languages.'
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/automatic-build-failed-for-a-compiled-language
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -0,0 +1,43 @@
---
title: 'Cannot enable CodeQL in a private repository'
intro: '{% data variables.product.prodname_GH_advanced_security %} must be enabled in order to use {% data variables.product.prodname_code_scanning %} on private repositories.'
allowTitleToDifferFromFilename: true
type: reference
topics:
- Code scanning
- Errors
- Troubleshooting
versions:
fpt: '*'
ghes: '*'
ghae: '*'
ghec: '*'
---
{% ifversion fpt %}
If you are on a free, pro, or team plan, you can only use {% data variables.product.prodname_code_scanning %} on repositories that are publically available. To enable {% data variables.product.prodname_code_scanning %} for private or internal repositories, you must upgrade to GitHub Enterprise with {% data variables.product.prodname_GH_advanced_security %} and enable {% data variables.product.prodname_GH_advanced_security %} for the repository. For more information, see "[AUTOTITLE](/get-started/learning-about-github/githubs-products#github-enterprise)" and "[AUTOTITLE](/get-started/learning-about-github/about-github-advanced-security)."
{% else %}
## Confirm whether {% data variables.product.prodname_GH_advanced_security %} is enabled
{% data reusables.repositories.navigate-to-repo %}
{% data reusables.repositories.sidebar-settings %}
{% data reusables.user-settings.security-analysis %}
1. Scroll down to "{% data variables.product.prodname_GH_advanced_security %}."
1. If there is an associated and active **Enable** button, {% data variables.product.prodname_GH_advanced_security %} is available for this repository but not yet enabled.
1. If use of {% data variables.product.prodname_GH_advanced_security %} is blocked by a policy, the **Enable** button is inactive and the owner of the policy is listed.
!["Screenshot of the {% data variables.product.prodname_GH_advanced_security %}" setting. The enterprise policy owner and the inactive "Enable" button are highlighted in dark orange.](/assets/images/help/repository/ghas-enterprise-policy-block.png)
### Requesting access to {% data variables.product.prodname_GH_advanced_security %}
1. In the "{% data variables.product.prodname_GH_advanced_security %}" settings, click the enterprise name to display a list of users with access to edit the policy that controls access to {% data variables.product.prodname_GH_advanced_security %}. For more information, see "[AUTOTITLE](/admin/policies/enforcing-policies-for-your-enterprise/enforcing-policies-for-code-security-and-analysis-for-your-enterprise#enforcing-a-policy-for-the-use-of-github-advanced-security-in-your-enterprises-organizations)."
1. Follow your company's policy for requesting access to additional features.
### Enabling {% data variables.product.prodname_GH_advanced_security %}
1. In the "{% data variables.product.prodname_GH_advanced_security %}" settings, click **Enable**.
1. Rerun {% data variables.product.prodname_code_scanning %}.
{% endif %}

Просмотреть файл

@ -1,10 +1,12 @@
---
title: 'A particular language is causing default setup to fail'
shortTitle: 'Default setup fails with a language'
title: A particular language is causing default setup to fail
shortTitle: Default setup fails with a language
intro: 'When you enable default setup, all languages selected for analysis must be successfully analyzed, or the configuration of default setup will fail.'
allowTitleToDifferFromFilename: true
versions:
feature: code-scanning-without-workflow-310
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/a-particular-language-is-causing-default-setup-to-fail
---
To enable default setup when a language previously failed, you must reconfigure default setup, deselecting all failing languages for analysis.

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'CodeQL scanned fewer lines than expected'
shortTitle: 'Fewer lines scanned than expected'
title: CodeQL scanned fewer lines than expected
shortTitle: Fewer lines scanned than expected
intro: 'If {% data variables.product.prodname_codeql %} analyzed less code than than you expected, you may need to use a custom build command.'
allowTitleToDifferFromFilename: true
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/codeql-scanned-fewer-lines-than-expected
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -15,24 +15,26 @@ topics:
- CodeQL
- Repositories
children:
- /a-particular-language-is-causing-default-setup-to-fail
- /advanced-security-must-be-enabled
- /alerts-found-in-generated-code
- /automatic-build-failed-for-a-compiled-language
- /build-is-taking-too-long
- /codeql-scanned-fewer-lines-than-expected
- /alerts-in-generated-code
- /analysis-takes-too-long
- /automatic-build-failed
- /cannot-enable-codeql-in-a-private-repository
- /default-setup-fails-with-a-language
- /enabling-default-setup-takes-too-long
- /extraction-errors-in-the-database
- /logs-are-not-detailed-enough
- /fewer-lines-scanned-than-expected
- /logs-not-detailed-enough
- /no-source-code-seen-during-build
- /not-recognized
- /out-of-disk-or-memory
- /some-languages-were-not-analyzed
- /resource-not-accessible-by-integration
- /results-are-different-than-expected
- /resource-not-accessible
- /results-different-than-expected
- /results-differ-between-platforms
- /server-error
- /some-languages-not-analyzed
- /two-codeql-workflows
- /unclear-what-triggered-a-workflow-run
- /unclear-what-triggered-a-workflow
- /unnecessary-step-found
---
---

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'Logs are not detailed enough'
shortTitle: 'Logs not detailed enough'
title: Logs are not detailed enough
shortTitle: Logs not detailed enough
intro: 'If you''d like to increase the level of detail in your logs, try these steps.'
allowTitleToDifferFromFilename: true
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/logs-are-not-detailed-enough
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,11 +1,13 @@
---
title: 'Error: 403 "Resource not accessible by integration"'
shortTitle: 'Resource not accessible'
shortTitle: Resource not accessible
intro: 'This error may be seen on pull requests created by {% data variables.product.prodname_dependabot %} and can be resolved in a couple of different ways.'
allowTitleToDifferFromFilename: true
versions:
fpt: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/resource-not-accessible-by-integration
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,10 +1,12 @@
---
title: 'Results are different than expected'
shortTitle: 'Results different than expected'
title: Results are different than expected
shortTitle: Results different than expected
intro: 'If your {% data variables.product.prodname_code_scanning %} results are different than you expected, you can check which configurations are active.'
allowTitleToDifferFromFilename: true
versions:
feature: code-scanning-without-workflow
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/results-are-different-than-expected
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,6 +1,6 @@
---
title: 'Some languages were not analyzed with CodeQL advanced setup'
shortTitle: 'Some languages not analyzed'
title: Some languages were not analyzed with CodeQL advanced setup
shortTitle: Some languages not analyzed
allowTitleToDifferFromFilename: true
intro: 'If some languages were not analyzed, you can modify your {% data variables.product.prodname_code_scanning %} workflow to add a matrix specifying the languages you want to analyze.'
versions:
@ -8,6 +8,8 @@ versions:
ghes: '*'
ghae: '*'
ghec: '*'
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/some-languages-were-not-analyzed
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -1,10 +1,12 @@
---
title: 'Unclear what triggered a workflow run'
shortTitle: 'Unclear what triggered a workflow'
title: Unclear what triggered a workflow run
shortTitle: Unclear what triggered a workflow
intro: 'If you don''t know what triggered an analysis, {% ifversion code-scanning-tool-status-page %} investigate the {% data variables.code-scanning.tool_status_page %} or {% endif %}look at the log for the last scan.'
allowTitleToDifferFromFilename: true
versions:
feature: code-scanning-without-workflow
redirect_from:
- /code-security/code-scanning/troubleshooting-code-scanning/unclear-what-triggered-a-workflow-run
---
{% data reusables.code-scanning.beta %}

Просмотреть файл

@ -84,6 +84,7 @@ You may notice some repositories have a "Used by" section in the sidebar of the
- The dependency graph is enabled for the repository (see the above section for more details).
- Your repository contains a package that is published on a [supported package ecosystem](/code-security/supply-chain-security/understanding-your-software-supply-chain/about-the-dependency-graph#supported-package-ecosystems).
- Within the ecosystem, your package has a link to a _public_ repository where the source is stored.
- More than 100 repositories depend on your package.
The "Used by" section shows the number of public references to the package that were found, and displays the avatars of some of the owners of the dependent projects.

Просмотреть файл

@ -45,6 +45,8 @@ A [pull request](/github/collaborating-with-issues-and-pull-requests/about-pull-
We cannot accept contributions to the [REST API reference documentation](/rest/reference). If you spot an inaccuracy in the REST API reference documentation, open an issue in the [`rest-api-description`](https://github.com/github/rest-api-description/issues/new?template=schema-inaccuracy.md) repository.
We only document {% data variables.product.prodname_dotcom %} products, features, tools, and extensions. We do not document third-party tools or integrations unless they were codeveloped with {% data variables.product.company_short %}.
### Reviewing your own pull requests
You should always review your own pull request first, before marking it as ready for review by others.

Просмотреть файл

@ -43,7 +43,7 @@ Only include a maximum of eight different tools in an article. Including more to
## Adding new tools
{% data variables.product.prodname_docs %} documents and maintains tool tags for {% data variables.product.prodname_dotcom %} products, {% data variables.product.prodname_dotcom %}-developed tools, and select third-party extensions.
{% data variables.product.prodname_docs %} documents and maintains tool tags for {% data variables.product.prodname_dotcom %} products, {% data variables.product.prodname_dotcom %}-developed tools, and select third-party extensions developed in collaboration with {% data variables.product.company_short %} .
New tools are only added when they are the only way to accurately document something for a specific user need. If a writer determines that adding a new tool is the only way to accurately document something, they need to propose the new tool in a content design plan. Whoever reviews the content design plan should consider any alternative ways to address the documentation needs without adding a new tool. If a new tool is the only way to create accurate documentation, the new tool should be added. If there is an alternative content solution that does not add a new tool, that option should be used.

Просмотреть файл

@ -17,6 +17,12 @@ shortTitle: Required status checks
---
If you have a check and a status with the same name, and you select that name as a required status check, both the check and the status are required. For more information, see "[AUTOTITLE](/rest/checks)."
{% note %}
**Note:** To be required, status checks must have completed successfully within the chosen repository during the past seven days.
{% endnote %}
After you enable required status checks, your branch may need to be up-to-date with the base branch before merging. This ensures that your branch has been tested with the latest code from the base branch. If your branch is out of date, you'll need to merge the base branch into your branch. For more information, see "[AUTOTITLE](/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-status-checks-before-merging)."
{% note %}

Просмотреть файл

@ -26,7 +26,7 @@ When we receive reports of trademark policy violations from holders of federal o
## How Do I Report a Trademark Policy Violation?
Holders of registered trademarks can report possible trademark policy violations to GitHub via [GitHub Support](https://support.github.com/). Please use the contact form and submit trademark-related requests using your company email address and include all the information requested below to help expedite our response. Also be sure to clearly describe to us why the account may cause confusion with your mark or how the account may dilute or tarnish your mark.
Holders of registered trademarks can report possible trademark policy violations to GitHub via [Submit a Trademark Policy Violation Report](https://support.github.com/contact/trademark-policy). Please use the contact form and submit trademark-related requests using your company email address and include all the information requested below to help expedite our response. Also be sure to clearly describe to us why the account may cause confusion with your mark or how the account may dilute or tarnish your mark.
## What Information is Required When Reporting Trademark Policy Violations?

Просмотреть файл

@ -1 +1 @@
[APIs and Integrations discussions on {% data variables.product.prodname_github_community %}](https://github.com/orgs/community/discussions/categories/api-and-webhooks)https://github.com/orgs/community/discussions/categories/api-and-webhooks)
[API and Webhooks category in GitHub's Community Discussions](https://github.com/orgs/community/discussions/categories/api-and-webhooks)