Static images

Unfortunately, GitBook has a poor implementation of Markdown when it comes to images attributes: it converts alternative text (that should be an attribute inside img) into captions (using figcaption) and nothing else. That's a bad thing for accessibility — it means that screen readers won't be able to inform visually impaired users what that image is about properly. This issue was reported to the Engineering team; a solution is pending.

  1. No media of any kind should replace proper instructions. Use any kind of media as an addition to the page, and not as he main source of information.

Last updated