CodeNewbie Community 🌱

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

Collapse
 
fizzybuzzybeezy profile image
fizzybuzzybeezy

I like your perspective and will work to incorporate it in my own approaches to creating documentation, training, and instructions.

My first question was about finding good example ideas for documentation (in cases where having an example helps) without a wide viewership of the work. Upon going through your slides again, however, I see that the answer may lie in identifying my own biases and thinking about how to make examples from real world and more shared experiences, in a respectful manner. After all that, practice and getting feedback helps, I'd imagine. Did I get that right?

Thank you Julia!

Thread Thread
 
juliaseid profile image
Julia Seidman

Ah, gotcha! Yeah, I think if I were going to set a goal for a longer version of this talk, it would be to provide more concrete examples of what's working well. Two challenges with that - first, it can be hard to find exemplary work that stands up to being blurbed, and second, I'm reluctant to name names. There's no one right approach, except for people to work actively to be more inclusive. What that's going to mean differs from person to person and audience to audience, and I'd rather talk about approaches than products for that reason.