Skip to content

Commit fbfbe30

Browse files
committed
style and formatting
1 parent cf7f643 commit fbfbe30

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

docs/guides/modules/integration/pages/enable-checks.adoc

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -16,23 +16,26 @@ After GitHub Checks is enabled, CircleCI workflow status is reported under the c
1616

1717
image::guides:ROOT:checks_tab.png[CircleCI checks on GitHub]
1818

19-
NOTE: GitHub does not currently provide a granular way for you to rerun workflows. When you select the Re-run checks button, you will automatically re-run all checks, regardless of whether you selected "re-run failed checks" or "rerun all checks" from the Re-run checks button.
19+
NOTE: GitHub does not currently provide a granular way for you to rerun workflows. When you select the Re-run checks button, all checks are rerun, regardless of whether you selected "re-run failed checks" or "rerun all checks" from the Re-run checks button.
2020

2121
[#github-check-and-github-status-updates]
2222
== GitHub Check and GitHub status updates
2323

2424
GitHub Checks should not be confused with GitHub status updates:
2525

2626
* GitHub Checks are administered from the GitHub UI, and are reported in the GitHub UI per _workflow_.
27-
** GitHub Checks from OAuth integrations have the same name as the associated workflow.
28-
** GitHub Checks from GitHub App integrations are named using a combination of the workflow name and the first eight characters of the pipeline definition ID. The identifier is used to prevent naming collisions. The pipeline definition ID is available in the *Project Settings* > *Pipelines* page in the CircleCI web app.
29-
** Each workflow in a pipeline generates a GitHub Check. However, if multiple pipelines are triggered for the same commit SHA with workflows that share the same name, only one GitHub Check will appear for that workflow name. Use unique workflow names across pipelines to get distinct GitHub Checks.
27+
** GitHub Checks from OAuth integrations have the same name as the associated workflow.
28+
** GitHub Checks from GitHub App integrations are named using a combination of the workflow name and the first eight characters of the pipeline definition ID. The identifier is used to prevent naming collisions. The pipeline definition ID is available in the *Project Settings* > *Pipelines* page in the CircleCI web app.
29+
** Each workflow in a pipeline generates a GitHub Check. If multiple pipelines trigger for the same commit SHA with workflows that share the same name, only one GitHub Check appears for that workflow name. Use unique workflow names across pipelines to get distinct GitHub Checks.
3030
* GitHub status updates are the default way status updates from your builds are reported in the GitHub UI, and they are reported per _job_.
3131
32-
If both these features are enabled, in a GitHub PR view the Checks tab will show *workflow status* and the Checks section in the PR conversation view will show *job status*.
32+
If both these features are enabled you will see the following in a GitHub PR view:
3333

34-
If you are using GitHuck Checks or GitHub Status updates with the xref:orchestrate:skip-build.adoc#skip-jobs[skip jobs feature],
35-
the status of the skipped builds will not be reported even though the checks will be created in GitHub.
34+
* The Checks tab will show *workflow status*.
35+
* The Checks section in the PR conversation view will show *job status*.
36+
37+
If you are using GitHuck Checks or GitHub status updates with the xref:orchestrate:skip-build.adoc#skip-jobs[skip jobs feature],
38+
the status of the skipped builds will not be reported. The checks are still created in GitHub.
3639

3740
[#prerequisites]
3841
== Prerequisites
@@ -51,12 +54,12 @@ the status of the skipped builds will not be reported even though the checks wil
5154
image::guides:ROOT:github-checks.png[CircleCI VCS Settings Page]
5255
. You are now in the GitHub CircleCI Checks App settings page. Select the repositories that should use checks and select *Save*.
5356

54-
After installation completes, the Checks tab on the GitHub PR view will be populated with workflow status information, and from here you can rerun workflows or navigate to the CircleCI app to view further information.
57+
After installation completes, the Checks tab on the GitHub PR view is populated with workflow status information. From the Checks tab you can rerun workflows or navigate to the CircleCI app to view further information.
5558

5659
[#checks-status-reporting]
5760
== Checks status reporting
5861

59-
CircleCI reports the status of workflows and all corresponding jobs under the Checks tab on GitHub. Additionally, Checks provides a button to rerun all workflows configured for your project.
62+
CircleCI reports the status of workflows and all corresponding jobs under the Checks tab on GitHub. Checks provides a button to rerun all workflows configured for your project.
6063

6164
After a rerun is initiated, CircleCI reruns the workflows from the start and reports the status in the Checks tab. To navigate to the CircleCI app from GitHub, select the *View more details on CircleCI Checks* link.
6265

@@ -97,11 +100,11 @@ NOTE: GitHub OAuth integrations will automatically re-enable job level status wh
97100

98101
`ci/circleci:build — Waiting for status to be reported`
99102

100-
If you have enabled GitHub Checks in your GitHub repository, but the status check never completes on GitHub Checks tab, there may be status settings in GitHub that you need to deselect. For example, if you choose to protect your branches, you may need to deselect the `ci/circleci:build` status key as this check refers to the job status from CircleCI, as follows:
103+
If you have enabled GitHub Checks and the status check never completes on GitHub Checks tab, there may be status settings in GitHub that you need to deselect. For example, if you choose to protect your branches, you may need to deselect the `ci/circleci:build` status key as this check refers to the job status from CircleCI, as follows:
101104

102105
image::guides:ROOT:github_job_status.png[Uncheck GitHub Job Status Keys]
103106

104-
Having the `ci/circleci:build` checkbox enabled will prevent the status from showing as completed in GitHub when using a GitHub Check because CircleCI posts statuses to GitHub at a workflow level rather than a job level.
107+
Having the `ci/circleci:build` checkbox enabled prevents the status from showing as completed in GitHub when using a GitHub Check. CircleCI posts statuses to GitHub at a workflow level rather than a job level.
105108

106109
Go to menu:Settings[Branches] in GitHub and select the *Edit* button on the protected branch to deselect the settings, for example `+https://github.com/your-org/project/settings/branches+`.
107110

0 commit comments

Comments
 (0)