Приблудянин ([info]dottedmag) wrote,
@ 2008-03-07 15:09:00
Previous Entry  Add to memories!  Tell a Friend!  Next Entry
Current mood: energetic
Entry tags:oss, oss-anthropology

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


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



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

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

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

(Post a new comment)


[info]vitus_wagner
2008-03-07 09:57 am UTC (link)
Распечатать и на стенку над монитором!

(Reply to this)


[info]anyher
2008-03-07 12:13 pm UTC (link)
"здравый смысл" еще забыл

(Reply to this) (Thread)

[info]bugware
2008-03-07 12:21 pm UTC (link)
И в заголовке "Policy", хотя на самом деле это набор советов =)

(Reply to this) (Parent)(Thread)

[info]dottedmag
2008-03-08 09:14 pm UTC (link)
fixed.

(Reply to this) (Parent)

[info]migmit
2008-03-07 04:22 pm UTC (link)
Памятка писателю блога:

Избегайте следующих слов:

- Policy
(без объяснения, что это такое)

(Reply to this)


[info]mrv1
2008-03-07 10:31 pm UTC (link)
предположите что у читателя вашего текста есть моск

(Reply to this) (Thread)

[info]dottedmag
2008-03-08 09:01 pm UTC (link)
Это выстраданный текст - результат чтения того, что называют "полиси" в одном не столь отдалённом открытом проекте.

(Reply to this) (Parent)

[info]spb_nick
2008-03-09 04:51 pm UTC (link)
Про открытые проекты:

Заливаю сбэкпорченные/правленные пакеты в общий storage, решил проверить везде ли поменял Maintainer, где надо:
$ for f in *.deb; do dpkg -I $f; done | grep Maintainer\\\|Package
 Package: curl
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libcurl3
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libcurl3-dbg
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libcurl3-gnutls
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libcurl4-gnutls-dev
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libcurl4-openssl-dev
 Maintainer: Nikolai Kondrashov <Nikolai.Kondrashov@sbaltetko.ru>
 Package: libssh2-1
 Maintainer: Mikhail Gusarov <dottedmag@gamdettod.net>
 Package: libssh2-1-dbg
 Maintainer: Mikhail Gusarov <dottedmag@gamdettod.net>
 Package: libssh2-1-dev
 Maintainer: Mikhail Gusarov <dottedmag@gamdettod.net>

"Как тесен мир", ага :)

(Reply to this) (Thread)

[info]dottedmag
2008-03-09 05:19 pm UTC (link)
:)

(Reply to this) (Parent)

Create an Account
Forgot your login or password?
Login w/ OpenID
English • Español • Deutsch • Русский…