Adding an Issue (Checkpoint-Specific)
Adding an accessibility issue identified during manual testing to an individual Checkpoint screen is done via the Add Issue button. This allows you to associate the issue with the checkpoint by automatically selecting the currently-accessed screen as the Checkpoint field in the Add New Issue dialog box form.
Note: There are two different axe Auditor screens on which you can add issues. Issues may also be added from the Testing Status section of the Checkpoint Tests for Page: <Page Name> screen in which you populate the required Checkpoint field with a checkpoint you choose from a list on the Add New Issue form.
To add an issue:
On an individual Checkpoint screen (for example, Text Alternatives for Active Images 1.1.1.a), click the Add Issue button located just under the screen heading.
The Add New Issue dialog box (a pop-up window) appears in the foreground, with multiple entry and selection form fields along with a Save button.
In the Add New Issue dialog box, enter text in the Summary field that briefly summarizes the nature of the issue. This field is disabled for entry if the checkbox, Use Description as Summary is selected.
- Select the checkbox, Use Description as Summary if you want the summary
to be the same as the description mentioned in the field below. This is selected by default. This is useful if you aggregate reported issues based on Issue Summary.
In the Checkpoint field, click the down arrow, then select the applicable checkpoint from the list if different from the currently-accessed checkpoint (which is automatically selected and populated in this field by default.
Flag for review: Select this checkbox to automatically flag this
item for review when deemed necessary.
Note: This causes a Flag reason text box to appear below the field, allowing for entry of a reason the item is being flagged for review.
Populate the fields on the Add New Issue dialog box form as desired. The following information can be used as a general guidance:
Description: 'Create my own description' is selected by default. Based on your selection in the Checkpoint field, the list is automatically populated with related issue items. Select the most appropriate option.
- If you have the checkbox Use Description as Summary
selected before, the summary field gets automatically populated with the same description in the Description field.
Details: This is a free-form text entry field you can use as desired to record any additional information not included in the Description field. It can include remediation advice, for example.
Issue type: Refer to the following descriptions prior to making a selection:
- Accessibility: The issue impacts the ability for a disabled user to access content or functionality of the site. Fails the checkpoint test.
- Best Practice: The issue impacts the ability for a disabled user to access content or functionality of the site, but does not fail the checkpoint test. This is not considered a violation.
- User Agent: The issue is a result of the user agent interaction with the page, not necessarily the page content itself.
- Functionality: The issue is a result of a problem with the functionality of the page and should be considered a functional defect.
- Usability: The issue impacts the ability for all users to access content or functionality of the site.
In the Impact field, click the down arrow, then select the applicable impact level from the list.
Note: Critical is selected by default. Refer to the following descriptions prior to making a selection:
- Blocker: Results in catastrophic roadblocks for people with disabilities. These issues will definitely prevent them from accessing fundamental features or content, with no possible work arounds. This type of issue puts your organization at high risk. Prioritize fixing immediately, and deploy as hotfixes as soon as possible. Should be extremely rare.
- Critical: This issue results in blocked content for individuals with disabilities. Until a solution is implemented content will be completely inaccessible, making your organization highly vulnerable to legal action. Remediation should be a top priority.
- Serious: This issue results in serious barriers for individuals with disabilities. Until a solution is implemented some content will be inaccessible, making your organization vulnerable to legal action. Users relying on Assistive Technology will experience significant frustration when attempting to access content. Remediation should be a priority.
- Moderate: This issue results in some barriers for individuals with disabilities but would not prevent them from accessing fundamental elements or content. This might make your organization vulnerable to legal action. This violation must be resolved before a page can be considered fully compliant.
- Minor: This is considered an issue that yields less impact for users than a moderate issue. For a page to be considered fully compliant this issue must be resolved but can be dealt with last.
In the Selector, Source Code, Screenshots, and Recommendations section, fill in the following details:
- Selector Enter a CSS selector name attached to an element on a
page which can be used to target that element. You can use a simple
selector (class, ID, etc) or a selector path.
If you are using CSS IDs, ensure you start the ID with a #. For a CSS class name, start with a period or full stop(.). Examples: #myidname or .myclassname. For more information, see CSS Selector Process.
- Source code: Paste in relevant source code from the page under test as necessary.
- Screenshot: Click the Upload button, browse for and select the desired image file, then click Open. For more information, see Adding a Screenshot to an Issue.
- Recommendation Technique: Select a Recommendation type from the dropdown box. You can write your own recommendation technique to fix the issue, or select an alternative text as the image changes.
- Recommendation to Fix : In this free-form text entry field, type as desired to record any additional information not included in the Description field. This can include remediation advice. If you have selected the option, 'Select an alternative text as image changes' in the Recommendation Technique field, this field gets automatically filled with the details.
Check the Add another issue box to display another Add New Issue dialog box form upon saving the present one, if desired.
Click the Create Issue button.
The Add New Issue dialog box closes and the Checkpoint screen is refreshed to display a system response message to confirm the issue has been logged. Under the '# Issue logged.' message, two links appear. The left link text displays an automatically-assigned Issue number, followed by the Issue type in parenthesis. When clicked this link causes the Edit Issue dialog box to pop up, in which you can make modifications to existing field values. Additionally, a Delete link appears on the lower, right of the message which prompts you to confirm removal of the issue if necessary.
To delete an issue:
- Edit the issue you want to delete by clicking its associated link from either the...or the...area of the system. For more details, see Editing an Issue.
- On the Edit Issue <###> dialog box, click the Delete link in the footer area.
- Click the Yes, I'm Sure button (otherwise, click the Back to Edit Issue link if not).
Deleting Multiple Issues Simultaneously on the 'Issues for Test Run Name' Screen
Using the "select all issues" checkbox at the top, left of the issues table is limited to the current test run only. The multiple issues that are selected as a result of checking the box are only those that have been added to the currently-accessed test run.
On the 'Issues for...' screen, select as many checkboxes in the left column of the issues table as desired, then click the down arrow to the right of the Export button label, then click on the Delete item in the drop-down menu.
On the confirmation prompt popup window, click the Delete Issues button (or Cancel if unsure).
A system response message at the top, right notifies you of success: