Giter Club home page Giter Club logo

a11y-webring.club's Introduction

README

I help make GitHub more accessible.

  • If it’s inaccessible, it is neither radical nor revolutionary.
  • Progress over perfection.
  • Nothing about us without us.

a11y-webring.club's People

Contributors

1copenut avatar adeleke5140 avatar aliciajarvis avatar basher avatar brob avatar dependabot[bot] avatar dnikub avatar dpersing avatar enaaacode avatar ericwbailey avatar everyonesweb avatar gingerkiwi avatar itscrisdiaz avatar janmaarten-a11y avatar jenstrickland avatar joshkimux avatar kazuhito-kidachi avatar luce-carevic avatar marcus-herrmann avatar mattobee avatar ronva avatar saptaks avatar sarajw avatar segdeha avatar seirdy avatar sivakusayan avatar stevenwoodson avatar wagnerbeethoven avatar winniebosy avatar yatil avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

a11y-webring.club's Issues

[Feature suggestion] Color theme slider

Feature suggestion

The color of the site is determined by three custom properties, theme-h, theme-s, and theme-l, which are used to create a hsl() color declaration.

Modifying the theme-h custom property in the :root selector allows the entire site to adjusts its theme color. I think it would be fun to have a little input range slider that allows a visitor to tweak the color from 1 to 360Β°, and then store the value to local storage.

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

Document the need for a referrer header

Your issue

This webring seems to require the use of the HTTP referer (sic) header. However, personal sites that don't monetize data or use analytics often drop referrers with a Referrer-Policy: no-referrer response header. A workaround is to override this with a referrerpolicy attribute on anchor elements, as I do in my webring template.

Documenting this could avoid future headaches as people wonder why their webring links don't work.

Code of conduct

  • I agree to follow this project's code of conduct

Remove Twitter?

Twitter's most recent issues with antisemitism sits poorly with me. To me, it's an inflection point where the platform is now actively stoking and profiting from fomenting hate.

This is balanced against it being a place where a lot of disability advocates organize, as well as its relatively low barrier of adoption.

I was wondering if we could talk about this, and folks' opinions on the matter.

@acnorrisuk, @AliciaJarvis, @segdeha, @ItsCrisDiaz, @dnikub, @dsenneff, @davidakennedy, @dennisl, @dpersing, @codeability, @FMJansen, @worldsayer, @jrfbz, @jenstrickland, @joshkimux, @adeleke5140, @mattobee, @matthewdeeprose, @mherchel, @mikemai2awesome, @bamadesigner, @racheleditullio, @SaptakS, @stevefaulkner, @stevenwoodson, @TiffanyPender, @toddlibby, @1Copenut, @winniebosy: Apologies for the mass-tag, but this was the only way I could think of for people on the webring who have Twitter profiles to be aware this was being discussed.

And speaking of social media: I just added support for GitHub if you're interested in updating your info.

[Feature suggestion] Add a submission form

Feature suggestion

Netlify provides a contact form, and we just happen to use them. Setting one up will drastically lower the level of technical knowledge to participate, so it would be a good addition to the site.

Ideally a submission could be set to trigger a PR review for manual vetting.

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

[Feature suggestion] WCAG trash panda mode

Feature suggestion

Until @patrickhlauke's WCAG trash panda webring gets off the ground, this webring will have to suffice.

We should have a toggle to enable trash panda mode for the webring landing page, whatever that may be.

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

[Feature suggestion] Add GitHub

Feature suggestion

In #119 there was an individual who supplied a GitHub profile URL for the Mastodon entry. I think this represents an opportunity to add it as a social service, so let's do just that!

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

[Bug] Webring links crash in browser

What happened?

All the links (previous / next / random) crash in browser.

webring-crashed

Operating systems

Windows 10

Browsers

Firefox, Chrome

Anything else?

No response

Code of conduct

  • I agree to follow this project's code of conduct

[Feature suggestion] Add Level 3 Heading Mark-Up to Member Names

Feature suggestion

There currently isn't a way for screen reader users to easily jump between members of the ring within the "Members" list. Each member is a list item, but the contact blocks are also nested lists, so jumping by list item doesn't work.

To rectify this, I suggest adding level 3 heading mark-up to each name. This will significantly increase the number of headings on the page, which will be particularly noticeable for users navigating with a touch-based screen reader where commands to jump by specific heading level are generally not available (e.g. iOS VoiceOver). However, there is a "Skip member list" link on the page already, and so I think the increased navigability makes it well worth it.

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

[Bug] Netlify function invocation fails

What happened?

Using the "Previous", "Random", "Next" links results in a Netlify error page:

An unhandled error in the function code triggered the following message:

Runtime.UserCodeSyntaxError - SyntaxError: Unexpected token ':'

Operating systems

N/A

Browsers

N/A

Anything else?

No response

Code of conduct

  • I agree to follow this project's code of conduct

Looks like some overlapping PRs remove other recent additions

Your issue

πŸ‘‹ Got the notification that my PR was merged so I took a peek and realized that a few of us had changes overwritten by future merges. Looks like

  • #54 and #55 were replaced by #56
  • #57 was replaced with #58
    I did see that you fairly quickly fixed that with #59 but I can imagine that manual work can get tedious.

Potential Solution

I could work up a proof of concept but am fairly sure you can create a directory under data (like members) and then folks can create individual JSON files therein, rather than all collected in one file.

Code of conduct

  • I agree to follow this project's code of conduct

Thoughts That Sprung To Mind Around Security and Abuse

Your issue

Thoughts That Sprung To Mind Around Security and Abuse

Want to preface by emphasizing I think this is a super neat idea that could be super beneficial to the community, and to thank everyone involved for their work on it.

When I was trying to wrap my head around what it was, I had a few thoughts spring to mind around security and abuse scenarios. I wanted to share them just to get them out of my head and better understand if they're actually pointing to anything.

Malicious Actor Posing as Someone Else

If someone malicious submits a request to join, maybe posing as someone else in the community and using their website but with a tiny difference that's hard to spot (like 1 letter off in the domain name, or other standard email phishing sort of techniques) that looks exactly like that person's actual website, it seems like they might be able to sneak in and then phish users of the webring.

Rough Idea to Combat Malicious Actor Posing as Someone Else

Add a out-of-band validation step to make sure the person is who they say they are (e.g. reaching out on one of the socials they offer. Presumably that's harder to manufacture replicas of? Not sure)

Link Destinations Being Masked are Challenging

Similar to the email phishing analogy above, it seems like it'd be hard for a user to safely evaluate whether or not to follow a previous/next/random link since you can't easily tell where it's going to take you or if it might be a malicious site.

Even with no malicious sites in the webring, there's also the concern of the webring's backend getting compromised and a malicious actor taking control of the redirection (e.g. for phishing) without anyone noticing.

Rough Idea to Combat Link Destinations Being Masked are Challenging

If there's some kind of independent way from the backend resource to monitor the redirects that are occurring (e.g. via gateway access logs) presumably it'd be possible to detect if something is going awry with them

Code of conduct

  • I agree to follow this project's code of conduct

Are Personal-ish Sites Allowed?

Your issue

Hello. I am one person currently running my web forum https://basementcommunity.com.

It's an internet discussion board for general and focused topics with no real intent on making money or being a business, but really just a hobby project for myself with a goal of creating a community of people fatigued from modern social media.

That being said, I'm a huge a11y advocate and pride myself on making my site as accessible as possible. But I'm not planning on revealing my identity willingly for the foreseeable future.

So the question is, are sites like mine allowed to join the webring?

Code of conduct

  • I agree to follow this project's code of conduct

[Bug] Forced-colors and contrast

What happened?

When using forced-colors, the icons (socials, previous, random, next) retain their dark-blue color. This can cause contrast issues for users, like myself, who use forced-colors with a dark color palette.

Operating systems

Fedora 37

Browsers

Firefox 110 (Developer Edition), official build

Anything else?

Here's a screenshot of the page as it appears to me:

The homepage's previous/random/next links, and the first two entries in the members list, with a dark theme and dark-blue icons. Icons for socials and prev/random/next have poor contrast against the almost black background..

One solution would be to respond to a prefers-colors: forced media query to color the SVGs with currentColor, giving them the same color as surrounding text.

To maximize compatibility, this could even be inverted: the default color could be currentColor, and a custom blue could only activate in response to prefers-contrast: no-preference or prefers-contrast: less. Ben Nadel uses a similar approach for reduced-motion: make the default the accessible version, and override it if possible.

Code of conduct

  • I agree to follow this project's code of conduct

[Bug] Missing Whitespace Between Words of Previous/Random/Next Website Links

What happened?

Within the <nav> containing the "Previous/Random/Next website" links, the mark-up looks like:

<a class="contact-link" ...>
	<svg ... aria-hidden="true">...</svg>
	<span>Previous/Random/Next<span class="hide-visually"> website</span></span>
</a>

I.e. the visible labels are "Previous", "Random", and "Next", with additional context of "website" appended for screen reader users. Unfortunately, there is no whitespace rendered between the visible label and off-screen context in Chromium-based browsers, creating accessible names for these links of: "Previouswebsite", "Randomwebsite", and "Nextwebsite".

I can think of several ways to fix this (probably too many), in no particular order:

  1. Add a non-breaking space (&nbsp;) at the beginning of each off-screen span. This will fix the issue in Chromium-based browsers, but result in two spaces between the words in browsers not currently exhibiting the issue.
  2. Make the full text of each link visible, including the word "website", removing the off-screen text altogether. This may look cluttered (I'm blind so I legitimately have no idea), but it would make the website consistent with the sample code for members which doesn't include off-screen text.
  3. Add aria-label to each link with the correct accessible name in each case. @ericwbailey has already amply covered the problems with aria-label.
  4. Add an ID to the single span that wraps the visible label and off-screen text, and use that ID as the value of an aria-labelledby attribute on the parent link. It's a bit weird that this seems to fix things in Chromium, given that the link is getting its acc name from the same mark-up that is otherwise problematic. I've only tested that this doesn't break anything else in Firefox and iOS Safari, but I recall some recent discussion around aria-labelledby being broken... somewhere? Otherwise, this is probably my preferred approach after #2.
  5. Move the off-screen span so that it is a sibling of the visible label span, give each span an ID, and use two space-separated IDs in aria-labelledby on the parent link. This is similar to #4, but a bit more... standard.
  6. Add a <title> to the <svg>, give the title an ID, and use that ID in aria-labelledby on the parent link. This would duplicate the visible label, introducing technical debt and making visible/accessible name drift more likely in the future.
  7. Same as #6, but just have the accessible name of the SVG bubble up to become the acc name of the link, and add aria-hidden="true" to the current spans. This would cause screen reader announcements of "link graphic" instead of "link" (and a corresponding increase in braille verbosity), and otherwise shares the downside of #6.

Thank you for reading my essay.

Operating systems

Windows 10 Pro, Windows 11 Pro

Browsers

Google Chrome, Microsoft Edge

Anything else?

No response

Code of conduct

  • I agree to follow this project's code of conduct

[Feature suggestion] Support linking to an accessibility statement

Feature suggestion

Some personal websites have accessibility statements, such as the kind recommended by the WAI. Linking to that alongside socials could be a nice touch.

Who would you like to work on this feature?

  • I would like to work on this feature
  • I would like the site maintainers to work on this feature

Code of conduct

  • I agree to follow this project's code of conduct

Consider checking for build errors as a pre-commit check

Your issue

I noticed that commits after c40ce94 weren't being reflected on the live site - this is because of a syntax error in the JSON that was committed.

Besides fixing the syntax error, would it make sense to add a Github Action to make sure the site builds? If that makes sense, I wouldn't mind making a pull request for it.

Code of conduct

  • I agree to follow this project's code of conduct

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.