Последние несколько лет видели замечательное — и очень необходимое — увеличение внимания к разнообразию, справедливости и включению (DEI) через технологию. Было бы трудно найти серьезный игрок в SAAS, DEVOPS или разработчике, у которых нет какого-то речи миссии DEI, и большинство людей, с которыми я работаю, кажется серьезным в своем желании внести изменения в лучшую сторону.
Изменение сложно, хотя. Это сложнее, когда вы говорите только о проблемах в абстрактном. То, что часто отсутствует в разговоре о DEI, является действенной дорожной картой для улучшения. Я понимаю — трудно узнать, с чего начать, и страшно признать, где мы приходим в короткие сроки.
Вот почему я думаю, что лучше документация — это мощный шаг в правильном направлении. Часто разрабатывает первое взаимодействие с вашей компанией или вашим сообществом, и гарантирует, что вы приветствуете все виды людей, необходимы, если мы собираемся достичь этих целей Dei.
Сколько из нас, в какой-то момент в нашей карьере в этой отрасли, оказались нами, удерживаемся в некотором роде разработчика, который не соответствовал нашим потребностям? Мы могли бы поговорить весь день о плохих советах по толпам, поставляемому платформам, но даже крупные компании часто заполняют свои порталы разработчиков с плохо организованной плотной документацией, которая предполагает много предыдущих знаний. Нахождение контента, которое вам нужно в форме, вы можете быстро понять, может быть трудоемким вызовом, даже для опытных разработчиков.
Борьба еще более важной для людей, приходящих из нетрадиционных фонов. Большая часть разнообразия в сообществе разработчиков не исходит из колледж компьютерных наук. Самоусимовывающиеся разработчики и салоны Bootcamp являются более разнообразными во многих отношениях. Они часто приходят с существенными практическими навыками, но без особых заземления в концепциях компьютерных наук, сетевой архитектуре или истории технологий. Они также могут не иметь такого же «инсайдерских» знаний о именах, событиях и мемах, которые ветераны отрасли принимают как должное.
Документация, которая предполагает, что все разработчики приходят с тем же фоном, это исключая — и есть много. Если мы хотим отрасли, где разработчики со всех фонов приветствуются и поддерживаются, нам нужен контент разработчика, который соответствует людям, где они есть.
Я буду приближаться к этой теме с нескольких разных углов в ближайшие недели. Ни в коем случае не является контентом свежей разработчика заменитель сложных, более сложных разговоров, которые нам нужно иметь о DEI. Проблемы беги глубоко, а решения потребуют много тяжелой работы. Моя надежда, однако, что, показывая один простой путь к улучшению, я могу помочь вам создать прогресс в вашей организации.
Оригинал: «https://dev.to/juliaseid/why-documentation-is-essential-to-your-dei-initiatives-335m»