SiteImprove Issues

Pages listed under the Code Cleaner Policy will often have excess code from Microsoft Word or Outlook pasted in. To remove that excess code, copy the page's HTML code and paste it into the Code Cleaner app. Click "Clean" then "Swap" then "Clean" again, which will remove most of the excess code on the page. Copy the cleaned code and paste it back into the page.

All YouTube videos need to be embedded using the YouTube Embed component. To fix pages flagged as Migrate YouTube Embed to Component in SiteImprove, follow these steps:

1. Open the YouTube video in a new tab (right click on Watch on YouTube > Open in New Tab)
2. Edit the Harper Web Page, then click on the YouTube video and hit delete
3. Click on the Components icon and insert a YouTube Embed 
4. For Video Title, copy the title from the YouTube video that you have open in another tab.
5. For Video ID, copy the video's unique ID from the URL. It is a string of letters and numbers that appears after this part of the URL: https://www.youtube.com/watch?v=
   (Note: If you see an & in the URL, don't copy the & or anything after it. We just need the unique ID.)
6. For Width, choose 600 from the dropdown.
7. Click Save and make sure the video is correct in preview, and then Check In and Publish.

Safelinks are alternate versions of a URL used by Outlook. Sometimes these get pasted into a web page. Linking to a safelink instead of a true URL breaks our Google Analytis tracking. To resolve an issue flagged by the Safelinks Policy in SiteImprove:

• Click on the link on the live site.
• After the page loads, copy the destination page's URL.
• In Modern Campus, edit the link and paste the destination page's URL in the URL field.

When a page is flagged with the Container Element Is Empty, there is often a <div> with no content on the page, or there is a <ul> list container nested within another <ul>. To resolve this, simply delete the empty div or the extra <ul> tags.

Div container example

<div></div>

List example

<ul>
<ul>
<li>Item 1</li>
<li>Item 2</li>
</ul>
</ul> 

A page will often be flagged under the Empty Headings issue if the user hits "Return" to create an extra space before or after a header. 

To resolve this issue, go into the code and look for and remove any blank lines. They are usually elements that only contain a &nbsp; tag. For example:

<h2>&nbsp;</h2>
<p>&nbsp;</p>
<div>&nbsp;</div>

The Heading is Not Descriptive issue will list pages that AI determines to have potentially vague page titles. These will require you to review the title and determine if the heading is, in fact, sufficiently descriptive. Examples of vague titles and how you might rewrite them:

• Degree --> Degree in Fashion Studies
• Form --> Library Forms
• Contact Us --> Contact the Financial Aid Office

Sometimes pages have a vague-sounding title, but that do describe the page. Examples:

• Academic Departments
• Acceptable Use Policy
• Education Degrees

To remove the flag on a page with a sufficiently descriptive title, in the left sidebar, click on the pencil icon next to the label "Note that this occurrence is based on a guided review." Then answer the question, "Yes" 

Pages with headings that are not correctly nested will be flagged as Headings Are Not Structured. 

• If the issue is occuring in an editable region of the page and it is NOT within a component, update the headings to follow a logical structure. Visit the Headings page for more information.
• Sometimes, the issue will occur in a component. In this case, there are two options.
  1. Create a heading before the component that would be fit with the logical structure. For instance, if the component uses <h3> headings, you can add a <h2> heading before the component to resolve the error.
  2. If adding a heading would cause other issues, flag the issue in the Quality Issues form. NOTE: If the same issue is affecting multiple pages, you only need to fill out the Quality Issues form once and include an example.

Pages will be flagged with Link Missing a Text Alternative for a couple of reasons.

• For page where the missing link text is in the breadcrumb trail near the top of the page, that indicates that a breadcrumb file is missing from the directory where the page lives. Often, several pages in the same directory will be logged. To resolve, copy a breadcrumb from another directory, update it for that directory, save and republish all of the webpages in that directory.
• For pages where the missing link text is elsewhere, try to determine if the issue is within an editable region, and if so, ask for help if you're not sure how to resolve it. 
• For pages where the missing link text is NOT in an editable region, submit a ticket on the Quality Issues form. NOTE: If the same issue is affecting multiple pages, you only need to fill out the Quality Issues form once and include an example.