Skip to content

Conversation

@merwok
Copy link
Collaborator

@merwok merwok commented Nov 18, 2025

@StanFromIreland
Copy link
Member

@hugovk, as an accessibility expert, what are you thoughts here?

@m-aciek
Copy link
Collaborator

m-aciek commented Nov 18, 2025

I would like to add yet another link, to languages' stats (#151). I wonder how that will play with those changes. Probably we should then split the links into separate lines.

@merwok
Copy link
Collaborator Author

merwok commented Nov 18, 2025

The markup could be a list instead of link dot link, then some flex? grid? css can display them on one line or in a column depending on available width (maybe)

@merwok merwok marked this pull request as draft November 18, 2025 17:13
@merwok merwok requested a review from hugovk November 18, 2025 17:13
@hugovk
Copy link
Member

hugovk commented Nov 19, 2025

@hugovk, as an accessibility expert, what are you thoughts here?

A screen reader may give a list of links, which currently would be lots of View, Contribute, View, Contribute.

As a sighted user, https://translations.python.org/155/merge/ does look somewhat cluttered, as I can tell the View/Contribute in the French box relate to that translation.

Here are some relevant WCAG guidelines:

We can use aria-label as a compromise:

https://www.w3.org/WAI/WCAG22/Techniques/aria/ARIA8

The example:

<h4>Neighborhood News</h4>
<p>Seminole tax hike: Seminole city managers are proposing a 75% increase in 
  property taxes for the coming fiscal year.
  <a href="taxhike.html" aria-label="Read more about Seminole tax hike">
   Read more</a>
</p> 
  
<p>Baby Mayor: Seminole voters elect the city's youngest mayor ever by voting
   in 3 year old Willy "Dusty" Williams in yesterday's mayoral election.
   <a href="babymayor.html" aria-label="Read more about Seminole's new baby mayor">
    Read more</a>
</p>

This is similar to our situation, where we have lots of identical link texts, but they go to different pages. We can also use aria-label:

<a href="https://docs.python.org/fr/3/" aria-label="View French documentation" ...>View</a>
...
<a href="https://git.afpy.org/AFPy/python-docs-fr/src/branch/3.13/CONTRIBUTING.rst" aria-label="Contribute to French translations" ...>View</a>

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants