Public Documents Southern Grampians Shire Council

Contact Us Southern Grampians Shire Council

Schools Southern Grampians Shire Council

Live Here Southern Grampians Shire Council

Our Shire Southern Grampians Shire Council

Advocacy Southern Grampians Shire Council

Visit Here Southern Grampians Shire Council

Tenders Southern Grampians Shire Council

About Council Southern Grampians Shire Council

Playgroups Southern Grampians Shire Council

Lists of related items should be written [semantically](https://html.com/semantic-markup/) as a 
list.

Usually this means rewriting these to use the `<ul>` or `<ol>` tags.

This allows assistive technologies to more easily navigate from item to
item, or past entire groups of links if the user wants to. 

## Examples 

### Navigation

This navigation:

```html
<a href="/about">About us</a>
<a href="/products">Products</a>
<a href="/contact">Contact us</a>
```

Should be rewritten as a list:

```html
<ul>
  <li><a href="/about">About us</a></li>
  <li><a href="/products">Products</a></li>
  <li><a href="/contact">Contact us</a></li>
</ul>
```

### Tables for content

This single-column table is redundant. There is no
value in placing the content in a table, which makes
it harder for screen reader users to interpret and interact
with.

```html
<table>
  <tr>
    <td>
      Banana
    </td>
  </tr>
  <tr>
    <td>
      Apple
    </td>
  </tr>
  <tr>
    <td>
      Pear
    </td>
  </tr>
</table>
```

Should be rewritten as a list:

```html
<ul>
  <li>Banana</li>
  <li>Apple</li>
  <li>Pear</li>
</ul>
```

## Justification

Users of assistive technologies, like screen readers, can skip an entire
list in one step. In some cases, they can even search inside a list. 

These aids are not available where links are written outside a list. 
Failing to use lists correctly can force users to have to step through
hundreds of items one at a time.

## Methodology

1. Any single-column tables are automatically considered 
   redundant lists. 
2. For non-table elements, recursively work down the page looking inside
   each element for links separated by minimal amounts of non-link text. 
   If the non-link text is below 30 characters 
   in length, we assume we're inside content that should be a list.
   Some exceptions are made, e.g. the presence of an `<hr>` would break
   out of the list.

## More information

See [Technique
H48](https://www.w3.org/TR/2016/NOTE-WCAG20-TECHS-20161007/H48) for
details.

mark-navigation-section-as-list

June 2025

May 2025

Southern Grampians Shire Council

	Title / URL	Issues
	Public Documents Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/About-Council/Public-Documents	3
	Contact Us Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Contact-Us	2
	Schools Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Our-Shire/Live-Here/Schools	2
	Live Here Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Our-Shire/Live-Here	2
	Our Shire Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Our-Shire	2
	Advocacy Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/About-Council/Advocacy	2
	Visit Here Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Our-Shire/Visit-Here	2
	Tenders Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Tenders	2
	About Council Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/About-Council	2
	Playgroups Southern Grampians Shire Councilwww.sthgrampians.vic.gov.au/Our-Shire/Live-Here/Playgroups	2

Write lists or groups of links semantically

Southern Grampians Shire Council

Where this issue has occurred