Fixed #13 - More user friendly title/description for assessments.

src/resources/tests.yml

@@ -27,8 +27,8 @@ aImgAltNotRepetitive:
   type: "custom"
   testability: 1
   title:
-    en: "When an image is in a link, its \"alt\" attribute should not repeat other text in the link"
-    nl: "Als een link een afbeelding bevat, moet het \"alt\"-attribuut niet dezelfde tekst bevatten als de linktekst"
+    en: "Alternative text for image in a link, should not repeat text in the link"
+    nl: "##missing##"
   description:
     en: "Images within a link should not have an alt attribute that simply repeats the text found in the link. This will cause screen readers to simply repeat the text twice."
     nl: "Als een link een afbeelding bevat, moet deze afbeelding een andere tekst in het alt-attribuut hebben dan de tekst in de link. Hiermee voorkom je dat een schermlezer dezelfde tekst twee keer voorleest."
@@ -632,11 +632,11 @@ blockquoteNotUsedForIndentation:
   type: "selector"
   testability: 0.5
   title:
-    en: "The \"blockquote\" tag should not be used just for indentation"
-    nl: "De \"blockquote\"-tag mag niet gebruikt worden om in te springen"
+    en: "The block quote should not be used just for indentation"
+    nl: "##missing##"
   description:
-    en: "Blockquote tags are for long-form quotes, and should not be used to indent paragraphs. Use CSS to indent the paragraph instead."
-    nl: "Blockquotes zijn bedoeld voor lange stukken geciteerde tekst, en niet om tekst te laten inspringen."
+    en: "Blockquote tags are for long-form quotes, and should not be used to indent text."
+    nl: "##missing##"
   guidelines:
     wcag:
       1.3.1:
@@ -1336,11 +1336,11 @@ documentVisualListsAreMarkedUp:
   type: "custom"
   testability: 1
   title:
-    en: "Visual lists of items are marked using ordered or unordered lists"
-    nl: "Lijsten moeten gemarkeerd worden als ordered of unordered lists"
+    en: "Lists of items are marked using list markup"
+    nl: "##missing##"
   description:
-    en: "Use the ordered (<code>ol</code>) or unordered (<code>ul</code>) elements for lists of items, instead of just using new lines which start with numbers or characters to create a visual list."
-    nl: "Gebruik ordered (<code>ol</code>) of unordered (<code>ul</code>) elementen voor lijsten, in plaats van een nieuwe regel per item aan te maken die je laat beginnen met een nummer of teken om een visuele lijst te maken."
+    en: "Use the ordered or unordered (bullet) list elements to mark lists, instead of just using new lines which start with numbers or characters to create a visual list."
+    nl: "##missing##"
   guidelines:
     wcag:
       1.3.1:
@@ -1958,11 +1958,11 @@ headerH1:
   type: "headingLevel"
   testability: 0
   title:
-    en: "The header following an h1 is not h3 through h6"
-    nl: "De header die volgt op een h1 is niet h3 tot h6"
+    en: "Header level 1 should not be followed by level 3 through level 6"
+    nl: "##missing##"
   description:
-    en: "Header order should not skip a level. Do not follow a <code>h1</code> header with a <code>h3</code>, <code>h4</code>, <code>h5</code>, or <code>h6</code>."
-    nl: "Headers mogen geen niveau overslaan. Laat een <code>h1</code>-header niet volgen door een <code>h3</code>, <code>h4</code>, <code>h5</code>, of <code>h6</code>."
+    en: "Header order should not skip a level. Do not follow a header level 1 with a level 3, 4, 5, or 6."
+    nl: "##missing##"
   guidelines:
     wcag:
       2.4.6:
@@ -2000,11 +2000,11 @@ headerH2:
   type: "headingLevel"
   testability: 0
   title:
-    en: "The header following an h2 is not h4, h5, or h6"
-    nl: "De header volgend op een h2 is geen h4, h5, of h6"
+    en: "Header level 2 should not be followed by level 4 through level 6"
+    nl: "##missing##"
   description:
-    en: "Header order should not skip a level. Do not follow a <code>h2</code> header with a <code>h4</code>, <code>h5</code>, or <code>h6</code>."
-    nl: "Headers mogen geen niveau overslaan. Laat een <code>h2</code>-header niet volgen door een <code>h4</code>, <code>h5</code>, of <code>h6</code>."
+    en: "Header order should not skip a level. Do not follow a header level 2 with a level 4, 5, or 6."
+    nl: "##missing##"
   guidelines:
     wcag:
       2.4.6:
@@ -2043,10 +2043,10 @@ headerH3:
   testability: 0
   title:
     en: "The header following an h3 is not an h5 or h6"
-    nl: "De header volgend op een h3 is geen h5, of h6"
+    nl: "##missing##"
   description:
-    en: "Header order should not skip a level. Do not follow a <code>h3</code> header with a <code>h5<code> or <code>h6</code>."
-    nl: "Headers mogen geen niveau overslaan. Laat een <code>h3</code>-header niet volgen door een <code>h5</code>, of <code>h6</code>."
+    en: "Header order should not skip a level. Do not follow a header level 3 with a level 5 or 6."
+    nl: "##missing##"
   guidelines:
     wcag:
       2.4.6:
@@ -2084,11 +2084,11 @@ headerH4:
   type: "headingLevel"
   testability: 0
   title:
-    en: "The header following an h4 is not an h6"
-    nl: "De header volgend op een h4 is geen h6"
+    en: "Header level 4 should not be followed by level 6"
+    nl: "##missing##"
   description:
-    en: "Header order should not skip a level. Do not follow a <code>h4</code> haeder with a <code>h6</code>."
-    nl: "Headers mogen geen niveau overslaan. Laat een <code>h4/code> header niet volgen door een <code>h6</code>."
+    en: "Header order should not skip a level. Do not follow a header level 4 with level 6 header."
+    nl: "##missing##"
   guidelines:
     wcag:
       2.4.6:
@@ -2364,11 +2364,11 @@ imgAltIsDifferent:
   type: "custom"
   testability: 0.5
   title:
-    en: "Image \"alt\" attributes should not be the same as the filename"
-    nl: "\"Alt\"-attributen van afbeeldingen moeten niet hetzelfde zijn als de bestandsnaam"
+    en: "Image alternative text should not be the same as the file name"
+    nl: "##missing##"
   description:
-    en: "All <code>img</code> elements should have an \"alt\" attribute that is not just the name of the file"
-    nl: "Alle <code>img</code>-elementen moeten een \"alt\"-attribuut hebben dat anders is dan de bestandsnaam van de afbeelding."
+    en: "All images should have a meaningful alternative text. File name contains less readable information, and not always reflect information presented by the image."
+    nl: "##missing##"
   guidelines:
     508:
       - "a"
@@ -2406,11 +2406,11 @@ imgAltIsTooLong:
   type: "custom"
   testability: 1
   title:
-    en: "Image Alt text is too long"
-    nl: "Altteksten voor een afbeelding zijn kort"
+    en: "Image alternative text is too long"
+    nl: "##missing##"
   description:
-    en: "All \"alt\" attributes for <code>img</code> elements should be clear and concise. \"Alt\" attributes over 100 characters long should be reviewed to see if they are too long."
-    nl: "Alle \"alt\"-attributen voor <code>img</code>-elementen moeten duidelijk en bondig zijn. Verifieer \"alt\"-attributen langer dan 100 tekens en kort ze in waar mogelijk."
+    en: "Image alternative text should be clear and concise. Alternative text longer than 100 characters should be reviewed to see if they can be reduced."
+    nl: "##missing##"
   guidelines:
     508:
       - "a"
@@ -2426,11 +2426,11 @@ imgAltNotEmptyInAnchor:
   type: "custom"
   testability: 1
   title:
-    en: "An image within a link cannot have an empty \"alt\" attribute if there is no other text within the link"
-    nl: "Een afbeelding binnen een link mag geen leeg \"alt\"-attribuut hebben als er geen andere tekst is in de link"
+    en: "An image within a link cannot have an empty alternative text if there is no other text within the link"
+    nl: "##missing##"
   description:
-    en: "Any image that is within a link (an <code>a</code> element) that has no other text cannot have an empty or missing \"alt\" attribute."
-    nl: "Elke afbeelding binnen een link (een <code>a</code>-element) die geen andere tekst heeft, mag geen leeg of ontbrekend \"alt\"-attribuut hebben."
+    en: "Any image that is within a link that has no other text cannot have an empty or missing alternative text."
+    nl: "##missing##"
   guidelines:
     508:
       - "a"
@@ -2508,11 +2508,11 @@ imgHasAlt:
   type: "selector"
   testability: 1
   title:
-    en: "Image elements must have an \"alt\" attribute"
-    nl: "Afbeeldingselementen moeten een \"alt\"-attribuut hebben"
+    en: "Image elements must provide alternative text"
+    nl: "##missing##"
   description:
-    en: "All <code>img</code> elements must have an alt attribute."
-    nl: "Alle <code>img</code>-elementen moeten een \"alt\"-attribuut hebben."
+    en: "Alternative text need to convey the same information as the image. This text will be used when the browser has disabled images, image was not found on the server or by non-sighted visitors who uses screen reader."
+    nl: "##missing##"
   guidelines:
     508:
       - "a"
@@ -3792,8 +3792,8 @@ pNotUsedAsHeader:
     en: "Paragraphs must not be used for headers"
     nl: "Alinea's worden niet gebruikt als header"
   description:
-    en: "Headers like <code>h1</code> - <code>h6</code> are extremely useful for non-sighted users to navigate the structure of the page, and formatting a paragraph to just be big or bold, while it might visually look like a header, does not make it one."
-    nl: "Headers van <code>h1</code> - <code>h6</code> zijn handig voor blinde en slechtziende gebruikers om door een pagina te navigeren. Maak alinea's daarom niet op zodat deze lijkt op een header. Dit werkt verwarrend."
+    en: "Headers are extremely useful for non-sighted users to navigate the structure of the page. Formatting a paragraph to just be big or bold, while it might visually look like a header, does not make it one."
+    nl: "##missing##"
   guidelines:
     wcag:
       1.3.1:
@@ -4539,8 +4539,8 @@ tableDataShouldHaveTh:
     en: "Data tables should contain \"th\" elements"
     nl: "Datatabellen moeten \"th\"-elementen bevatten"
   description:
-    en: "Tables which contain data (as opposed to layout tables) should contain <code>th</code> elements to mark headers for screen readers and enhance the structure of the document."
-    nl: "Tabellen die data bevatten (in tegenstelling tot lay-out tabellen) moeten <code>th</code>-elementen bevatten om koppen te markeren voor schermlezers en om de structuur van het document te verbeteren."
+    en: "Tables which contain data (as opposed to layout tables) should contain proper table header elements to mark them for screen readers and enhance the structure of the document."
+    nl: "##missing##"
   guidelines:
     508:
       - "g"