Metadocumentation
redirect
redirect
  • Hello 👋
  • Structure
    • Namespaces
      • Open Collective's namespaces
    • Categorization
  • Media
    • Static images
    • Videos and GIFs
    • Code snippets
  • Open Collective
    • Welcome
    • Contribution guidelines
      • Design
      • Development
      • Documentation
        • Suggesting changes
        • Style guide
      • Translation
  • Open Source Collective
    • Apply
  • Test
    • What happens if I change this?
    • All special attributes
      • Design
Powered by GitBook
On this page
  1. Media

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.

PreviousCategorizationNextVideos and GIFs

Last updated 5 years ago