# Improve HTML semantics and a11y of language reference · gitcafe/zig

[View on GitCafe](https://git.cafe/gitcafe/zig/commit/0c091feb5ae52caf1ebf885c0de55b3159207001)

Repository: [gitcafe/zig](https://git.cafe/gitcafe/zig)

Visibility: public

Requested revision: 0c091feb5ae52caf1ebf885c0de55b3159207001

Requested commit: 0c091feb5ae52caf1ebf885c0de55b3159207001

Commit: 0c091feb5ae52caf1ebf885c0de55b3159207001

Tree: 6619f5d03bbccd5a500035947cf50f2118b4dc46

Author: Mr\. Paul

Committer: Andrew Kelley

## Message

```
Improve HTML semantics and a11y of language reference

The language reference's HTML has been updated to be more semantically correct.
This also helps to improve the document's accessibility concerns.

* Document structure has single h1, other header sections start at h2, nav sections w/ aria labels, main section
* Zig's homepage is linked, Zig Standard Library section link to it
* Tables have caption and scoping rows and columns
* Code blocks are figures with figure captions citing source files
* Change line height 1.5 to include table of contents as well
* Luminosity contrast ratios have been adjusted to 7:1
* Dark mode colors adjusted to reduce eye strain
* Links have default browser underline with hover and focus effects
* Asides, definition lists, keyboard inputs, program outputs are represented semantically

Tools used to check:
WAVE plugin https://wave.webaim.org/
Firefox Accessibility Developer Tool
Lighthouse Accessibility Tool

```

## Parents

- [9e24727062624ec51eadb833d3c434b15889a9c3](https://git.cafe/gitcafe/zig/commit/9e24727062624ec51eadb833d3c434b15889a9c3?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zig/tree/0c091feb5ae52caf1ebf885c0de55b3159207001?format=markdown)