Search for {figure} and {image} and get count of instances (326). Compare against count of :alt: (128).

Do we want to make alt required? (I would vote "yes".)

If we require this, then we must document that it is required. Currently we have only an example without stating that alt is required. That would go best in docs/contributing/markup-syntax.md.

Also add an explanation or reference. For example:

Why use an alt tag?

• improves SEO: https://duckduckgo.com/?q=plone+training&atb=v85-1&iax=images&ia=images
• Alt text is displayed in case the image does not load.
• Accessibility is part of the Plone brand and identity

This is a job to do: adding alt attributes in existing docu.

After this is done I would vote for documenting alt attribute as required and add a check.

Is there an easy way to automate checking images for alt text in GitHub Actions or Sphinx?

I could not find any automatic alt text enforcer under sphinx-contrib.

I found a tool called Sa11y that might be helpful after deployment, but it is manual.

Maybe @polyester knows of a tool?

@ksuess Why did you close this? It is not complete.