CodeNewbie Community 🌱

Discussion on: [On-Demand Talk] Docs For Equity - Teaching Our Way Out Of Impostor Syndrome

Collapse
 
itsasine profile image
Kayla

The "What's Holding Us Back" slide is perfect 🙌

This single page needs to be sent out to any dev tech that has public docs. It's hard to know how many people who would have used your product/language but couldn't get beyond the docs and moved on to something else.

I get so turned off as an end user if a product says to "just" do a thing that's totally obvious (not...). Even the classic "foobar" examples are a form of injoke that makes it hard to follow if you don't know what foo and bar denote.

Collapse
 
itsasine profile image
Kayla • Edited on

Whoops, just got to the part of the talk where you call out foobar and just haha

Collapse
 
jhermann profile image
Jürgen Hermann

The light grey text on that slide is a a11y nightmare though. 😬

Collapse
 
juliaseid profile image
Julia Seidman Author

Oh, thanks for calling that out! I'm not a front-end dev, so I don't tend to think about those aspects of accessibility. It's a good reminder that it matters in presentations, too!

Thread Thread
 
juliaseid profile image
Julia Seidman Author

I just checked on the color contrast on this slide, and it's 9.8:1 (#fffcf7, #424242), so definitely a pass from WCAG. I think the apparent lack of contrast is actually a function of font size and reduced screen size or resolution with the format the slides are in here.

A reminder that color contrast is a starting place, not the end-all measure of accessibility, since I agree it is not super readable!

Collapse
 
itsasine profile image
Kayla

True, though there wouldn't have been enough time to update it after the a11y talk right before it ;) haha