From b0df777b09048ab8bca9d2a9a0b453b376984b67 Mon Sep 17 00:00:00 2001
From: Even Stensberg <evenstensberg@gmail.com>
Date: Sat, 8 Jul 2017 01:40:58 +0200
Subject: [PATCH] Add failureDescription to audit. display on fail (#2478)

---
 lighthouse-core/audits/accessibility/accesskeys.js       | 1 +
 .../audits/accessibility/aria-allowed-attr.js            | 1 +
 .../audits/accessibility/aria-required-attr.js           | 1 +
 .../audits/accessibility/aria-required-children.js       | 4 +++-
 .../audits/accessibility/aria-required-parent.js         | 1 +
 lighthouse-core/audits/accessibility/aria-roles.js       | 1 +
 .../audits/accessibility/aria-valid-attr-value.js        | 1 +
 lighthouse-core/audits/accessibility/aria-valid-attr.js  | 1 +
 lighthouse-core/audits/accessibility/audio-caption.js    | 2 ++
 lighthouse-core/audits/accessibility/button-name.js      | 1 +
 lighthouse-core/audits/accessibility/bypass.js           | 1 +
 lighthouse-core/audits/accessibility/color-contrast.js   | 2 ++
 lighthouse-core/audits/accessibility/definition-list.js  | 4 +++-
 lighthouse-core/audits/accessibility/dlitem.js           | 1 +
 lighthouse-core/audits/accessibility/document-title.js   | 1 +
 lighthouse-core/audits/accessibility/duplicate-id.js     | 1 +
 lighthouse-core/audits/accessibility/frame-title.js      | 1 +
 lighthouse-core/audits/accessibility/html-has-lang.js    | 1 +
 lighthouse-core/audits/accessibility/html-lang-valid.js  | 2 ++
 lighthouse-core/audits/accessibility/image-alt.js        | 1 +
 lighthouse-core/audits/accessibility/input-image-alt.js  | 1 +
 lighthouse-core/audits/accessibility/label.js            | 1 +
 lighthouse-core/audits/accessibility/layout-table.js     | 2 ++
 lighthouse-core/audits/accessibility/link-name.js        | 1 +
 lighthouse-core/audits/accessibility/list.js             | 2 ++
 lighthouse-core/audits/accessibility/listitem.js         | 2 ++
 lighthouse-core/audits/accessibility/meta-refresh.js     | 1 +
 lighthouse-core/audits/accessibility/meta-viewport.js    | 2 ++
 lighthouse-core/audits/accessibility/object-alt.js       | 1 +
 lighthouse-core/audits/accessibility/tabindex.js         | 1 +
 lighthouse-core/audits/accessibility/td-headers-attr.js  | 2 ++
 .../audits/accessibility/th-has-data-cells.js            | 2 ++
 lighthouse-core/audits/accessibility/valid-lang.js       | 1 +
 lighthouse-core/audits/accessibility/video-caption.js    | 2 ++
 .../audits/accessibility/video-description.js            | 2 ++
 lighthouse-core/audits/audit.js                          | 9 +++++++--
 .../audits/byte-efficiency/total-byte-weight.js          | 1 +
 lighthouse-core/audits/cache-start-url.js                | 1 +
 lighthouse-core/audits/content-width.js                  | 1 +
 lighthouse-core/audits/deprecations.js                   | 1 +
 lighthouse-core/audits/dobetterweb/appcache-manifest.js  | 1 +
 lighthouse-core/audits/dobetterweb/dom-size.js           | 3 ++-
 .../dobetterweb/external-anchors-use-rel-noopener.js     | 1 +
 .../audits/dobetterweb/geolocation-on-start.js           | 1 +
 lighthouse-core/audits/dobetterweb/no-document-write.js  | 1 +
 lighthouse-core/audits/dobetterweb/no-mutation-events.js | 1 +
 lighthouse-core/audits/dobetterweb/no-old-flexbox.js     | 1 +
 lighthouse-core/audits/dobetterweb/no-websql.js          | 1 +
 .../audits/dobetterweb/notification-on-start.js          | 1 +
 .../dobetterweb/password-inputs-can-be-pasted-into.js    | 3 ++-
 lighthouse-core/audits/dobetterweb/uses-http2.js         | 1 +
 .../audits/dobetterweb/uses-passive-event-listeners.js   | 1 +
 lighthouse-core/audits/is-on-https.js                    | 1 +
 lighthouse-core/audits/load-fast-enough-for-pwa.js       | 1 +
 lighthouse-core/audits/manifest-short-name-length.js     | 2 ++
 lighthouse-core/audits/redirects-http.js                 | 1 +
 lighthouse-core/audits/service-worker.js                 | 1 +
 lighthouse-core/audits/splash-screen.js                  | 5 ++---
 lighthouse-core/audits/themed-omnibox.js                 | 3 ++-
 lighthouse-core/audits/viewport.js                       | 2 ++
 lighthouse-core/audits/webapp-install-banner.js          | 1 +
 lighthouse-core/audits/without-javascript.js             | 1 +
 lighthouse-core/audits/works-offline.js                  | 1 +
 lighthouse-core/config/config.js                         | 7 +++++++
 64 files changed, 97 insertions(+), 10 deletions(-)

diff --git a/lighthouse-core/audits/accessibility/accesskeys.js b/lighthouse-core/audits/accessibility/accesskeys.js
index f2eb578fa7af..b843bf4506f1 100644
--- a/lighthouse-core/audits/accessibility/accesskeys.js
+++ b/lighthouse-core/audits/accessibility/accesskeys.js
@@ -21,6 +21,7 @@ class Accesskeys extends AxeAudit {
       category: 'Accessibility',
       name: 'accesskeys',
       description: '`[accesskey]` values are unique.',
+      failureDescription: '`[accesskey]` values are not unique.',
       helpText: 'Access keys let users quickly focus a part of the page. For proper ' +
           'navigation, each access key must be unique. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/accesskeys).',
diff --git a/lighthouse-core/audits/accessibility/aria-allowed-attr.js b/lighthouse-core/audits/accessibility/aria-allowed-attr.js
index 238daf5a681f..4a1f7e1452ad 100644
--- a/lighthouse-core/audits/accessibility/aria-allowed-attr.js
+++ b/lighthouse-core/audits/accessibility/aria-allowed-attr.js
@@ -21,6 +21,7 @@ class ARIAAllowedAttr extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-allowed-attr',
       description: '`[aria-*]` attributes match their roles.',
+      failureDescription: '`[aria-*]` attributes do not match their roles.',
       helpText: 'Each ARIA `role` supports a specific subset of `aria-*` attributes. ' +
           'Mismatching these invalidates the `aria-*` attributes. [Learn ' +
           'more](https://developers.google.com/web/tools/lighthouse/audits/aria-allowed-attributes).',
diff --git a/lighthouse-core/audits/accessibility/aria-required-attr.js b/lighthouse-core/audits/accessibility/aria-required-attr.js
index 280e062d1433..8bd463a993d3 100644
--- a/lighthouse-core/audits/accessibility/aria-required-attr.js
+++ b/lighthouse-core/audits/accessibility/aria-required-attr.js
@@ -21,6 +21,7 @@ class ARIARequiredAttr extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-required-attr',
       description: '`[role]`s have all required `[aria-*]` attributes.',
+      failureDescription: '`[role]`s do not have all required `[aria-*]` attributes.',
       helpText: 'Some ARIA roles have required attributes that describe the state ' +
           'of the element to screen readers. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/required-aria-attributes).',
       requiredArtifacts: ['Accessibility']
diff --git a/lighthouse-core/audits/accessibility/aria-required-children.js b/lighthouse-core/audits/accessibility/aria-required-children.js
index 2b331aba1856..0de501aaaaac 100644
--- a/lighthouse-core/audits/accessibility/aria-required-children.js
+++ b/lighthouse-core/audits/accessibility/aria-required-children.js
@@ -21,7 +21,9 @@ class AriaRequiredChildren extends AxeAudit {
     return {
       category: 'Accessibility',
       name: 'aria-required-children',
-      description: '`[role]`s that require child `[role]`s contain them.',
+      description: 'Elements with `[role]` that require specific children `[role]`s, are present.',
+      failureDescription: 'Elements with `[role]` that require specific children `[role]`s, ' +
+          'are missing.',
       helpText: 'Some ARIA parent roles must contain specific child roles to perform ' +
           'their intended accessibility functions. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/aria-required-children).',
diff --git a/lighthouse-core/audits/accessibility/aria-required-parent.js b/lighthouse-core/audits/accessibility/aria-required-parent.js
index acc0289d6ea0..2b1a8f6ccd90 100644
--- a/lighthouse-core/audits/accessibility/aria-required-parent.js
+++ b/lighthouse-core/audits/accessibility/aria-required-parent.js
@@ -22,6 +22,7 @@ class AriaRequiredParent extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-required-parent',
       description: '`[role]`s are contained by their required parent element.',
+      failureDescription: '`[role]`s are not contained by their required parent element.',
       helpText: 'Some ARIA child roles must be contained by specific parent roles to ' +
           'properly perform their intended accessibility functions. ' +
           '[Learn more](https://dequeuniversity.com/rules/worldspace/2.1/aria-required-parent).',
diff --git a/lighthouse-core/audits/accessibility/aria-roles.js b/lighthouse-core/audits/accessibility/aria-roles.js
index 6edd7b949eea..42e0f34dd315 100644
--- a/lighthouse-core/audits/accessibility/aria-roles.js
+++ b/lighthouse-core/audits/accessibility/aria-roles.js
@@ -21,6 +21,7 @@ class AriaRoles extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-roles',
       description: '`[role]` values are valid.',
+      failureDescription: '`[role]` values are not valid.',
       helpText: 'ARIA roles must have valid values in order to perform their ' +
           'intended accessibility functions. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/aria-roles).',
diff --git a/lighthouse-core/audits/accessibility/aria-valid-attr-value.js b/lighthouse-core/audits/accessibility/aria-valid-attr-value.js
index 9d3acad7b124..800babafba08 100644
--- a/lighthouse-core/audits/accessibility/aria-valid-attr-value.js
+++ b/lighthouse-core/audits/accessibility/aria-valid-attr-value.js
@@ -21,6 +21,7 @@ class ARIAValidAttr extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-valid-attr-value',
       description: '`[aria-*]` attributes have valid values.',
+      failureDescription: '`[aria-*]` attributes do not have valid values.',
       helpText: 'Assistive technologies, like screen readers, can\'t interpret ARIA ' +
           'attributes with invalid values. [Learn ' +
           'more](https://developers.google.com/web/tools/lighthouse/audits/valid-aria-values).',
diff --git a/lighthouse-core/audits/accessibility/aria-valid-attr.js b/lighthouse-core/audits/accessibility/aria-valid-attr.js
index 3ade59f76165..8aa3ea516680 100644
--- a/lighthouse-core/audits/accessibility/aria-valid-attr.js
+++ b/lighthouse-core/audits/accessibility/aria-valid-attr.js
@@ -21,6 +21,7 @@ class ARIAValidAttr extends AxeAudit {
       category: 'Accessibility',
       name: 'aria-valid-attr',
       description: '`[aria-*]` attributes are valid and not misspelled.',
+      failureDescription: '`[aria-*]` attributes are not valid or misspelled.',
       helpText: 'Assistive technologies, like screen readers, can\'t interpret ARIA ' +
           'attributes with invalid names. [Learn ' +
           'more](https://developers.google.com/web/tools/lighthouse/audits/valid-aria-attributes).',
diff --git a/lighthouse-core/audits/accessibility/audio-caption.js b/lighthouse-core/audits/accessibility/audio-caption.js
index 4841b4669468..b02b215dde72 100644
--- a/lighthouse-core/audits/accessibility/audio-caption.js
+++ b/lighthouse-core/audits/accessibility/audio-caption.js
@@ -21,6 +21,8 @@ class AudioCaption extends AxeAudit {
       category: 'Accessibility',
       name: 'audio-caption',
       description: '`<audio>` elements contain a `<track>` element with `[kind="captions"]`.',
+      failureDescription: '`<audio>` elements are missing a `<track>` element with ' +
+          '`[kind="captions"]`.',
       helpText: 'Captions make audio elements usable for deaf or hearing-impaired users, ' +
           'providing critical information such as who is talking, what they\'re saying, ' +
           'and other non-speech information. ' +
diff --git a/lighthouse-core/audits/accessibility/button-name.js b/lighthouse-core/audits/accessibility/button-name.js
index 20129981bf8a..8a1ed9a4f7da 100644
--- a/lighthouse-core/audits/accessibility/button-name.js
+++ b/lighthouse-core/audits/accessibility/button-name.js
@@ -21,6 +21,7 @@ class ButtonName extends AxeAudit {
       category: 'Accessibility',
       name: 'button-name',
       description: 'Buttons have an accessible name.',
+      failureDescription: 'Buttons do not have an accessible name.',
       helpText: 'When a button doesn\'t have an accessible name, screen readers announce it as ' +
           '"button", making it unusable for users who rely on screen readers. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/button-name).',
diff --git a/lighthouse-core/audits/accessibility/bypass.js b/lighthouse-core/audits/accessibility/bypass.js
index f6450d2f1677..b838461f4f4a 100644
--- a/lighthouse-core/audits/accessibility/bypass.js
+++ b/lighthouse-core/audits/accessibility/bypass.js
@@ -22,6 +22,7 @@ class Bypass extends AxeAudit {
       category: 'Accessibility',
       name: 'bypass',
       description: 'The page contains a heading, skip link, or landmark region.',
+      failureDescription: 'The page does not contain a heading, skip link, or landmark region.',
       helpText: 'Adding ways to bypass repetitive content lets keyboard users navigate the page ' +
           'more efficiently. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/bypass).',
diff --git a/lighthouse-core/audits/accessibility/color-contrast.js b/lighthouse-core/audits/accessibility/color-contrast.js
index d97986f646d0..304b78c93ae2 100644
--- a/lighthouse-core/audits/accessibility/color-contrast.js
+++ b/lighthouse-core/audits/accessibility/color-contrast.js
@@ -22,6 +22,8 @@ class ColorContrast extends AxeAudit {
       category: 'Accessibility',
       name: 'color-contrast',
       description: 'Background and foreground colors have a sufficient contrast ratio.',
+      failureDescription: 'Background and foreground colors do not have a ' +
+          'sufficient contrast ratio.',
       helpText: 'Low-contrast text is difficult or impossible for many users to read. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/contrast-ratio).',
       requiredArtifacts: ['Accessibility']
diff --git a/lighthouse-core/audits/accessibility/definition-list.js b/lighthouse-core/audits/accessibility/definition-list.js
index 426ca3d1c773..d82e17592861 100644
--- a/lighthouse-core/audits/accessibility/definition-list.js
+++ b/lighthouse-core/audits/accessibility/definition-list.js
@@ -21,7 +21,9 @@ class DefinitionList extends AxeAudit {
       category: 'Accessibility',
       name: 'definition-list',
       description: '`<dl>`\'s contain only properly-ordered `<dt>` and `<dd>` groups, `<script>` ' +
-          'or <template> elements.',
+          'or `<template>` elements.',
+      failureDescription: '`<dl>`\'s do not contain only properly-ordered `<dt>` and `<dd>` ' +
+          'groups, `<script>` or `<template>` elements.',
       helpText: 'When definition lists are not properly marked up, screen readers may produce ' +
           'confusing or inaccurate output. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/definition-list).',
diff --git a/lighthouse-core/audits/accessibility/dlitem.js b/lighthouse-core/audits/accessibility/dlitem.js
index 162adb5fa9d9..afd50970d147 100644
--- a/lighthouse-core/audits/accessibility/dlitem.js
+++ b/lighthouse-core/audits/accessibility/dlitem.js
@@ -21,6 +21,7 @@ class DLItem extends AxeAudit {
       category: 'Accessibility',
       name: 'dlitem',
       description: 'Definition list items are wrapped in `<dl>` elements.',
+      failureDescription: 'Definition list items are not wrapped in `<dl>` elements.',
       helpText: 'Definition list items (`<dt>` and `<dd>`) must be wrapped in a ' +
           'parent `<dl>` element to ensure that screen readers can properly announce them. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/dlitem).',
diff --git a/lighthouse-core/audits/accessibility/document-title.js b/lighthouse-core/audits/accessibility/document-title.js
index 687ab11f786d..d1f2f37b7e75 100644
--- a/lighthouse-core/audits/accessibility/document-title.js
+++ b/lighthouse-core/audits/accessibility/document-title.js
@@ -21,6 +21,7 @@ class DocumentTitle extends AxeAudit {
       category: 'Accessibility',
       name: 'document-title',
       description: 'Document has a `<title>` element.',
+      failureDescription: 'Document does not have a `<title>` element.',
       helpText: 'Screen reader users use page titles to get an overview of the contents of ' +
           'the page. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/document-title).',
diff --git a/lighthouse-core/audits/accessibility/duplicate-id.js b/lighthouse-core/audits/accessibility/duplicate-id.js
index 52eed41532bc..c8933f6b8f68 100644
--- a/lighthouse-core/audits/accessibility/duplicate-id.js
+++ b/lighthouse-core/audits/accessibility/duplicate-id.js
@@ -21,6 +21,7 @@ class DuplicateId extends AxeAudit {
       category: 'Accessibility',
       name: 'duplicate-id',
       description: '`[id]` attributes on the page are unique.',
+      failureDescription: '`[id]` attributes on the page are not unique.',
       helpText: 'The value of an id attribute must be unique to prevent ' +
           'other instances from being overlooked by assistive technologies. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/duplicate-id).',
diff --git a/lighthouse-core/audits/accessibility/frame-title.js b/lighthouse-core/audits/accessibility/frame-title.js
index 6912e057c339..4b5d75279e7e 100644
--- a/lighthouse-core/audits/accessibility/frame-title.js
+++ b/lighthouse-core/audits/accessibility/frame-title.js
@@ -21,6 +21,7 @@ class FrameTitle extends AxeAudit {
       category: 'Accessibility',
       name: 'frame-title',
       description: '`<frame>` or `<iframe>` elements have a title.',
+      failureDescription: '`<frame>` or `<iframe>` elements do not have a title.',
       helpText: 'Screen reader users rely on frame titles to describe the contents of frames. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/frame-title).',
       requiredArtifacts: ['Accessibility']
diff --git a/lighthouse-core/audits/accessibility/html-has-lang.js b/lighthouse-core/audits/accessibility/html-has-lang.js
index 94676ab05216..11b91fa9f8a3 100644
--- a/lighthouse-core/audits/accessibility/html-has-lang.js
+++ b/lighthouse-core/audits/accessibility/html-has-lang.js
@@ -21,6 +21,7 @@ class HTMLHasLang extends AxeAudit {
       category: 'Accessibility',
       name: 'html-has-lang',
       description: '`<html>` element has a `[lang]` attribute.',
+      failureDescription: '`<html>` element does not have a `[lang]` attribute.',
       helpText: 'If a page doesn\'t specify a lang attribute, a screen reader assumes ' +
           'that the page is in the default language that the user chose when setting up the ' +
           'screen reader. If the page isn\'t actually in the default language, then the screen ' +
diff --git a/lighthouse-core/audits/accessibility/html-lang-valid.js b/lighthouse-core/audits/accessibility/html-lang-valid.js
index 7c854a55c7c0..bb59301057e5 100644
--- a/lighthouse-core/audits/accessibility/html-lang-valid.js
+++ b/lighthouse-core/audits/accessibility/html-lang-valid.js
@@ -21,6 +21,8 @@ class HTMLLangValid extends AxeAudit {
       category: 'Accessibility',
       name: 'html-lang-valid',
       description: '`<html>` element has a valid value for its `[lang]` attribute.',
+      failureDescription: '`<html>` element does not have a valid value for ' +
+          'its `[lang]` attribute.',
       helpText: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
           'helps screen readers announce text properly. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/valid-lang).',
diff --git a/lighthouse-core/audits/accessibility/image-alt.js b/lighthouse-core/audits/accessibility/image-alt.js
index b2b51212dbd7..a05182302727 100644
--- a/lighthouse-core/audits/accessibility/image-alt.js
+++ b/lighthouse-core/audits/accessibility/image-alt.js
@@ -21,6 +21,7 @@ class ImageAlt extends AxeAudit {
       category: 'Accessibility',
       name: 'image-alt',
       description: 'Image elements have `[alt]` attributes.',
+      failureDescription: 'Image elements do not have `[alt]` attributes.',
       helpText: 'Informative elements should aim for short, descriptive alternate text. ' +
           'Decorative elements can be ignored with an empty alt attribute.' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/alt-attribute).',
diff --git a/lighthouse-core/audits/accessibility/input-image-alt.js b/lighthouse-core/audits/accessibility/input-image-alt.js
index d92140fe6e2e..e7b209f04ef2 100644
--- a/lighthouse-core/audits/accessibility/input-image-alt.js
+++ b/lighthouse-core/audits/accessibility/input-image-alt.js
@@ -21,6 +21,7 @@ class InputImageAlt extends AxeAudit {
       category: 'Accessibility',
       name: 'input-image-alt',
       description: '`<input type="image">` elements have `[alt]` text.',
+      failureDescription: '`<input type="image">` elements do not have `[alt]` text.',
       helpText: 'When an image is being used as an `<input>` button, providing alternative text ' +
           'can help screen reader users understand the purpose of the button. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/input-image-alt).',
diff --git a/lighthouse-core/audits/accessibility/label.js b/lighthouse-core/audits/accessibility/label.js
index 215b653e2f4b..d1d680b043fd 100644
--- a/lighthouse-core/audits/accessibility/label.js
+++ b/lighthouse-core/audits/accessibility/label.js
@@ -21,6 +21,7 @@ class Label extends AxeAudit {
       category: 'Accessibility',
       name: 'label',
       description: 'Form elements have associated labels.',
+      failureDescription: 'Form elements do not have associated labels.',
       helpText: 'Labels ensure that form controls are announced properly by assistive ' +
           'technologies, like screen readers. [Learn ' +
           'more](https://developers.google.com/web/tools/lighthouse/audits/form-labels).',
diff --git a/lighthouse-core/audits/accessibility/layout-table.js b/lighthouse-core/audits/accessibility/layout-table.js
index 6feb157f6a9c..c032a6bef011 100644
--- a/lighthouse-core/audits/accessibility/layout-table.js
+++ b/lighthouse-core/audits/accessibility/layout-table.js
@@ -23,6 +23,8 @@ class LayoutTable extends AxeAudit {
       name: 'layout-table',
       description: 'Presentational `<table>` elements avoid using `<th>`, `<caption>` or the ' +
           '`[summary]` attribute.',
+      failureDescription: 'Presentational `<table>` elements do not avoid using `<th>`, ' +
+          '`<caption>` or the `[summary]` attribute.',
       helpText: 'A table being used for layout purposes should not include data elements, ' +
           'such as the th or caption elements or the summary attribute, because this can ' +
           'create a confusing experience for screen reader users. ' +
diff --git a/lighthouse-core/audits/accessibility/link-name.js b/lighthouse-core/audits/accessibility/link-name.js
index f457b207eaac..286b3adbd638 100644
--- a/lighthouse-core/audits/accessibility/link-name.js
+++ b/lighthouse-core/audits/accessibility/link-name.js
@@ -21,6 +21,7 @@ class LinkName extends AxeAudit {
       category: 'Accessibility',
       name: 'link-name',
       description: 'Links have a discernible name.',
+      failureDescription: 'Links do not have a discernable name.',
       helpText: 'Link text (and alternate text for images, when used as links) that is ' +
           'discernible, unique, and focusable improves the navigation experience for ' +
           'screen reader users. ' +
diff --git a/lighthouse-core/audits/accessibility/list.js b/lighthouse-core/audits/accessibility/list.js
index e3b01dedeccd..c71cd97a7062 100644
--- a/lighthouse-core/audits/accessibility/list.js
+++ b/lighthouse-core/audits/accessibility/list.js
@@ -22,6 +22,8 @@ class List extends AxeAudit {
       name: 'list',
       description: 'Lists contain only `<li>` elements and script supporting elements ' +
           '(`<script>` and `<template>`).',
+      failureDescription: 'Lists do not contain only `<li>` elements and script ' +
+          'supporting elements (`<script>` and `<template>`).',
       helpText: 'Screen readers have a specific way of announcing lists. Ensuring proper list ' +
           'structure aids screen reader output. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/list).',
diff --git a/lighthouse-core/audits/accessibility/listitem.js b/lighthouse-core/audits/accessibility/listitem.js
index 355e4247d4bb..f1ebffb06867 100644
--- a/lighthouse-core/audits/accessibility/listitem.js
+++ b/lighthouse-core/audits/accessibility/listitem.js
@@ -21,6 +21,8 @@ class ListItem extends AxeAudit {
       category: 'Accessibility',
       name: 'listitem',
       description: 'List items (`<li>`) are contained within `<ul>` or `<ol>` parent elements.',
+      failureDescription: 'List items (`<li>`) are not contained within `<ul>` ' +
+          'or `<ol>` parent elements.',
       helpText: 'Screen readers require list items (`<li>`) to be contained within a ' +
           'parent `<ul>` or `<ol>` to be announced properly. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/listitem).',
diff --git a/lighthouse-core/audits/accessibility/meta-refresh.js b/lighthouse-core/audits/accessibility/meta-refresh.js
index 9a89878c996e..03d923cf73e9 100644
--- a/lighthouse-core/audits/accessibility/meta-refresh.js
+++ b/lighthouse-core/audits/accessibility/meta-refresh.js
@@ -21,6 +21,7 @@ class MetaRefresh extends AxeAudit {
       category: 'Accessibility',
       name: 'meta-refresh',
       description: 'The document does not use `<meta http-equiv="refresh">`.',
+      failureDescription: 'The document uses `<meta http-equiv="refresh">`.',
       helpText: 'Users do not expect a page to refresh automatically, and doing so will move ' +
           'focus back to the top of the page. This may create a frustrating or ' +
           'confusing experience. ' +
diff --git a/lighthouse-core/audits/accessibility/meta-viewport.js b/lighthouse-core/audits/accessibility/meta-viewport.js
index b0be994b353a..68221dd522e0 100644
--- a/lighthouse-core/audits/accessibility/meta-viewport.js
+++ b/lighthouse-core/audits/accessibility/meta-viewport.js
@@ -22,6 +22,8 @@ class MetaViewport extends AxeAudit {
       name: 'meta-viewport',
       description: '`[user-scalable="no"]` is not used in the `<meta name="viewport">` ' +
           'element and the `[maximum-scale]` attribute is not less than 5.',
+      failureDescription: '`[user-scalable="no"]` is used in the `<meta name="viewport">` ' +
+          'element or the `[maximum-scale]` attribute is less than 5.',
       helpText: 'Disabling zooming is problematic for users with low vision who rely on screen ' +
           'magnification to properly see the contents of a web page. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/meta-viewport).',
diff --git a/lighthouse-core/audits/accessibility/object-alt.js b/lighthouse-core/audits/accessibility/object-alt.js
index bb7be687ad61..3dd8b55fa2a1 100644
--- a/lighthouse-core/audits/accessibility/object-alt.js
+++ b/lighthouse-core/audits/accessibility/object-alt.js
@@ -21,6 +21,7 @@ class ObjectAlt extends AxeAudit {
       category: 'Accessibility',
       name: 'object-alt',
       description: '`<object>` elements have `[alt]` text.',
+      failureDescription: '`<object>` elements do not have `[alt]` text.',
       helpText: 'Screen readers cannot translate non-text content. Adding alt text to `<object>` ' +
           'elements helps screen readers convey meaning to users. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/object-alt).',
diff --git a/lighthouse-core/audits/accessibility/tabindex.js b/lighthouse-core/audits/accessibility/tabindex.js
index 073a4b76e733..649cde3c5e4f 100644
--- a/lighthouse-core/audits/accessibility/tabindex.js
+++ b/lighthouse-core/audits/accessibility/tabindex.js
@@ -21,6 +21,7 @@ class TabIndex extends AxeAudit {
       category: 'Accessibility',
       name: 'tabindex',
       description: 'No element has a `[tabindex]` value greater than 0.',
+      failureDescription: 'Some elements have a `[tabindex]` value greater than 0.',
       helpText: 'A value greater than 0 implies an explicit navigation ordering. ' +
           'Although technically valid, this often creates frustrating experiences ' +
           'for users who rely on assistive technologies. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/tabindex).',
diff --git a/lighthouse-core/audits/accessibility/td-headers-attr.js b/lighthouse-core/audits/accessibility/td-headers-attr.js
index 3fc7ba48b3b6..7b74b3b37cfe 100644
--- a/lighthouse-core/audits/accessibility/td-headers-attr.js
+++ b/lighthouse-core/audits/accessibility/td-headers-attr.js
@@ -23,6 +23,8 @@ class TDHeadersAttr extends AxeAudit {
       name: 'td-headers-attr',
       description: 'Cells in a `<table>` element that use the `[headers]` attribute only refer ' +
           'to other cells of that same table.',
+      failureDescription: 'Cells in a `<table>` element that use the `[headers]` ' +
+          'attribute refers to other cells of that same table.',
       helpText: 'Screen readers have features to make navigating tables easier. Ensuring `<td>` ' +
           'cells using the `[headers]` attribute only refer to other cells in the same table may ' +
           'improve the experience for screen reader users. ' +
diff --git a/lighthouse-core/audits/accessibility/th-has-data-cells.js b/lighthouse-core/audits/accessibility/th-has-data-cells.js
index facf0f4aefb8..1ca261891d82 100644
--- a/lighthouse-core/audits/accessibility/th-has-data-cells.js
+++ b/lighthouse-core/audits/accessibility/th-has-data-cells.js
@@ -22,6 +22,8 @@ class THHasDataCells extends AxeAudit {
       name: 'th-has-data-cells',
       description: '`<th>` elements and elements with `[role="columnheader"/"rowheader"]` have ' +
           'data cells they describe.',
+      failureDescription: '`<th>` elements and elements with ' +
+          '`[role="columnheader"/"rowheader"]` do not have data cells they describe.',
       helpText: 'Screen readers have features to make navigating tables easier. Ensuring table ' +
           'headers always refer to some set of cells may improve the experience for screen ' +
           'reader users. ' +
diff --git a/lighthouse-core/audits/accessibility/valid-lang.js b/lighthouse-core/audits/accessibility/valid-lang.js
index 880b6eb1164b..6a4a180f589d 100644
--- a/lighthouse-core/audits/accessibility/valid-lang.js
+++ b/lighthouse-core/audits/accessibility/valid-lang.js
@@ -21,6 +21,7 @@ class ValidLang extends AxeAudit {
       category: 'Accessibility',
       name: 'valid-lang',
       description: '`[lang]` attributes have a valid value.',
+      failureDescription: '`[lang]` attributes do not have a valid value.',
       helpText: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
           'on elements helps ensure that text is pronounced correctly by a screen reader. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/valid-lang).',
diff --git a/lighthouse-core/audits/accessibility/video-caption.js b/lighthouse-core/audits/accessibility/video-caption.js
index 2fd45d5a6b09..4a8947a1eac4 100644
--- a/lighthouse-core/audits/accessibility/video-caption.js
+++ b/lighthouse-core/audits/accessibility/video-caption.js
@@ -21,6 +21,8 @@ class VideoCaption extends AxeAudit {
       category: 'Accessibility',
       name: 'video-caption',
       description: '`<video>` elements contain a `<track>` element with `[kind="captions"]`.',
+      failureDescription: '`<video>` elements do not contain a `<track>` element ' +
+          'with `[kind="captions"]`.',
       helpText: 'When a video provides a caption it is easier for deaf and hearing impaired ' +
           'users to access its information. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/video-caption).',
diff --git a/lighthouse-core/audits/accessibility/video-description.js b/lighthouse-core/audits/accessibility/video-description.js
index 690e2dcb9e68..28796eb6b032 100644
--- a/lighthouse-core/audits/accessibility/video-description.js
+++ b/lighthouse-core/audits/accessibility/video-description.js
@@ -21,6 +21,8 @@ class VideoDescription extends AxeAudit {
       category: 'Accessibility',
       name: 'video-description',
       description: '`<video>` elements contain a `<track>` element with `[kind="description"]`.',
+      failureDescription: '`<video>` elements do not contain a `<track>` element with ' +
+          '`[kind="description"]`.',
       helpText: 'Audio descriptions provide relevant information for videos that dialogue ' +
           'cannot, such as facial expressions and scenes. ' +
           '[Learn more](https://dequeuniversity.com/rules/axe/1.1/video-description).',
diff --git a/lighthouse-core/audits/audit.js b/lighthouse-core/audits/audit.js
index 0e93fe3f595e..b0b2361484eb 100644
--- a/lighthouse-core/audits/audit.js
+++ b/lighthouse-core/audits/audit.js
@@ -115,7 +115,12 @@ class Audit {
     if (displayValue === score) {
       displayValue = '';
     }
-
+    let auditDescription = audit.meta.description;
+    if (audit.meta.failureDescription) {
+      if (!score || (typeof score === 'number' && score < 100)) {
+        auditDescription = audit.meta.failureDescription;
+      }
+    }
     return {
       score,
       displayValue: `${displayValue}`,
@@ -129,7 +134,7 @@ class Audit {
       manual: audit.meta.manual,
       name: audit.meta.name,
       category: audit.meta.category,
-      description: audit.meta.description,
+      description: auditDescription,
       helpText: audit.meta.helpText,
       details: result.details,
     };
diff --git a/lighthouse-core/audits/byte-efficiency/total-byte-weight.js b/lighthouse-core/audits/byte-efficiency/total-byte-weight.js
index beb2ce0a677e..ea56c205216e 100644
--- a/lighthouse-core/audits/byte-efficiency/total-byte-weight.js
+++ b/lighthouse-core/audits/byte-efficiency/total-byte-weight.js
@@ -27,6 +27,7 @@ class TotalByteWeight extends ByteEfficiencyAudit {
       name: 'total-byte-weight',
       optimalValue: `< ${this.bytesToKbString(OPTIMAL_VALUE)}`,
       description: 'Avoids enormous network payloads',
+      failureDescription: 'Has enormous network payloads',
       helpText:
           'Network transfer size [costs users real money](https://whatdoesmysitecost.com/) ' +
           'and is [highly correlated](http://httparchive.org/interesting.php#onLoad) with long load times. ' +
diff --git a/lighthouse-core/audits/cache-start-url.js b/lighthouse-core/audits/cache-start-url.js
index 6204e8ec7047..79e7f58b80da 100644
--- a/lighthouse-core/audits/cache-start-url.js
+++ b/lighthouse-core/audits/cache-start-url.js
@@ -16,6 +16,7 @@ class CacheStartUrl extends Audit {
       category: 'Manifest',
       name: 'cache-start-url',
       description: 'Cache contains start_url from manifest (alpha)',
+      failureDescription: 'Cache does not contain start_url from manifest (alpha)',
       requiredArtifacts: ['CacheContents', 'Manifest', 'URL']
     };
   }
diff --git a/lighthouse-core/audits/content-width.js b/lighthouse-core/audits/content-width.js
index 793470a21faa..beaf04272890 100644
--- a/lighthouse-core/audits/content-width.js
+++ b/lighthouse-core/audits/content-width.js
@@ -16,6 +16,7 @@ class ContentWidth extends Audit {
       category: 'Mobile Friendly',
       name: 'content-width',
       description: 'Content is sized correctly for the viewport',
+      failureDescription: 'Content is not sized correctly for the viewport',
       helpText: 'If the width of your app\'s content doesn\'t match the width ' +
           'of the viewport, your app might not be optimized for mobile screens. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/content-sized-correctly-for-viewport).',
diff --git a/lighthouse-core/audits/deprecations.js b/lighthouse-core/audits/deprecations.js
index 9163511bd96e..4a6a3bc1964d 100644
--- a/lighthouse-core/audits/deprecations.js
+++ b/lighthouse-core/audits/deprecations.js
@@ -23,6 +23,7 @@ class Deprecations extends Audit {
       category: 'Deprecations',
       name: 'deprecations',
       description: 'Avoids deprecated APIs',
+      failureDescription: 'Uses deprecated API\'s',
       helpText: 'Deprecated APIs will eventually be removed from the browser. ' +
           '[Learn more](https://www.chromestatus.com/features#deprecated).',
       requiredArtifacts: ['ChromeConsoleMessages']
diff --git a/lighthouse-core/audits/dobetterweb/appcache-manifest.js b/lighthouse-core/audits/dobetterweb/appcache-manifest.js
index 45e1e179a4af..4b0245070d37 100644
--- a/lighthouse-core/audits/dobetterweb/appcache-manifest.js
+++ b/lighthouse-core/audits/dobetterweb/appcache-manifest.js
@@ -22,6 +22,7 @@ class AppCacheManifestAttr extends Audit {
       category: 'Offline',
       name: 'appcache-manifest',
       description: 'Avoids Application Cache',
+      failureDescription: 'Uses Application Cache',
       helpText: 'Application Cache is deprecated. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/appcache).',
       requiredArtifacts: ['AppCacheManifest']
diff --git a/lighthouse-core/audits/dobetterweb/dom-size.js b/lighthouse-core/audits/dobetterweb/dom-size.js
index 0e9686095c50..5d10e8d1c25f 100644
--- a/lighthouse-core/audits/dobetterweb/dom-size.js
+++ b/lighthouse-core/audits/dobetterweb/dom-size.js
@@ -37,7 +37,8 @@ class DOMSize extends Audit {
       category: 'Performance',
       name: 'dom-size',
       description: 'Avoids an excessive DOM size',
-      optimalValue: `< ${Util.formatNumber(DOMSize.MAX_DOM_NODES)} nodes`,
+      failureDescription: 'Uses an excessive DOM size',
+      optimalValue: `< ${DOMSize.MAX_DOM_NODES.toLocaleString()} nodes`,
       helpText: 'Browser engineers recommend pages contain fewer than ' +
         `~${Util.formatNumber(DOMSize.MAX_DOM_NODES)} DOM nodes. The sweet spot is a tree ` +
         `depth < ${MAX_DOM_TREE_DEPTH} elements and fewer than ${MAX_DOM_TREE_WIDTH} ` +
diff --git a/lighthouse-core/audits/dobetterweb/external-anchors-use-rel-noopener.js b/lighthouse-core/audits/dobetterweb/external-anchors-use-rel-noopener.js
index dc60b370fb74..a2809b935cd5 100644
--- a/lighthouse-core/audits/dobetterweb/external-anchors-use-rel-noopener.js
+++ b/lighthouse-core/audits/dobetterweb/external-anchors-use-rel-noopener.js
@@ -17,6 +17,7 @@ class ExternalAnchorsUseRelNoopenerAudit extends Audit {
       category: 'Performance',
       name: 'external-anchors-use-rel-noopener',
       description: 'Opens external anchors using `rel="noopener"`',
+      failureDescription: 'Does not open external anchors using `rel="noopener"`',
       helpText: 'Open new tabs using `rel="noopener"` to improve performance and ' +
           'prevent security vulnerabilities. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/noopener).',
diff --git a/lighthouse-core/audits/dobetterweb/geolocation-on-start.js b/lighthouse-core/audits/dobetterweb/geolocation-on-start.js
index cd8bbb7f5d7e..bb9e5df8ae9e 100644
--- a/lighthouse-core/audits/dobetterweb/geolocation-on-start.js
+++ b/lighthouse-core/audits/dobetterweb/geolocation-on-start.js
@@ -22,6 +22,7 @@ class GeolocationOnStart extends ViolationAudit {
       category: 'UX',
       name: 'geolocation-on-start',
       description: 'Avoids requesting the geolocation permission on page load',
+      failureDescription: 'Requests the geolocation permission on page load',
       helpText: 'Users are mistrustful of or confused by sites that request their ' +
           'location without context. Consider tying the request to user gestures instead. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/geolocation-on-load).',
diff --git a/lighthouse-core/audits/dobetterweb/no-document-write.js b/lighthouse-core/audits/dobetterweb/no-document-write.js
index 041606b16a31..213ab264ebc3 100644
--- a/lighthouse-core/audits/dobetterweb/no-document-write.js
+++ b/lighthouse-core/audits/dobetterweb/no-document-write.js
@@ -22,6 +22,7 @@ class NoDocWriteAudit extends ViolationAudit {
       category: 'Performance',
       name: 'no-document-write',
       description: 'Avoids `document.write()`',
+      failureDescription: 'Uses `document.write()`',
       helpText: 'For users on slow connections, external scripts dynamically injected via ' +
           '`document.write()` can delay page load by tens of seconds. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/document-write).',
diff --git a/lighthouse-core/audits/dobetterweb/no-mutation-events.js b/lighthouse-core/audits/dobetterweb/no-mutation-events.js
index d39dc099a091..ed6af7c4f02b 100644
--- a/lighthouse-core/audits/dobetterweb/no-mutation-events.js
+++ b/lighthouse-core/audits/dobetterweb/no-mutation-events.js
@@ -39,6 +39,7 @@ class NoMutationEventsAudit extends Audit {
       category: 'JavaScript',
       name: 'no-mutation-events',
       description: 'Avoids Mutation Events in its own scripts',
+      failureDescription: 'Uses Mutation Events in its own scripts',
       helpText: 'Mutation Events are deprecated and harm performance. Consider using Mutation ' +
           'Observers instead. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/mutation-events).',
       requiredArtifacts: ['URL', 'EventListeners']
diff --git a/lighthouse-core/audits/dobetterweb/no-old-flexbox.js b/lighthouse-core/audits/dobetterweb/no-old-flexbox.js
index 2dd31648e6fb..a041c17d9a93 100644
--- a/lighthouse-core/audits/dobetterweb/no-old-flexbox.js
+++ b/lighthouse-core/audits/dobetterweb/no-old-flexbox.js
@@ -25,6 +25,7 @@ class NoOldFlexboxAudit extends Audit {
       category: 'CSS',
       name: 'no-old-flexbox',
       description: 'Avoids old CSS flexbox',
+      failureDescription: 'Uses old CSS flexbox',
       helpText: 'The 2009 spec of Flexbox is deprecated and is 2.3x slower than the latest ' +
           'spec. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/old-flexbox).',
       requiredArtifacts: ['Styles', 'URL']
diff --git a/lighthouse-core/audits/dobetterweb/no-websql.js b/lighthouse-core/audits/dobetterweb/no-websql.js
index b6d5fd881b99..7e04f6e150e6 100644
--- a/lighthouse-core/audits/dobetterweb/no-websql.js
+++ b/lighthouse-core/audits/dobetterweb/no-websql.js
@@ -23,6 +23,7 @@ class NoWebSQLAudit extends Audit {
       category: 'Offline',
       name: 'no-websql',
       description: 'Avoids WebSQL DB',
+      failureDescription: 'Uses WebSQL DB',
       helpText: 'Web SQL is deprecated. Consider using IndexedDB instead. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/web-sql).',
       requiredArtifacts: ['WebSQL']
diff --git a/lighthouse-core/audits/dobetterweb/notification-on-start.js b/lighthouse-core/audits/dobetterweb/notification-on-start.js
index 3d253b6a9553..8c4d8564dd44 100644
--- a/lighthouse-core/audits/dobetterweb/notification-on-start.js
+++ b/lighthouse-core/audits/dobetterweb/notification-on-start.js
@@ -22,6 +22,7 @@ class NotificationOnStart extends ViolationAudit {
       category: 'UX',
       name: 'notification-on-start',
       description: 'Avoids requesting the notification permission on page load',
+      failureDescription: 'Requests the notification permission on page load',
       helpText: 'Users are mistrustful of or confused by sites that request to send ' +
           'notifications without context. Consider tying the request to user gestures ' +
           'instead. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/notifications-on-load).',
diff --git a/lighthouse-core/audits/dobetterweb/password-inputs-can-be-pasted-into.js b/lighthouse-core/audits/dobetterweb/password-inputs-can-be-pasted-into.js
index 52f53d7df96f..47c62f3286ca 100644
--- a/lighthouse-core/audits/dobetterweb/password-inputs-can-be-pasted-into.js
+++ b/lighthouse-core/audits/dobetterweb/password-inputs-can-be-pasted-into.js
@@ -15,7 +15,8 @@ class PasswordInputsCanBePastedIntoAudit extends Audit {
     return {
       category: 'UX',
       name: 'password-inputs-can-be-pasted-into',
-      description: 'Allows to paste into password input fields',
+      description: 'Allows users to paste into password fields',
+      failureDescription: 'Prevents users to paste into password fields',
       helpText: '',
       requiredArtifacts: ['PasswordInputsWithPreventedPaste']
     };
diff --git a/lighthouse-core/audits/dobetterweb/uses-http2.js b/lighthouse-core/audits/dobetterweb/uses-http2.js
index 8ab5853603d4..58a3fa0d969d 100644
--- a/lighthouse-core/audits/dobetterweb/uses-http2.js
+++ b/lighthouse-core/audits/dobetterweb/uses-http2.js
@@ -25,6 +25,7 @@ class UsesHTTP2Audit extends Audit {
       category: 'Performance',
       name: 'uses-http2',
       description: 'Uses HTTP/2 for its own resources',
+      failureDescription: 'Does not use HTTP/2 for all of its resources',
       helpText: 'HTTP/2 offers many benefits over HTTP/1.1, including binary headers, ' +
           'multiplexing, and server push. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/http2).',
       requiredArtifacts: ['URL', 'devtoolsLogs']
diff --git a/lighthouse-core/audits/dobetterweb/uses-passive-event-listeners.js b/lighthouse-core/audits/dobetterweb/uses-passive-event-listeners.js
index 1bcbc96ad422..181888a227c8 100644
--- a/lighthouse-core/audits/dobetterweb/uses-passive-event-listeners.js
+++ b/lighthouse-core/audits/dobetterweb/uses-passive-event-listeners.js
@@ -22,6 +22,7 @@ class PassiveEventsAudit extends ViolationAudit {
       category: 'JavaScript',
       name: 'uses-passive-event-listeners',
       description: 'Uses passive listeners to improve scrolling performance',
+      failureDescription: 'Does not use passive listeners to improve scrolling performance',
       helpText: 'Consider marking your touch and wheel event listeners as `passive` ' +
           'to improve your page\'s scroll performance. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/passive-event-listeners).',
diff --git a/lighthouse-core/audits/is-on-https.js b/lighthouse-core/audits/is-on-https.js
index 7560c88a1e73..f491e9e07715 100644
--- a/lighthouse-core/audits/is-on-https.js
+++ b/lighthouse-core/audits/is-on-https.js
@@ -21,6 +21,7 @@ class HTTPS extends Audit {
       category: 'Security',
       name: 'is-on-https',
       description: 'Uses HTTPS',
+      failureDescription: 'Does not use HTTPS',
       helpText: 'All sites should be protected with HTTPS, even ones that don\'t handle ' +
           'sensitive data. HTTPS prevents intruders from tampering with or passively listening ' +
           'in on the communications between your app and your users, and is a prerequisite for ' +
diff --git a/lighthouse-core/audits/load-fast-enough-for-pwa.js b/lighthouse-core/audits/load-fast-enough-for-pwa.js
index 3d6c703ffdcf..ee8f41864911 100644
--- a/lighthouse-core/audits/load-fast-enough-for-pwa.js
+++ b/lighthouse-core/audits/load-fast-enough-for-pwa.js
@@ -31,6 +31,7 @@ class LoadFastEnough4Pwa extends Audit {
       category: 'PWA',
       name: 'load-fast-enough-for-pwa',
       description: 'Page load is fast enough on 3G',
+      failureDescription: 'Page load is not fast enough on 3G',
       helpText: 'Satisfied if First Interactive is less than 10 seconds, as defined by the [PWA Baseline Checklist](https://developers.google.com/web/progressive-web-apps/checklist). Network throttling is required (specifically: RTT latencies >= 150 RTT are expected).',
       requiredArtifacts: ['traces', 'devtoolsLogs']
     };
diff --git a/lighthouse-core/audits/manifest-short-name-length.js b/lighthouse-core/audits/manifest-short-name-length.js
index 68b367d87397..d4b6918d596a 100644
--- a/lighthouse-core/audits/manifest-short-name-length.js
+++ b/lighthouse-core/audits/manifest-short-name-length.js
@@ -16,6 +16,8 @@ class ManifestShortNameLength extends Audit {
       category: 'Manifest',
       name: 'manifest-short-name-length',
       description: 'Manifest\'s `short_name` won\'t be truncated when displayed on homescreen',
+      failureDescription: 'Manifest\'s `short_name` will be truncated when displayed ' +
+          'on homescreen',
       helpText: 'Make your app\'s `short_name` fewer than 12 characters to ' +
           'ensure that it\'s not truncated on homescreens. [Learn ' +
           'more](https://developers.google.com/web/tools/lighthouse/audits/manifest-short_name-is-not-truncated).',
diff --git a/lighthouse-core/audits/redirects-http.js b/lighthouse-core/audits/redirects-http.js
index 51c0cbb340d0..1fdbcd0b7825 100644
--- a/lighthouse-core/audits/redirects-http.js
+++ b/lighthouse-core/audits/redirects-http.js
@@ -16,6 +16,7 @@ class RedirectsHTTP extends Audit {
       category: 'Security',
       name: 'redirects-http',
       description: 'Redirects HTTP traffic to HTTPS',
+      failureDescription: 'Does not redirect HTTP traffic to HTTPS',
       helpText: 'If you\'ve already set up HTTPS, make sure that you redirect all HTTP traffic ' +
          'to HTTPS. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/http-redirects-to-https).',
       requiredArtifacts: ['HTTPRedirect']
diff --git a/lighthouse-core/audits/service-worker.js b/lighthouse-core/audits/service-worker.js
index 35834816b992..4ea99a018bd4 100644
--- a/lighthouse-core/audits/service-worker.js
+++ b/lighthouse-core/audits/service-worker.js
@@ -17,6 +17,7 @@ class ServiceWorker extends Audit {
       category: 'Offline',
       name: 'service-worker',
       description: 'Registers a Service Worker',
+      failureDescription: 'Does not register a Service Worker',
       helpText: 'The service worker is the technology that enables your app to use many ' +
          'Progressive Web App features, such as offline, add to homescreen, and push ' +
          'notifications. [Learn more](https://developers.google.com/web/tools/lighthouse/audits/registered-service-worker).',
diff --git a/lighthouse-core/audits/splash-screen.js b/lighthouse-core/audits/splash-screen.js
index bcb37e9304ac..1535e38aed0b 100644
--- a/lighthouse-core/audits/splash-screen.js
+++ b/lighthouse-core/audits/splash-screen.js
@@ -30,9 +30,8 @@ class SplashScreen extends MultiCheckAudit {
       category: 'PWA',
       name: 'splash-screen',
       description: 'Configured for a custom splash screen',
-      helpText: 'A custom splash screen creates a higher-quality user experience and makes your ' +
-          'Progressive Web App feel more like a native app. ' +
-          '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/custom-splash-screen).',
+      failureDescription: 'Is not configured for a custom splash screen',
+      helpText: 'A default splash screen will be constructed for your app, but satisfying these requirements guarantee a high-quality [splash screen](https://developers.google.com/web/updates/2015/10/splashscreen) that transitions the user from tapping the home screen icon to your app\'s first paint',
       requiredArtifacts: ['Manifest']
     };
   }
diff --git a/lighthouse-core/audits/themed-omnibox.js b/lighthouse-core/audits/themed-omnibox.js
index b357a935108c..9c92e414f51f 100644
--- a/lighthouse-core/audits/themed-omnibox.js
+++ b/lighthouse-core/audits/themed-omnibox.js
@@ -27,7 +27,8 @@ class ThemedOmnibox extends MultiCheckAudit {
     return {
       category: 'PWA',
       name: 'themed-omnibox',
-      description: 'Address bar has been themed',
+      description: 'Address bar matches brand colors',
+      failureDescription: 'Address bar does not match brand colors',
       helpText: 'The browser address bar can be themed to match your site. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/address-bar).',
       requiredArtifacts: ['Manifest', 'ThemeColor']
diff --git a/lighthouse-core/audits/viewport.js b/lighthouse-core/audits/viewport.js
index 3ee41b5ac9ae..834daeddf526 100644
--- a/lighthouse-core/audits/viewport.js
+++ b/lighthouse-core/audits/viewport.js
@@ -17,6 +17,8 @@ class Viewport extends Audit {
       category: 'Mobile Friendly',
       name: 'viewport',
       description: 'Has a `<meta name="viewport">` tag with `width` or `initial-scale`',
+      failureDescription: 'Does not have a `<meta name="viewport">` tag with `width` ' +
+          'or `initial-scale`',
       helpText: 'Add a viewport meta tag to optimize your app for mobile screens. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/has-viewport-meta-tag).',
       requiredArtifacts: ['Viewport']
diff --git a/lighthouse-core/audits/webapp-install-banner.js b/lighthouse-core/audits/webapp-install-banner.js
index a627cb7aa550..311627f4715c 100644
--- a/lighthouse-core/audits/webapp-install-banner.js
+++ b/lighthouse-core/audits/webapp-install-banner.js
@@ -38,6 +38,7 @@ class WebappInstallBanner extends MultiCheckAudit {
       category: 'PWA',
       name: 'webapp-install-banner',
       description: 'User can be prompted to Install the Web App',
+      failureDescription: 'User will not be prompted to Install the Web App',
       helpText: 'While users can manually add your site to their homescreen, the [prompt (aka app install banner)](https://developers.google.com/web/fundamentals/engage-and-retain/app-install-banners/) will proactively prompt the user to install the app if the various requirements are met and the user has moderate engagement with your site.',
       requiredArtifacts: ['URL', 'ServiceWorker', 'Manifest', 'StartUrl']
     };
diff --git a/lighthouse-core/audits/without-javascript.js b/lighthouse-core/audits/without-javascript.js
index effa4b6bb933..8c33b4c7cc0b 100644
--- a/lighthouse-core/audits/without-javascript.js
+++ b/lighthouse-core/audits/without-javascript.js
@@ -16,6 +16,7 @@ class WithoutJavaScript extends Audit {
       category: 'JavaScript',
       name: 'without-javascript',
       description: 'Contains some content when JavaScript is not available',
+      failureDescription: 'Does not provide fallback content when JavaScript is not available',
       helpText: 'Your app should display some content when JavaScript is disabled, even if it\'s ' +
           'just a warning to the user that JavaScript is required to use the app. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/no-js).',
diff --git a/lighthouse-core/audits/works-offline.js b/lighthouse-core/audits/works-offline.js
index ba0b332c85b6..1c572c78a192 100644
--- a/lighthouse-core/audits/works-offline.js
+++ b/lighthouse-core/audits/works-offline.js
@@ -17,6 +17,7 @@ class WorksOffline extends Audit {
       category: 'Offline',
       name: 'works-offline',
       description: 'Responds with a 200 when offline',
+      failureDescription: 'Does not respond with a 200 when offline',
       helpText: 'If you\'re building a Progressive Web App, consider using a service worker so ' +
           'that your app can work offline. ' +
           '[Learn more](https://developers.google.com/web/tools/lighthouse/audits/http-200-when-offline).',
diff --git a/lighthouse-core/config/config.js b/lighthouse-core/config/config.js
index acce1b7118ca..8b1bfbd42aa1 100644
--- a/lighthouse-core/config/config.js
+++ b/lighthouse-core/config/config.js
@@ -189,6 +189,13 @@ function assertValidAudit(auditDefinition, auditPath) {
     );
   }
 
+  // If it'll have a ✔ or ✖ displayed alongside the result, it should have failureDescription
+  if (typeof auditDefinition.meta.failureDescription !== 'string' &&
+    auditDefinition.meta.informative !== true &&
+    auditDefinition.meta.scoringMode !== Audit.SCORING_MODES.NUMERIC) {
+    log.warn('config', `${auditName} has no failureDescription and should.`);
+  }
+
   if (typeof auditDefinition.meta.helpText !== 'string') {
     throw new Error(
       `${auditName} has no meta.helpText property, or the property is not a string.`