[Sysadmins] q: переработка [[Etcnet]]

[Sysadmins] q: переработка [[Etcnet]]

[Michael Shigorin]

	Здравствуйте.
Предлагаю на http://www.altlinux.org/Etcnet оставить
действительно краткую инструкцию (по сути про initconf),
собственно содержимое вынести в подстраницы по разделам:
"введение и почему так", "рецепты на скорую руку",
"опытному системному администратору", "устаревшее"
(Linux 2.4.x).

Мне видится оформление а-ля http://www.altlinux.org/LTSP,
но это явно заангажированное мнение. :)

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Sysadmins] q: переработка [[Etcnet]]

[REAL]

20.01.2011 05:07, Michael Shigorin пишет:
> Предлагаю на http://www.altlinux.org/Etcnet оставить
> действительно краткую инструкцию (по сути про initconf),
> собственно содержимое вынести в подстраницы по разделам:
> "введение и почему так", "рецепты на скорую руку",
> "опытному системному администратору", "устаревшее"
> (Linux 2.4.x).

А в идеале довести alterator до такого состояния, чтобы даже краткой в 
инструкции отпала бы нужна ;)

PS. Но это не значит, что инструкция не нужна, она нужна. Но я про 
альтератор :)

-- 

REAL aka Евгений Ростовцев, программист ЦНИТ КемГУ

Re: [Sysadmins] q: переработка [[Etcnet]]

[Alexey Petrakov]

В сообщении от 20 января 2011 10:39:28 автор REAL написал:
> А в идеале довести alterator до такого состояния, чтобы даже краткой в
> инструкции отпала бы нужна ;)

До какого бы крутого состояния не был доведён альтератор, инструкция нужна. 
Потому что среди тех, кому удобнее настраивать сеть напрямую, а не через ГУЙ 
телепатов-ясновидящих довольно мало.

Re: [Sysadmins] q: переработка [[Etcnet]]

[Anton Farygin]

20.01.2011 10:47, Alexey Petrakov пишет:
> В сообщении от 20 января 2011 10:39:28 автор REAL написал:
>> А в идеале довести alterator до такого состояния, чтобы даже краткой в
>> инструкции отпала бы нужна ;)
>
> До какого бы крутого состояния не был доведён альтератор, инструкция нужна.
> Потому что среди тех, кому удобнее настраивать сеть напрямую, а не через ГУЙ
> телепатов-ясновидящих довольно мало.

Я бы сказал, что они полностью отсутствуют.

лучше инструкцию расширить, чем альтератор.

Re: [Sysadmins] q: переработка [[Etcnet]]

[Anton Farygin]

20.01.2011 07:39, REAL пишет:
> 20.01.2011 05:07, Michael Shigorin пишет:
>> Предлагаю на http://www.altlinux.org/Etcnet оставить
>> действительно краткую инструкцию (по сути про initconf),
>> собственно содержимое вынести в подстраницы по разделам:
>> "введение и почему так", "рецепты на скорую руку",
>> "опытному системному администратору", "устаревшее"
>> (Linux 2.4.x).

Миша, то, что сейчас написано - вполне юзабельное - не надо менять, надо 
только исправлять и дополнять.

>
> А в идеале довести alterator до такого состояния, чтобы даже краткой в
> инструкции отпала бы нужна ;)
>
> PS. Но это не значит, что инструкция не нужна, она нужна. Но я про
> альтератор :)

не, давайте лучше по инструкции.

Re: [Sysadmins] q: переработка [[Etcnet]]

[Sergey]

On Thursday 20 January 2011, Anton Farygin wrote:

> Миша, то, что сейчас написано - вполне юзабельное - не надо менять, надо 
> только исправлять и дополнять.
 
Мне тоже текущий вариант нормальным кажется. А краткую инструкцию можно
отдельно сделать. Более того, её уже кто-то начал делать, а я чуть-чуть,
бегло, поправил: 
http://www.altlinux.org/Настройка_сетевой_карты,_краткое_пособие_для_начинающих
В форуме наткнулся: http://forum.altlinux.org/index.php/topic,4563.0.html

-- 
С уважением, Сергей
a_s_y@sama.ru

Re: [Sysadmins] q: переработка [[Etcnet]]

[Michael Shigorin]

On Thu, Jan 20, 2011 at 01:03:29PM +0300, Anton Farygin wrote:
> >>Предлагаю на http://www.altlinux.org/Etcnet оставить
> >>действительно краткую инструкцию (по сути про initconf),
> >>собственно содержимое вынести в подстраницы по разделам:
> >>"введение и почему так", "рецепты на скорую руку",
> >>"опытному системному администратору", "устаревшее"
> >>(Linux 2.4.x).
> Миша, то, что сейчас написано - вполне юзабельное - не надо
> менять, надо только исправлять и дополнять.

Не-а, там есть довольно критичные грабли вроде описания iftab
вместо /etc/udev/rules.d/70-persistent-net.rules...

Объём тоже считаю проблемой.  Достоинство ровно одно -- поиск
по странице.  Но как скажете.

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Sysadmins] q: переработка [[Etcnet]]

[Afanasov Dmitry]

[-- Attachment #1: Type: text/plain, Size: 798 bytes --]

On Fri, Jan 21, 2011 at 01:15:51AM +0200, Michael Shigorin wrote:
> On Thu, Jan 20, 2011 at 01:03:29PM +0300, Anton Farygin wrote:
> > Миша, то, что сейчас написано - вполне юзабельное - не надо
> > менять, надо только исправлять и дополнять.
> 
> Не-а, там есть довольно критичные грабли вроде описания iftab
> вместо /etc/udev/rules.d/70-persistent-net.rules...
ну, "исправлять и дополнять", ведь.

> Объём тоже считаю проблемой.  Достоинство ровно одно -- поиск
> по странице.  Но как скажете.
а может стоит пойти по стандартному пути: переписать на sgml и
генерить paged html и большой html, как и везде? заодно и упаковать можно
будет.

пусть и объем, но удобно. что не мешает быть рядом будет постраничной
дока. главное здесь - рядом :)
-- 
 С уважением
 Афанасов Дмитрий

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [Sysadmins] q: переработка [[Etcnet]]

[Michael Shigorin]

On Fri, Jan 21, 2011 at 06:58:38AM +0300, Afanasov Dmitry wrote:
> а может стоит пойти по стандартному пути: переписать на sgml

Во-первых, тогда уж DocBook (HOWTO давным-давно мигрировали).

Во-вторых, это подходит для N малого авторов -- при в целом
сформированном содержимом и малопредсказуемых правках/добавках
вики _гораздо_ лучше.

Это уже проходили с docs/heap vs atmsk/linux-os/freesource...

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Sysadmins] q: переработка [[Etcnet]]

[Afanasov Dmitry]

[-- Attachment #1: Type: text/plain, Size: 821 bytes --]

On Fri, Jan 21, 2011 at 06:52:27AM +0200, Michael Shigorin wrote:
> On Fri, Jan 21, 2011 at 06:58:38AM +0300, Afanasov Dmitry wrote:
> > а может стоит пойти по стандартному пути: переписать на sgml
> 
> Во-первых, тогда уж DocBook (HOWTO давным-давно мигрировали).
ну ведь написал же docbook сначала, да засомневался! жаль переписать
нельзя :)

> Во-вторых, это подходит для N малого авторов -- при в целом
> сформированном содержимом и малопредсказуемых правках/добавках
> вики _гораздо_ лучше.
> 
> Это уже проходили с docs/heap vs atmsk/linux-os/freesource...
я рассматривал лишь одну задачу: один источник - несколько форматов.
задачу с количеством автором я не решал, да.

так что остается у меня лишь просьба, чтобы большая и актуальная портянка
тоже жила.

-- 
 С уважением
 Афанасов Дмитрий

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [Sysadmins] q: переработка [[Etcnet]]

[Michael Shigorin]

On Fri, Jan 21, 2011 at 08:04:21AM +0300, Afanasov Dmitry wrote:
> так что остается у меня лишь просьба, чтобы большая и
> актуальная портянка тоже жила.

Понял, спасибо.

-- 
 ---- WBR, Michael Shigorin <mike@altlinux.ru>
  ------ Linux.Kiev http://www.linux.kiev.ua/

Re: [Sysadmins] q: переработка [[Etcnet]]

[Хихин Руслан]

[-- Attachment #1: Type: text/plain, Size: 838 bytes --]

Здравствуйте Michael Shigorin
  В сообщении от 21 января 2011 Michael Shigorin написал(a):
> Не-а, там есть довольно критичные грабли вроде описания iftab
> вместо /etc/udev/rules.d/70-persistent-net.rules...

Тут ещё надо учесть, что надо указывать область действия рецепта, 
например, для бренча 4.х iftab, наверное, актуально.

-- 
  А ещё говорят так  (fortune):
 
One monk said to the other, "The fish has flopped out of the net! 
How will it live?" The other said, "When you have gotten out of 
the net, I'll tell you." 
________________________________________________________________________
С уважением Хихин Руслан

[-- Attachment #2: This is a digitally signed message part. --]
[-- Type: application/pgp-signature, Size: 198 bytes --]

Re: [Sysadmins] q: переработка [[Etcnet]]

[Anton Farygin]

21.01.2011 02:15, Michael Shigorin пишет:
> On Thu, Jan 20, 2011 at 01:03:29PM +0300, Anton Farygin wrote:
>>>> Предлагаю на http://www.altlinux.org/Etcnet оставить
>>>> действительно краткую инструкцию (по сути про initconf),
>>>> собственно содержимое вынести в подстраницы по разделам:
>>>> "введение и почему так", "рецепты на скорую руку",
>>>> "опытному системному администратору", "устаревшее"
>>>> (Linux 2.4.x).
>> Миша, то, что сейчас написано - вполне юзабельное - не надо
>> менять, надо только исправлять и дополнять.
>
> Не-а, там есть довольно критичные грабли вроде описания iftab
> вместо /etc/udev/rules.d/70-persistent-net.rules...

С устаревшими граблями всё понятно. Но только большая просьба - когда 
будешь поправлять пиши нормальным человеческим языком, а не своим 
"копи-пасте из рассылок".

Понимаю, что последнее намного быстрее, но удобнее читать хороший текст, 
а не набор выхваченных из темы фраз или ссылок.

>
> Объём тоже считаю проблемой.  Достоинство ровно одно -- поиск
> по странице.  Но как скажете.

Объём - это не проблема при наличии нормального содержания.