[Comm] heap.altlinux -- устаревшая документация

[Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

На heap.altlinux.ru местами лежит сильно устаревшая документация. И ее 
находят "обычные пользователи", да еще и советуют другим, не менее 
обычным пользователям. Например, на вопрос на форуме про настройку сети, 
была приведена ссылка 
http://heap.altlinux.org/alt-docs/modules/network_setup.kirill/index.html, 
морально устаревшая еще к прошлому релизу.

Надо что-то делать. На что багу вешать?

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 18:00:44 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 AVM> На heap.altlinux.ru местами лежит сильно устаревшая
 AVM> документация. И ее находят "обычные пользователи", да еще и
 AVM> советуют другим, не менее обычным пользователям.

А разработчики не находят, ибо на heap найти что-то можно только с
сильного перепуга :D

 AVM> Например, на вопрос на форуме про настройку сети, была приведена
 AVM> ссылка
 AVM> http://heap.altlinux.org/alt-docs/modules/network_setup.kirill/index.html,
 AVM> морально устаревшая еще к прошлому релизу.

 AVM> Надо что-то делать. На что багу вешать?

В продукт "Docs". Если не найдётся подходящего компонента - спросить
Кирилла Маслинского (kirill@), что с этим сделать.

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 20:47:12 10.02.2008 UTC+03 when Michael Solodkiy did gyre and gimble:

 MS> Тем более обидно, что решение многих проблем в комьюнити
 MS> обсуждалось, но ве это очень сложно собирать воедино, потому что
 MS> обсуждения проблем и вариантов решений очень сильно "размазано" по
 MS> рассылке - почему бы не выделять такие топики в отдельные статьи
 MS> документации?

Кто бы взялся за это?

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 23:50:28 10.02.2008 UTC+06 when Mikhail Gusarov did gyre and gimble:

 MS>> Тем более обидно, что решение многих проблем в комьюнити
 MS>> обсуждалось, но ве это очень сложно собирать воедино, потому что
 MS>> обсуждения проблем и вариантов решений очень сильно "размазано" по
 MS>> рассылке - почему бы не выделять такие топики в отдельные статьи
 MS>> документации?

 MG> Кто бы взялся за это?

Поясню - это очевидно, но никто этого не делает. Очевидно, что силами
ООО это не поднять (да и не нужно сейчас (sic!) никому в ООО), а в
коммунити только разве что Майк периодически кидает в wiki письма "как
есть".

Вот например, что мешает вам взять и собрать топики из списков рассылки
по fglrx в одну доку на wiki?

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

Mikhail Gusarov пишет:
>
> Вот например, что мешает вам взять и собрать топики из списков рассылки
> по fglrx в одну доку на wiki?
> 
Вот конкретно этот вопрос должен свести воедино тот человек, который 
точно знает, где, что и как. Кто у нас этот герой?

Вот список больных вопросов (по результатам прочтения форума):

- "su -"
- настройка сети в etcnet
-- более конкретно, настройка VPN/pppoe
- настройка apt на репозитарии, обновление системы, установка программ
- включение/отключение сервисов
- упомянутая проблема с АТи

Ответы на все эти вопросы можно сформулировать в 5 строчек. И эти 
ответы, ЕСЛИ ЗНАЕШЬ ЧТО ИСКАТЬ, можно найти в сети. Но если не знаешь...

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 21:25:20 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 AVM> Вот конкретно этот вопрос должен свести воедино тот человек,
 AVM> который точно знает, где, что и как.

А вы попробуйте его спросить? Не хочет отвечать? Не может ответить? Не
желает документировать? Нельзя заставить, ибо доброволец? Увы, придётся
вам - по результатам чтения списка рассылки.

 AVM> Ответы на все эти вопросы можно сформулировать в 5 строчек. И эти
 AVM> ответы, ЕСЛИ ЗНАЕШЬ ЧТО ИСКАТЬ, можно найти в сети. Но если не
 AVM> знаешь...

Ну вот вы же знаете уже? Так помогите.

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

Mikhail Gusarov пишет:
> Twas brillig at 21:25:20 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:
> 
>  AVM> Вот конкретно этот вопрос должен свести воедино тот человек,
>  AVM> который точно знает, где, что и как.
> 
> А вы попробуйте его спросить? Не хочет отвечать? Не может ответить? Не
> желает документировать? Нельзя заставить, ибо доброволец? Увы, придётся
> вам - по результатам чтения списка рассылки.
> 

Э-э-э... нет! Я с АТи не работал, не работаю, и в ближайшее время не 
собираюсь. Так что компетентно по теме высказаться не могу.

>  AVM> Ответы на все эти вопросы можно сформулировать в 5 строчек. И эти
>  AVM> ответы, ЕСЛИ ЗНАЕШЬ ЧТО ИСКАТЬ, можно найти в сети. Но если не
>  AVM> знаешь...
> 
> Ну вот вы же знаете уже? Так помогите.

Куда? На wiki? Там все как-то черезвычайно неудобно структурировано и 
организовано. На взгляд человека, который туда изредка заглядывает. А уж 
на взгляд новичка совсем все страшно. А так я готов написать ответы на 
эти несколько вопросов.

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 21:33:02 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 >> Ну вот вы же знаете уже? Так помогите.

 AVM> Куда? На wiki? Там все как-то черезвычайно неудобно
 AVM> структурировано и организовано. На взгляд человека, который туда
 AVM> изредка заглядывает. А уж на взгляд новичка совсем все страшно. А
 AVM> так я готов написать ответы на эти несколько вопросов.

Ну вот и выяснили *настоящую* проблему. Да, на wiki всё неудобно и
неорганизованно (не буду плеваться ядом в тех, кто любит насвинячить, и
в тех, кто организовывает так, чтобы от насвиняченного было трудно
избавиться). Поможете разобрать? Я недавно прошёлся, и немалую часть
старого мусора выкинул, а статьи по похожим темам сгрёб в кучку, но там
ещё много работы.

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

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

Mikhail Gusarov пишет:

> Поможете разобрать? 

Что и как разбирать? Всю freesource.wiki? Мне слабо.

Если есть ссылка вида "по ссылке и ниже оставляем вопросы-ответы для 
пользователей ALD4", то с удовольствием по ней перейду.

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 21:47:10 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 >> Поможете разобрать? 

 AVM> Что и как разбирать? Всю freesource.wiki? Мне слабо.

:(

Всю разбирать и правда никакой силы не хватит. А вот кусочек... Ну
ладно.

 AVM> Если есть ссылка вида "по ссылке и ниже оставляем вопросы-ответы
 AVM> для пользователей ALD4", то с удовольствием по ней перейду.

http://www.freesource.info/wiki/AltLinux/Releases/40 - конкретные
вопросы стоит добавлять в раздел "документация". Я для примера там
создал ссылочки про fglrx и ADSL - поправьте, как считаете нужным.

В ближайшее время я обустрою http://www.freesource.info/wiki/AltLinux -
помещу там ссылки на документацию на актуальные дистрибутивы etc, помимо
того дерева, что слева болтается.

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 21:47:10 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 AVM> Если есть ссылка вида "по ссылке и ниже оставляем вопросы-ответы
 AVM> для пользователей ALD4", то с удовольствием по ней перейду.

"После завершения обновления желательно перезагрузить компьютер." - а
откуда такой совет? Имхо, он из категории вредных :)

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

Mikhail Gusarov пишет:
> Twas brillig at 21:47:10 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:
> 
>  AVM> Если есть ссылка вида "по ссылке и ниже оставляем вопросы-ответы
>  AVM> для пользователей ALD4", то с удовольствием по ней перейду.
> 
> "После завершения обновления желательно перезагрузить компьютер." - а
> откуда такой совет? Имхо, он из категории вредных :)

Для тех, кто "все понимает" перезагрузка необязательна. Однако, 
случается, что в том же sisyphus@ периодически кто-то натыкается на 
проблемы, которые проходят с перезагрузкой. А уж новичкам, которые не 
могут вручную перестартовать "заглючившие" сервисы, или понять, что 
странное поведение системы вылечится перезапуском Иксов, проще 
перезагрузить всю систему. ИМХО.

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 23:33:02 10.02.2008 UTC+03 when Alexei V. Mezin did gyre and gimble:

 AVM> Однако, случается, что в том же sisyphus@ периодически кто-то
 AVM> натыкается на проблемы, которые проходят с перезагрузкой.

Такие проблемы лучше лечить.

 AVM> А уж новичкам, которые не могут вручную перестартовать
 AVM> "заглючившие" сервисы, или понять, что странное поведение системы
 AVM> вылечится перезапуском Иксов, проще перезагрузить всю
 AVM> систему. ИМХО.

Эээ. Странно ведёт - перезагрузить. Зачем превентивно-то?

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Vladimir V. Kamarzin]

>>>>> On 11 Фев 2008 at 01:33 "AVM" == Alexei V Mezin writes:

>>  AVM> Если есть ссылка вида "по ссылке и ниже оставляем вопросы-ответы
>>  AVM> для пользователей ALD4", то с удовольствием по ней перейду.
>> 
>> "После завершения обновления желательно перезагрузить компьютер." - а
>> откуда такой совет? Имхо, он из категории вредных :)

AVM> Для тех, кто "все понимает" перезагрузка необязательна. Однако, 
AVM> случается, что в том же sisyphus@ периодически кто-то натыкается на 
AVM> проблемы, которые проходят с перезагрузкой. А уж новичкам, которые не 
AVM> могут вручную перестартовать "заглючившие" сервисы, или понять, что 
AVM> странное поведение системы вылечится перезапуском Иксов, проще 
AVM> перезагрузить всю систему. ИМХО.

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

-- 
 * wRAR пойдет убьет себя книжкой по С++
<stalker37> wRAR:  и не жалко книжку?
<wRAR> stalker37: книжке не сделается ниче
<stalker37> wRAR: Смотря как убиваться....
<hostmaster> wRAR: "убъет свой мозг книжкой по C++"

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 09:30:33 11.02.2008 UTC+03 when Michael Solodkiy did gyre and gimble:

 MS> 1) Не очень понятно, что куда писать. То есть чисто
 MS> организационно. Вот скажем, я взялся заморочаться документированием
 MS> проблемы с fglrx (во-первых, я в этом сам заинтересован, во-вторых
 MS> - я готов на это потратить время), что мне делать?

Прямо сейчас - спросить меня, куда лучше всего поместить статью. Как
только я наведу нормальную навигацию на fs.i - станет легче.

 MS> 2) Не все проблемы имеют однозначное решение. То есть, для того,
 MS> чтобы документация была адекватна, по любому нужно вмешательство (и
 MS> заинтересованность!) в процесс со стороны "гуру" :) Как правильно
 MS> отметил Алексей - человек который точно знает "что где и как"
 MS> должен, как минмум, принимать участие в процессе.

 MS> Потому что в случае

 >> А вы попробуйте его спросить? Не хочет отвечать? Не может ответить?
 >> Не желает документировать? Нельзя заставить, ибо доброволец? Увы,
 >> придётся вам - по результатам чтения списка рассылки.

 MS> есть большой риск, что документайия будет неадекватна или просто с
 MS> ошибками.

 MS> А просто скопипастить "размазанные" по рассылке варианты решений -
 MS> это не подход, согласитесь.

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

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Mikhail Gusarov]

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

Twas brillig at 09:30:33 11.02.2008 UTC+03 when Michael Solodkiy did gyre and gimble:

 MS> 1) Не очень понятно, что куда писать. То есть чисто
 MS> организационно. Вот скажем, я взялся заморочаться документированием
 MS> проблемы с fglrx (во-первых, я в этом сам заинтересован, во-вторых
 MS> - я готов на это потратить время), что мне делать?

В данном случае - http://www.freesource.info/wiki/AltLinux/Releases/40,
там уже заготовлена ссылка на (пока не существующую) страницу,
описывающую настройку fglrx.

-- 
JID: dottedmag@jabber.dottedmag.net

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

Re: [Comm] heap.altlinux -- устаревшая документация

[George V. Kouryachy]

On Sun, Feb 10, 2008 at 06:00:44PM +0300, Alexei V. Mezin wrote:
> 
> На heap.altlinux.ru местами лежит сильно устаревшая документация. И ее 
> находят "обычные пользователи", да еще и советуют другим, не менее 
> обычным пользователям. Например, на вопрос на форуме про настройку сети, 
> была приведена ссылка 
> http://heap.altlinux.org/alt-docs/modules/network_setup.kirill/index.html, 
> морально устаревшая еще к прошлому релизу.
> 
> Надо что-то делать. На что багу вешать?

george@arnor:~> apt-cache search network_setup.kirill
docs-network_setup-kirill - Настройка сети

На пакет docs-network_setup-kirill

-- 
			George V. Kouryachy (aka Fr. Br. George)
			mailto:george at altlinux_org

Re: [Comm] heap.altlinux -- устаревшая документация

[Michael Shigorin]

On Tue, Feb 12, 2008 at 11:12:12PM +0300, George V. Kouryachy wrote:
> На пакет docs-network_setup-kirill

Или просто docs-network_setup, их разыменовывали :)

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

Re: [Comm] heap.altlinux -- устаревшая документация

[Alexei V. Mezin]

Michael Shigorin пишет:
> On Tue, Feb 12, 2008 at 11:12:12PM +0300, George V. Kouryachy wrote:
>> На пакет docs-network_setup-kirill
> 
> Или просто docs-network_setup, их разыменовывали :)
> 

Подвесил #14407 на пакет docs-network_setup-kirill.