Home

Приблудянин

Свежие записи

You are viewing the most recent 3 entries

Март 7, 2008

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

  • разумный
  • (без объяснения, почему такое или иное решение разумно)
  • как правило
  • (без объяснения случаев, когда из правила делается исключение)
  • уместно
  • (без объяснения, когда и что уместно)
  • следует учесть
  • (без объяснения, каким конкретно образом следует учесть)
  • необходимо сделать
  • (без объяснения, как это делается)
  • в идеале
  • (policy и так описывает идеал)



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

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

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

Настроение: energetic
Tags: ,

Сентябрь 27, 2007

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

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

Tags: ,

Сентябрь 23, 2007

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

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

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

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

Tags: ,
Разработано LiveJournal.com

Реклама