FamilySearch Wiki:WCAG Required Changes to Wikitext Code

From FamilySearch Wiki

Changes to Wiki Pages[edit | edit source]

As a result of the European Union requirment to implement changes to all website to improve accessibility, the Research Wiki has gone under massive changes to comply and provide a better experience to those that use accessibility readers.

Contributing to the Wiki[edit | edit source]

Certain wikitext coding used for articles in the past can no longer be used. Some of these changes include:

  • Headings. Wiki pages now require a heading 2 before any free text on a Wiki page. (breadcrumbs and SEO paragraphs do not count).


Example: Replace all Heading 3s found as the first heading on a Wiki page.

  • Use language template. To signify to a screen reader that the word it is reading is in a different language, a template must be added around each foreign language word.


Example: We do not have a template in the Wiki to support this endeavor. For now it is on hold.

  • <ul> lists. There is incorrect wikitext code on Wiki pages incorrectly using the <ul> class.


  • Update Tables. All tables must be updated to the correct wikitext coding to display the content. These changes include:
    • Wikitable Class. All tables should be changed to wiki wikitable class. Additional guidance can be found on Manual of Style-Tables.


Examples: class="wikitable"; class="wikitable sortable"

    • Colors of cells in tables. Colors can enhance the readability of a table. However, the color must have a proper contrast for those with color blindness. Hyperlinks (blue text) must also pass the contrast test in addition to the black text. Use Color picker at W3schools for assistance.


    • Tables given a title. All tables should have a title to help explain the purpose of the table. It can be added to the table using |+ directly below the class of the table.


Example: Wikitext of a wikitable

    • Identify columns and rows. Additional code must be added to a table to identify to the reader column headings and row headings.



Example: Below is a sample of a table with the correct wikitext code for column and row headings: {| class="wikitable"
|+ Main Characters of Star Trek: The Original Series
|-
! scope="col" | Rating
! scope="col" | Rank
! scope="col" | Name
! scope="col" | Actor
|-
! scope="row" | Captain
| Captain || Kirk, James T || William Shatner
|-
! scope="row" | First Officer
| Commander || Spock || Leonard Nimoy
|-
! scope="row" | Chief Medical Officer
| Lt Commander || Leonard McCoy || DeForest Kelley
|-
! scope="row" | Chief Engineer
| Lt Commander || Montgomery Scott || James Doohan
|}



    • Use of color on a table to indicate information. Because of the limitations of a screen reader, color cannot be distinguished to the user. Thus, there is no communication of what the color represents.


Example: England Church Records table

  • Use of indention on a Wiki page. Wiki pages can no longer with a colon to indent on a Wiki page. This also includes indenting a bullet. The use of a indent template is required. For more information go to: Template:Block indent.


Example: ** used to indent an asterisk. Example: Proper use of template to indent text:{{Block indent|Clerk of the Senate}}