[docs] ВНИМАНИЕ: отчёт и насущные проблемы

[Michael Shigorin]

On Tue, Jan 11, 2005 at 04:59:13PM +0300, Alexandre Prokoudine wrote:
> <offtopic>
> Вообще говоря, именно печатную документацию удобнее читать в
> том виде, в каком она была для "Утёса" -- нормальная тетрадь,
> которую не страшно развернуть, опасаясь некачественного клея.
> Но стоимость уже одной такой тетради закрывает этот вопрос ещё
> на долгое время.
> </offtopic>

Вообще говоря, я как не соглашался с AEN, что книжка в Junior 2.2
лучше книжки в Junior 2.0 именно в форматном плане, так и не
соглашаюсь.

Ну не будет ни начинающий, ни тем более опытный читать сто
страниц вместо тридцати с небольшим.

А силы и время лучше потратить на чёткость формулировок и
примеров, на продуманность и сжатость, чем на страницы и книжки.

Опять же сужу по размышлениям, вновь вынутым ответом на не шибко
давний вопрос в fido7.ru.linux (прицеплен) -- насчёт "может, пора
пожалеть бумагу, если её всё равно не будут читать?"...  Ведь
"классические юниксы" могли комплектоваться по шесть тыщ страниц
manual pages, и чем это им помогло?

-- 
 ---- WBR, Michael Shigorin <mike на altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/
----------- следущая часть -----------
From: Michael Shigorin <mike на osdn.org.ua>
Newsgroups: fido7.ru.linux
Subject: Re: издание по Open Source-системам
Date: Sat, 8 Jan 2005 12:30:03 +0000 (UTC)
Message-ID: <crojob$1cln$1 на news.wnet.ua>

PreScriptum: отношение к идее положительное, потому и критика.

Alexander Lubyagin <Alexander.Lubyagin на p70.f16.n5056.z2.fidonet.org> wrote:
> Основной вопрос - кто будет писать в наше издание качественные статьи ?

Качественные авторы с качественной мотивацией (или никто).

> Допустим, что нашлись десяток-пара десятков человек, которые способны
> и готовы писать по статье в месяц, выкладывая, допустим, их у себя на
> сайте, и отсылая в редакцию. Редакция журнала оценивает присланные
> статьи (технически это может быть реализовано через премодерируемый
> список рассылки и обычную почту, либо на server-side scripts).

Для этого редакция должна быть в состоянии оценить, как минимум.

> Следующий вопрос - как сформировать редакторский коллектив ?
> Специалисты, вроде vitus'а, netch'а, и других гуру, imho, заниматься
> этим не будут ввиду отсутствия времени, несравненно большего опыта.
> Однако, редакторами должны быть именно гуру. А гуру будут
> редактировать, imho, только если им будут интересны сами статьи.
> Получается замкнутый круг.

Расшивается он, _на мой взгляд_.  Уточню круг:

- гуры не пишут, потому что и так дел завались (и свалить особо не на
  кого), да и писать-то особо некуда.
- чайники пишут-пишут-пишут, но вот читать это могут только такие же
  чайники (у меня есть фото Димы Левина при диагоналенье статьи "о
  настройке ssh-сервера" на предпоследнем lf :).

В силу малого пересечения получаем медленный рост в заданных предметных
областях чайников до гур.

Предлагается следующий workflow:

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

Ожидается следующий результат:

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

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

> Сейчас мы обсудили эти вопросы с Сашей Колотовым - линуксоидом из
> Кирова, и пришли к выводу, что раскручивать издание не надо. Если
> народу будет интересно - он сам подтянется. Активных линуксоидов в
> Кирове - человек 7, из которых три-четыре человека могут писать статьи
> (разного качества).  Интересно услышать ваше мнение - каким вам
> видится издание по Open Source ?

Ну меня тут пытались отпинать осенью по той же теме -- есть люди,
которые умеют делать бумагу, нужен контент.  Есть подозрение, что нужен
ещё и спрос, причём не то что в Кирове, а и в Киеве (и скорее всего -- в
Москве) он сейчас сам по себе не возникнет в отбивающихся объёмах.

Помимо этого -- есть ещё одно издание, выразившее (в лице руководства)
желание издавать книги, брошюры по свободному софту и связанным
технологиям.  Есть минимум один образовательный центр, где умеющие
дорабатывать курсы (для этого надо как минимум быть уровнем не ниже
существующих) также are welcome.

Это не говоря про те же osp / intuit, которые вполне активно работают с
авторами из .ru, .by, .ua.

В общем, для домашнего заработка и прочих мемуаров тут простор есть и
вполне, мало того -- у нас была создана и рассылка для координации
авторов и издателей на такое.  Рассылка, как и предполагалось в
отсутствие координатора -- мёртвая.

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

http://lists.osdn.org.ua/wws/arc/publishing/2004-08/msg00000.html

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

-- 
Michael Shigorin
EMT.Com.UA