Tutorials for the Harper Web Team on how to resolve issues flagged in SiteImprove.
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.
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:
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 tag. For example:
<h2> </h2>
<p> </p>
<div> </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:
Sometimes pages have a vague-sounding title, but that do describe the page. Examples:
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.
Pages will be flagged with Link Missing a Text Alternative for a couple of reasons.