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

#codeland2021 #writing #inclusion #mentalhealth

About this talk

What we call "Imposter Syndrome" is often not really that at all - for many people, workplace anxiety and feelings of isolation and exclusion are the result of systemic bias and discrimination. These are problems for the industry and community to address, not individuals. I am suggesting one tool (though many are needed) to help build a more inclusive tech industry. As a former teacher, I apply the principles of Culturally Responsive Teaching to my technical writing, and in this talk, I explain why and how that works.

Takeaways

The tech industry has an enormous diversity and inclusivity problem, but platitudes aren't helping us when the problems are so deep-seated.
People's early experiences in the tech industry often include being told to "Read the docs!", only to find that the docs are implicitly and explicitly biased.
We can do better, and the principles of Culturally Responsive Teaching provide a framework to create docs that better meet the needs of marginalized communities in tech.

Slides

>> Click here to download slides

🌈 Comment below and ask me questions — I might just answer them during my live speaker discussion!

About Julia Seidman

Julia is a believer in the careen, rather than the career. After studying anthropology and writing a senior thesis on the ethics of museum collections of human skeletal remains, she took the job she could get: fundraising for a hospital. From there, she became a financial analyst and employee educator for 401k plans. Then, after getting her Master's in education, she taught high school English and ESL for most of a decade. Now, she is a technical content marketing consultant and developer.

This on-demand talk is part of CodeLand 2021 — a virtual conference brought to you by CodeNewbie & DEV on September 23 & 24, 2021.

Latest comments (56)

Martin Hresko • Jan 7 '22 • Edited

In your video (starting at the 7:03 mark), you indirectly reference “Learn Python the Hard Way" by Zed Shaw and state "... i was blown away by blatant homophobia, transphobia and misogyny throughout the book." While I am not a fan of this style of teaching/learning, I have previously glanced through his book and don't recall seeing what you claim. Would you be so kind to point these out in his book?

Ayu Adiati • Sep 23 '21

Such a great talk, @juliaseid !
I agree that documentations have to be accessible for everyone and shouldn't caused imposter syndrome in any way.

callumreid • Sep 23 '21

Wow this was such an eye opener for me. Thank you for this talk!

amneet-b • Sep 23 '21

Hi! Reminder that if you have any questions for @juliaseid to drop them here! We'll address these questions in the live speaker discussion. 📣

Nad • Sep 23 '21

I will definitely be going back to rewatch this talk.

As a student I often felt confused by documentation and always thought that it was due to a lack of knowledge and understanding on my part. It was really frustrating and discouraging. But now, as a junior dev I work closely with senior devs and I sometimes see them frustrated and confused by docs and it's finally made me realize that sometimes the docs are just bad. It has nothing to do with my level of knowledge and understanding. And that has been encouraging.

Sarah Rivera • Sep 23 '21

Thank you, great talk!

Tiffany U • Sep 23 '21

Thanks for this talk, Julia! I appreciate the reminder that the main purpose is to help others with our docs, not build up our antihero image!

Julie Zhou • Sep 23 '21

Thank you for this talk! This is such an important topic -- when I started working as a new developer, the lack of access to well-written docs further contributed to my impostor syndrome. It has since made me passionate to write docs that are easier to read and more accessible to all devs.