How can you write inclusive code?

1 Use inclusive language

One of the most important aspects of writing inclusive code is to use inclusive language. Inclusive language is language that does not discriminate, degrade, or erase anyone based on their identity, background, or experience. For example, avoid using gendered terms, such as master/slave, whitelist/blacklist, or guys, unless they are relevant and accurate. Instead, use neutral terms, such as primary/secondary, allowlist/blocklist, or folks. Also, avoid using terms that imply a norm or a default, such as normal, standard, or regular, unless they are necessary and justified. Instead, use terms that describe the specific feature or function, such as default, typical, or common.

2 Consider different perspectives

Another aspect of writing inclusive code is to consider different perspectives and contexts of the people who will interact with your code. This means being aware of how your code might affect or be affected by different cultures, languages, locations, abilities, preferences, and expectations. For example, avoid using hard-coded values, such as date formats, currency symbols, or time zones, that might not apply or make sense to everyone. Instead, use flexible and adaptable values, such as ISO standards, locale settings, or user preferences. Also, avoid using images, icons, or colors that might have different meanings or associations for different people. Instead, use clear and consistent symbols, labels, and contrasts.

3 Seek feedback and collaboration

A third aspect of writing inclusive code is to seek feedback and collaboration from others who have different experiences and perspectives than you. This means being open to learning from and listening to people who belong to different groups, communities, or backgrounds than you. For example, ask for code reviews, testing, or suggestions from people who have different levels of expertise, knowledge, or familiarity with your code. Also, invite and encourage contributions, comments, or questions from people who have different interests, goals, or motivations for using or creating your code.

4 Follow standards and guidelines

A fourth aspect of writing inclusive code is to follow standards and guidelines that promote and support inclusivity in software development. This means being aware of and adhering to the best practices and recommendations that have been established and recognized by the industry, the community, or the organization. For example, follow the Web Content Accessibility Guidelines (WCAG) that provide principles and criteria for making web content accessible to people with disabilities. Also, follow the Contributor Covenant that provides a code of conduct for open source projects that fosters a welcoming and respectful environment for everyone.

5 Learn and improve

A fifth aspect of writing inclusive code is to learn and improve your skills and knowledge on inclusivity in software development. This means being curious and humble about the topic and seeking opportunities to expand your understanding and awareness. For example, read books, articles, blogs, or podcasts that discuss and share insights and experiences on inclusivity in software development. Also, attend workshops, webinars, courses, or events that teach and demonstrate skills and techniques on how to write inclusive code.

6 Be respectful and empathetic

A sixth aspect of writing inclusive code is to be respectful and empathetic towards yourself and others who are involved in software development. This means being mindful and compassionate about the impact and influence of your code and your behavior on others. For example, acknowledge and appreciate the diversity and complexity of people who use, create, and maintain software. Also, apologize and correct your mistakes if you unintentionally or unknowingly write or say something that is exclusive or harmful.

7 Here’s what else to consider

This is a space to share examples, stories, or insights that don’t fit into any of the previous sections. What else would you like to add?