Приблудянин

03:09 pm: Памятка писателю Policy
Избегайте следующих слов:

• разумный
(без объяснения, почему такое или иное решение разумно)

• как правило
(без объяснения случаев, когда из правила делается исключение)

• уместно
(без объяснения, когда и что уместно)

• следует учесть
(без объяснения, каким конкретно образом следует учесть)

• необходимо сделать
(без объяснения, как это делается)

• в идеале
(policy и так описывает идеал)

• 
  

Проверьте, что вы написали policy, а не учебник и не набор советов.

Не забудьте - письма и куски IRC/Jabber-логов очень редко вписываются в формат policy.

Помните: policy - это законсервированная мудрость предков, готовая к употреблению, а не к размышлению (для размышления существуют дополнения к policy - rationale). Если вам хочется, чтобы читатели часами думали над вашим текстом - смело вычёркивайте "policy" из заголовка, и вписывайте туда "эссе".

Tags: oss, oss-anthropology

07:36 pm: По поводу названий и привычек
В список рассылки django-developers (разработка непосредственно django) постоянно приходят с вопросами разработчики приложений с помощью django. Их отпинывают в django-users.

Мораль: используйте суффикс -hackers для разработки своего продукта, если target audience его являются другие разработчики.

Tags: oss, oss-anthropology

09:35 pm: Релевантность информации и чистка мусора
Во некоторых OSS-проектах (в последнее время за этим замечены OpenWRT, X-Wrt и AltLinux) имеется проблема: некому чистить устаревшую и неверную информацию. Результатом становится огромный массив документации (в особенности в случае хранения её в wiki), в котором где-то находится верная, но отличить её от неверной могут только основные разработчики, держащие детали проекта в голове.

Проблема эта не временная и не безвредная. Новички, приходя в такой проект, не могут найти среди имеющейся документации нужную, и обращаются к членам команды. Члены команды, будучи занятыми, отпинываются и/или озлобляются, причём процесс происходит по нарастающей. В крайних случаях можно наблюдать полное закупоривание разработчиков от "тупых пользователей". Состав основных разработчиков практически не меняется (из-за отсутствия вменяемого пути от юзера к разработчику), что усугубляет элитизм основной группы.

Как мне кажется, источником проблемы является отсутствие энергичного, въедливого и аккуратного человека (вероятно, эпилептоидной акцентуации) среди разработчиков изначально или с раннего этапа развития проекта.

Вылечить на поздних стадиях тяжело - необходим как раз такой энергичный, въедливый и аккуратный человек, наделённый к тому же властью (если основные разработчики работают на какую-то компанию) или уважением, достаточным для того, чтобы часто отрывать занятых людей от работы и выспрашивать о том, валиден ли данный кусок документации, или уже является хламом, а также много времени на разгребание уже понаписанного.

Tags: oss, oss-anthropology