Recommended
More Related Content
Similar to Docs for Good
Similar to Docs for Good (20)
Recently uploaded
Recently uploaded (20)
Docs for Good
- 1. Docs, Equity & Imposter Syndrome JULIA SEIDMAN
- 2. Hi! I'm Julia! HOW I GOT HERE: BA - ANTHROPOLOGY FINANCIAL COMMUNICATIONS MASTER'S IN TEACHING / ADVANCED CERTIFICATE IN TESOL HIGH SCHOOL ENGLISH & ESL EPICODUS TECHNICAL CONTENT DEVELOPER/WRITER J S
- 3. What is Imposter Syndrome? LACK OF SELF-TRUST FEAR OF FAILURE PERFECTIONISM REJECTION OF PRAISE GUILT AND ANXIETY ABOUT SUCCESS
- 5. Entelo Women In Tech Report, March 2018
- 8. That is not your fault. UNDERMINED EXCLUDED THREATENED If you feel...
- 11. Can telling someone to "Read the docs!" be harmful? You bet it can! My journey in tech started - and nearly ended - with a book recommendation.
- 12. IN-JOKES & 'INSIDER' REFERENCES What's holding us back? OFFENSIVE & JUDGMENTAL TONE ABSTRACT EXAMPLES JARGON & ABBREVIATIONS CONVOLUTED ORGANIZATION LACK OF CLEAR PURPOSE/AUDIENCE
- 13. Culturally Responsive Teaching "It is an approach that empowers students intellectually, socially, emotionally, and politically by using cultural referents to impart knowledge, skills, and attitudes." Gloria Landson-Billings
- 14. CRT Principles: Reflect on your OWN cultural lens. Recognize and redress bias in the system. Communicate in linguistically and culturally responsive ways. Demonstrate respect for diversity. Emphasize real-world context.
- 15. Reflect on your own lens: INVENTORY YOUR ASSUMPTIONS What prior knowledge are you assuming readers have? Who do you envision using this resource? Are you leaving room for people who don't fit that mold? ASK FOR FEEDBACK What do people around you say about how you communicate? Are you getting feedback from a diverse group of people? How can you seek feedback from a more diverse group? CHALLENGE YOUR OWN BIASES Actively look for the influence of your own prejudices and blind spots.
- 16. Recognize & Redress Bias We know where the needs are. Prioritize marginalized groups in your writing. Don't patronize. Resources, prior knowledge and prejudice are the barriers, NOT intellect or drive.
- 17. Communicate in linguistically and culturally responsive ways, i.e., AVOID Jargon foo-bar acronyms with no explanation unfamiliar abbreviations (A11y) "Insider" references hyper-focus on niche cultural references minimizing language ('just', 'easy', 'only') INSTEAD Use plain language Explain technical terms Spell out acronyms and abbreviations Explain references Provide live links Use well-known cultural references and relatable metaphors Acknowledge that this stuff is challenging! Talk to people where they are!
- 18. Emphasize Real-World Context Give readers a schema by activating prior knowledge. Use real-world scenarios to demonstrate real value. People want to feel their life experiences are relevant.
- 20. Bias is endemic in tech. Many, many people feel excluded and marginalized. BAD NEWS: GOOD NEWS: There are simple ways - like writing better docs - that we can help make the industry more inclusive.
- 21. THANKS FOR LISTENING! Remember why you are writing, and that your words have power.