Skip to content

[Accessibility] Add missing or change bad media descriptions - #660

Merged
codeurimpulsif merged 3 commits into
v1from
a11y-descriptions
Jul 27, 2025
Merged

[Accessibility] Add missing or change bad media descriptions#660
codeurimpulsif merged 3 commits into
v1from
a11y-descriptions

Conversation

@codeurimpulsif

@codeurimpulsif codeurimpulsif commented Jul 22, 2025

Copy link
Copy Markdown
Contributor

Goal

  • Add missing images descriptions
  • Fix wrong images descriptions
  • Compile new english translations

Information

Need #634 to be merged first.

@codeurimpulsif codeurimpulsif self-assigned this Jul 22, 2025
@codeurimpulsif codeurimpulsif added enhancement New feature or request good first issue Good for newcomers labels Jul 22, 2025
@Porkepix

Porkepix commented Jul 23, 2025

Copy link
Copy Markdown
Member

Rather than commenting every occurences where this happens, some general comments:

  • There are many binary (.mo) files, those shouldn't be committed, I think?
  • My understanding of alt texts is that they should describe the function rather than what it looks like (ig. XX logo, XY button and so on), so some of them should be adjusted. Also according to some docs I read it's ok to have empty alt text sometimes, if the picture isn't required to understand the page (decorative content). For a button or decoration in a field, if accessibility is already taken care of at some other level, alt text could do more harm than good.

I've looked at some documents for this, I'm still no accessibility expert, though!

@codeurimpulsif

codeurimpulsif commented Jul 23, 2025

Copy link
Copy Markdown
Contributor Author

There are many binary (.mo) files, those shouldn't be commited, I think?

Yes, I don't know why we keep them, maybe it could be a good idea to remove them later.

My understanding of alt texts is that they should describe the function rather than what it looks like (eg. XX logo, XY button and so on), so some of them should be adjusted. Also according to some docs I read it's ok to have empty alt text sometimes, if the picture isn't required to understand the page (decorative content). For a button or decoration in a field, if accessibility is already taken care of at some other level, alt text could do more harm than good.

Yes, I will remove some of them, thanks!

@codeurimpulsif
codeurimpulsif merged commit 20dc8c4 into v1 Jul 27, 2025
8 checks passed
@codeurimpulsif
codeurimpulsif deleted the a11y-descriptions branch July 27, 2025 12:30
read our <a target="_blank" rel="noreferrer" href='https://exodus-privacy.eu.org/en/post/covid/'>blog post</a>
{% blocktrans %}
Applications with geographic restrictions cannot be scanned -
read our <a target="_blank" rel="noreferrer" href='https://exodus-privacy.eu.org/en/post/covid/'>blog post</a>

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Any specific reason not to use the same quotes for every attribute?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, I just don't touche this.


<div id="loading" class="text-center d-none">
<img class="w-200px" src="/static/img/loading.gif" alt="">
<img class="w-200px" src="/static/img/loading.gif" alt="{% trans "Animated line of marbles going up and down in waves" %}">

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was there any alt text before helping to understand its role? I'm not sure if describing the animation is a good thing for accessibility here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No there wasn't. I think it describe something is happening to see it's loading.

<a href="#" class="btn btn-primary">{% trans "See the report" %}</a>
</p>
<img id="snake" class="d-none w-200px" src="/static/img/loading.gif" alt="">
<img id="snake" class="d-none w-200px" src="/static/img/loading.gif" alt="{% trans "Animated line of marbles going up and down in waves" %}">

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Was there any alt text before helping to understand its role? I'm not sure if describing the animation is a good thing for accessibility here?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same.

{% endif %}
{% if perm.severity == 'Special' or perm.severity == 'Dangerous' %}
&nbsp;<img data-toggle="tooltip" data-placement="top" title="Protection level: {{ perm.protection_level }}" src="/static/img/danger.svg">&nbsp;
&nbsp;<img data-toggle="tooltip" data-placement="top" title="Protection level: {{ perm.protection_level }}" src="/static/img/danger.svg" alt="{% trans "Red exclamation mark" %}">&nbsp;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would rather replace description by its signification?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No because the explanation is already here.

<small class="text-muted font-italic">
{% blocktrans trimmed %}
The icon &nbsp;<img src="/static/img/danger.svg">&nbsp; indicates a 'Dangerous' or 'Special' level according to <a target="_blank" rel="noreferrer" href="https://developer.android.com/guide/topics/permissions/overview">Google's protection levels</a>.
The icon &nbsp;<img src="/static/img/danger.svg" alt="Red exclamation mark">&nbsp; indicates a 'Dangerous' or 'Special' level according to <a target="_blank" rel="noreferrer" href="https://developer.android.com/guide/topics/permissions/overview">Google's protection levels</a>.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would rather replace description by its signification?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think it's a good idea, but maybe?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What makes you think it's not a good one?

@Porkepix

Copy link
Copy Markdown
Member

@codeurimpulsif Sorry I took too much time to check again here, added a few comments here and there plus one I didn't target as there are several occurrences: is it a good thing to add description of a logo in the alt text? I'd say it's better to just say it's "XXX logo" and that's all? Or at the very least when the same logo appears more than once, describe it only once.

@codeurimpulsif

Copy link
Copy Markdown
Contributor Author

@Porkepix for the Exodus logo I think it's a good idea, for the contacts logos I don't know, do you think we should change them?

@Porkepix

Copy link
Copy Markdown
Member

@Porkepix for the Exodus logo I think it's a good idea, for the contacts logos I don't know, do you think we should change them?

When I was looking for some information around accessibility topics, I've read one article that was saying one of the best examples they came across was one site with only "foo", "bar" and "baz" as alt text where foo, bar and baz were brand names, therefore not even mentioning the word "logo". Those were links to these brands websites, though.

Anyway, it's never easy as you can find contradictory information and I get the feeling there isn't one absolute good/best answer to this. But yeah I wouldn't have put the description or at least only once for my part.

@codeurimpulsif

Copy link
Copy Markdown
Contributor Author

@Porkepix the logos we're talking about are not links, only logo to show it's an email or a social network.

@Porkepix

Copy link
Copy Markdown
Member

@Porkepix the logos we're talking about are not links, only logo to show it's an email or a social network.

Yes, but then the meaning is carried by the link beside it, not by the picture that's not used for screen readers, right?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request good first issue Good for newcomers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants