Skip to content

Commit 67b56ce

Browse files
[Accessibility] Revise images for security overview (github#34674)
Co-authored-by: Laura Coursen <lecoursen@github.com>
1 parent 190bbd0 commit 67b56ce

12 files changed

Lines changed: 26 additions & 40 deletions
68.4 KB
Loading
-118 KB
Binary file not shown.
-6.14 KB
Binary file not shown.
Binary file not shown.
46.6 KB
Loading
-93.1 KB
Binary file not shown.

content/code-security/security-overview/about-the-security-overview.md

Lines changed: 14 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -64,41 +64,33 @@ The application security team at your company can use the different views for bo
6464

6565
Organization owners and security managers for organizations have access to the security overview for their organizations. {% ifversion ghec or ghes > 3.6 or ghae > 3.6 %}Organization members can also access the organization-level security overview to view results for repositories where they have admin privileges or have been granted access to security alerts. For more information on managing security alert access, see "[Managing security and analysis settings for your repository](/github/administering-a-repository/managing-security-and-analysis-settings-for-your-repository)."{% endif %}
6666

67-
{% ifversion security-overview-single-repo-enablement or security-overview-org-risk-coverage %}
67+
{% ifversion security-overview-org-risk-coverage %}
6868

6969
### Security Risk view
7070

7171
This view shows data about the repositories affected by different types of security alert.
7272

73-
- Use the **Type** and **Teams** drop-downs to add repository type and team filters.
74-
- Click **Open alerts** or **Repositories affected** to show only repositories with a specific type of security alert.
73+
- Use the **Teams** dropdown menu to show information only for the repositories owned by one or more teams.
74+
- Click **NUMBER affected** or **NUMBER unaffected** in the header for any type of alert to show only the repositories with or without alerts of that type.
75+
- Click any of the descriptions of "Open alerts" in the header to show only repositories with alerts of that type and category. For example, **1 critical** to show the repository with a critical alert for {% data variables.product.prodname_dependabot %}.
76+
- Click **NUMBER Archived** to show only repositories that are archived.
77+
- Click in the search box to show a list of the full set of available filters.
7578

76-
In addition, when you click in the search box, a list of the full set of filters available is shown.
77-
78-
![Screenshot of the Security Risk view for an organization](/assets/images/help/security-overview/security-risk-view.png)
79+
![Screenshot of the "Security Risk" view on the "Security" tab for an organization. Illustrates information and filter options available in the view.](/assets/images/help/security-overview/security-risk-interactive-header.png)
7980

8081

8182
### Security Coverage view
8283

83-
This view shows data about which repositories are using security features.
84-
85-
- Use the **Type** and **Teams** drop-downs to add repository type and team filters.
86-
- Click **Alerts enabled** and other features listed in the header to see only repositories with those features enabled.
87-
- Change any `FEATURE:enabled` filter to `FEATURE:not-enabled` in the search box to see repositories that haven't enabled a feature.
88-
{%- ifversion security-overview-single-repo-enablement %}
89-
- For any repository, click **Security Settings** to enable security features that have a one-click setup.
90-
91-
In addition, when you click in the search box, a list of the full set of filters available is shown.
84+
This view shows data about which security features are used by repositories in the organization. You can filter the view to show the repositories of interest using links, a dropdown menu, and a search field.
9285

93-
![Screenshot of the Security Coverage view for an organization](/assets/images/help/security-overview/security-coverage-view-single-repo-enablement.png)
86+
- Use the **Teams** dropdown to show information only for the repositories owned by one or more teams.
87+
- Click **NUMBER enabled** or **NUMBER not enabled** in the header for any feature to show only the repositories with that feature enabled or not enabled.
88+
- Click **NUMBER Archived** to show only repositories that are archived.
89+
- Click in the search box to show a list of the full set of available filters.
9490

95-
{%- elsif security-overview-org-risk-coverage %}
96-
- For any repository, click the ellipsis (**...**) then **Security Settings** to enable additional features.
91+
In addition, you can click **{% octicon "gear" aria-label="" %} Security settings** for any repository to enable the security features that have a one-click setup.
9792

98-
In addition, when you click in the search box, a list of the full set of filters available is shown.
99-
100-
![Screenshot of the Security Coverage view for an organization](/assets/images/help/security-overview/security-coverage-view.png)
101-
{% endif %}
93+
![Screenshot of the "Security Coverage" view on the "Security" tab for an organization. Illustrates information and filter options available in view.](/assets/images/help/security-overview/security-coverage-view-single-repo-enablement.png)
10294

10395
{% else %}
10496

@@ -108,8 +100,6 @@ In addition, when you click in the search box, a list of the full set of filters
108100

109101
For each repository in the security overview, you will see icons for each type of security feature and how many alerts there are of each type. If a security feature is not enabled for a repository, the icon for that feature will be grayed out. In addition, a risk score is calculated for each repository based on its code scanning, Dependabot and secret scanning alerts. This score is in beta and should be used with caution. Its algorithm and approach is subject to change.
110102

111-
![Icons in the security overview](/assets/images/help/security-overview/security-overview-icons.png)
112-
113103
| Icon | Meaning |
114104
| -------- | -------- |
115105
| {% octicon "code-square" aria-label="Code scanning alerts" %} | {% data variables.product.prodname_code_scanning_capc %} alerts. For more information, see "[About {% data variables.product.prodname_code_scanning %}](/code-security/secure-coding/about-code-scanning)." |

content/code-security/security-overview/viewing-the-security-overview.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,21 +31,21 @@ shortTitle: View the security overview
3131
{% ifversion security-overview-org-risk-coverage %}
3232
{% data reusables.organizations.navigate-to-org %}
3333
{% data reusables.organizations.security-overview %}
34-
1. Choose the overview you want to display from the options in the sidebar.
35-
1. Use the drop-down filters and search box to focus on the information of greatest interest. The "Security Risk" and "Security Coverage" views also have an interactive header that you can use to filter results.
36-
37-
![Screenshot of the Security Risk view with interactive header highlighted](/assets/images/help/security-overview/security-risk-interactive-header.png)
34+
1. To display a summary view, in the sidebar, click **{% octicon "shield" %} Risk** or **{% octicon "meter" %} Coverage**.
35+
1. Optionally, to focus on the information of greatest interest, select the **Teams** dropdown filter and search box.
36+
1. Optionally, use links in the "{% data variables.product.prodname_dependabot %}", "{% data variables.product.prodname_code_scanning %}", and "{% data variables.product.prodname_secret_scanning %}" header summaries to filter results further.
37+
![Screenshot of the "Security Risk" view on the "Security" tab for an organization. Illustrates information and filter options available in the view.](/assets/images/help/security-overview/security-risk-interactive-header.png)
38+
{% data reusables.organizations.security-overview-feature-specific-page %}
3839

3940
{% else %}
4041

4142
{% data reusables.organizations.navigate-to-org %}
4243
{% data reusables.organizations.security-overview %}
4344
1. To view aggregate information about alert types, click **Show more**.
44-
![Show more button](/assets/images/help/security-overview/security-overview-show-more-button.png)
4545
{% data reusables.organizations.filter-security-overview %}
4646
{% ifversion security-overview-alert-views %}
4747
{% data reusables.organizations.security-overview-feature-specific-page %}
48-
![Screenshot of the code scanning-specific page](/assets/images/help/security-overview/security-overview-code-scanning-alerts.png)
48+
![Screenshot of the {% data variables.product.prodname_code_scanning %} alerts page on the "Security" tab. Features apart from filters, dropdown menus, and sidebar are grayed out.](/assets/images/help/security-overview/security-overview-code-scanning-alerts.png)
4949
{% endif %}
5050

5151
{% endif %}
@@ -57,7 +57,7 @@ shortTitle: View the security overview
5757
{% data reusables.security-overview.security-coverage-single-repo-enablement %}
5858

5959
{% data reusables.enterprise-accounts.access-enterprise-on-dotcom %}
60-
1. In the left sidebar, click {% octicon "shield" aria-label="The shield icon" %} **Code Security**.
60+
1. In the left sidebar, click **{% octicon "shield" aria-label="" %} Code Security**.
6161
{% ifversion security-overview-feature-specific-alert-page %}
6262
{% data reusables.organizations.security-overview-feature-specific-page %}
6363
{% endif %}
Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
1-
# Reference: #8557.
1+
# Reference: #8557 and #8765.
22
# Documentation for the organization-level split of the "Overview" page into "Risks" and "Coverage"
3+
# and the initial single-repo enablement panel for security overview coverage view.
34
versions:
45
ghes: '> 3.7'
56
ghae: '> 3.7'
7+
ghec: '*'

data/features/security-overview-single-repo-enablement.yml

Lines changed: 0 additions & 6 deletions
This file was deleted.

0 commit comments

Comments
 (0)