Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve accessibility of CRAN website #5

Open
AmeliaMN opened this issue Oct 13, 2021 · 4 comments
Open

Improve accessibility of CRAN website #5

AmeliaMN opened this issue Oct 13, 2021 · 4 comments

Comments

@AmeliaMN
Copy link

I have a blind student learning R with me this semester, and Jonathan Godfrey’s materials (including the BrailleR package!) have been so amazing. But one barrier to accessibility is that the main R website doesn’t seem very compatible with screen readers, which makes it hard to download and install R. I mentioned this to @hturner, and she said an issue here would be one way to flag it.

@hturner
Copy link

hturner commented Oct 13, 2021

Yes, I think it is the CRAN website in particular, hence the relevance to this group. Unlike the R project website (https://www.r-project.org/), the CRAN website still uses frames, which I suspect cause a lot of the accessibility issues. Frames are obsolete in HTML5 due to their lack of usability and accessibility (https://www.w3.org/TR/html5-diff/#obsolete-elements). As others have mentioned before, using frames also makes the site look outdated, so updating CRAN to the more modern style of the main R project site would improve the look and accessibility at the same time.

I would be interested to help work on this, perhaps bringing in some expertise from Forwards, we have quite a few people who are interested in accessibility of materials for R users.

@PythonCoderUnicorn
Copy link

there is a bug report posted regarding the HTML 4 and the need for HTML 5 for accessibility

https://bugs.r-project.org/show_bug.cgi?id=18149

however there is no specific bug reported that I can see (without signing in) regarding accessibility and screen readers.

@llrs
Copy link
Collaborator

llrs commented Mar 24, 2022

Not sure if the switch of HTML5 will make things easier from an accessibility without other changes.
But the issue was closed and now there are some changes on the websites and how help pages are rendered.
For example compare this https://cran.r-project.org/doc/manuals/r-devel/NEWS.html (new html5) with https://cran.r-project.org/doc/manuals/r-release/NEWS.html (old html 4?).

Not sure how helpful will this be but here is a Twitter thread with some images about the changes on LaTeX rendering too. Basically now the equations will show the symbols and glyphs instead of the LaTeX notation.

@benubah
Copy link

benubah commented Mar 25, 2022

Not sure, but it seems to me that the proposal is to make https://cran.r-project.org/index.html more accessible.
Switching to HTML5 is a good idea which provides more flexibility accessibility-wise, and I agree that exploring other required changes may also be involved to arrive at full accessibility.

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

No branches or pull requests

5 participants