Возможность привлечения независимых разработчиков к участию в проекте — одно из важнейших достоинств модели Open Source. Таким образом к составлению рекомендаций для потенциальных участников сообщества следует относится максимально серьёзно, поскольку от этого зависит как их количество, так и их вклад.
Основатель и руководитель проекта DFSA Сафия Абдалла решила поделиться своим опытом написания подобных рекомендаций. На сайте OpenSource.com она изложила основные принципы, которыми следует руководствоваться основателям проектов.
Подавляющее большинство людей, которые будут читать рекомендации, никогда не принимали участия в вашем проекте и, вероятнее всего, слабо представляют, что именно от них требуется. Поэтому изложенная информация должна быть рассчитана на новичков — опытные люди вполне могут обойтись и без них.
Следует учитывать, что вклад в открытый проект — это пусть небольшой, но подвиг. Читатель должен знать, что его участие будет оценено. Именно это может мотивировать его присоединиться к совместной работе.
Рекомендации должны быть полными. Не следует бояться повторять то, что кажется автору общеизвестным или легко находимым в сети. Совершенно не очевидно, что новый участник осведомлён во всех вопросах — в общем случае для успешной работы ему должно быть достаточно только составленной инструкции.
С самого начала следует задать дружеский тон в общении. Не стоит быть слишком серьёзным — несколько шуток и каламбуров сделают текст менее формальным и не отпугнут от участия в проекте чрезмерно стеснительных людей.
Особое внимание нужно уделить структуре документа, хоть это и самое сложное. Рекомендации должны читаться легко и потенциальный участник вправе рассчитывать на то, что он сможет быстро найти интересующую именно его информацию.
Это принципы могут показаться достаточно банальными, однако на практике им очень непросто следовать. Тем более, что чрезмерное усердие может привести к результату, противоположному ожидаемому.
Например, желание сделать руководство максимально подробным может привести к тому, что его объём превысит сколько-нибудь разумные размеры. Или нарочито неформальное обращение может быть истолковано некоторыми потенциальными участниками как панибратство и позволит им сделать вывод о несерьёзном характере всего проекта.
Поэтому не следует воспринимать их как некую догму — к рекомендациям следует относится творчески, имея в виду потенциальные масштабы проекта. В крайнем случае — найти похожий проект с развитым сообществом и использовать его инструкцию в качестве шаблона.
