Проект по обновлению документации UTM5

Форум для размещения материалов по реализации различных схем использования ПО, решению частых проблем и предупреждению частых ошибок
Аватара пользователя
Altaire
NetUP Team
Сообщения: 6
Зарегистрирован: Чт янв 25, 2007 17:36

Проект по обновлению документации UTM5

Сообщение Altaire »

Компанией NetUP был начат проект по переработке документации к биллинговой системе UTM5. Целью является доходчивое донесение до конечного пользователя (системного администратора) сведений о использовании системы.

Пре-релизы частей документации будут появляться прежде всего здесь: http://www.netup.ru/netup_wiki

Новые части будут появляться сразу после написания.

Соответственно, если возникнут пожелания и замечания, прошу писать в данной ветке форума. Возможно, ваши замечания и пожелания помогут вашим коллегам. В дальнейшем для обсуждения каждого большого раздела документации будет создано по ветке.

Аватара пользователя
marvin
Сообщения: 77
Зарегистрирован: Сб мар 24, 2007 11:18
Откуда: Нижняя Тура

Сообщение marvin »

Надеюсь, этот вики будет поддерживаться в актуальном состоянии и после выпуска майского релиза брошюры?

Аватара пользователя
Altaire
NetUP Team
Сообщения: 6
Зарегистрирован: Чт янв 25, 2007 17:36

Сообщение Altaire »

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

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

Новые части документации будут содержаться в актуальном состоянии.

Аватара пользователя
XoRe
Сообщения: 458
Зарегистрирован: Ср янв 10, 2007 16:04

Сообщение XoRe »

Altaire писал(а):практически нереально переработать всю документацию к маю.
А вы доступ на запись откройте...
Я думаю, народ быыстро нарисует валидного контента выше крыши 8)

Аватара пользователя
marvin
Сообщения: 77
Зарегистрирован: Сб мар 24, 2007 11:18
Откуда: Нижняя Тура

Сообщение marvin »

Это - на Википедию. Сделайте там портал "UTM5" :D

Аватара пользователя
Altaire
NetUP Team
Сообщения: 6
Зарегистрирован: Чт янв 25, 2007 17:36

Сообщение Altaire »

XoRe писал(а): А вы доступ на запись откройте...
Я думаю, народ быыстро нарисует валидного контента выше крыши 8)
К сожалению - это не представляется возможным по вполне понятным причинам:
a) документация должна быть технически корректна
б) документация должна быть стилистически корректна
в) документация должна быть полна и описывать весь функционал, заявленный в функциональной таблице
г) документация должна быть единообразно структурирована
в) документация должна пройти редактирование (включая техническую редакцию техническим специалистом/программистом)

Весь комплекс задач решить открытием доступа пользователям сложно.

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

Если вы желаете помочь с написанием - милости прошу. Статью можете постить прямо здесь, или присылать на supinfo@netup.ru с меткой темы Документация.

Но скорее ожидаются комментарии и пожелания к существующим разделам. Возможно, какие-то моменты не совсем понятны и прозрачны. Такие комментарии и пожелания очень приветсвуются.

Аватара пользователя
XoRe
Сообщения: 458
Зарегистрирован: Ср янв 10, 2007 16:04

Сообщение XoRe »

2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.

Т.е. в результате будет не строгая документация, а скорее некая экспертная система, полная советов и руководств.

К примеру, чтоб utm5_core подключился к mysql, нужно прописать в настройках mysql опцию old_password=1.
В документации об этом ничего нет.
А на форуме полно тем с этой информацией, но темы уезжают вниз и не все любят пользоваться поиском.
А так можно было бы держать это на виду.

Аватара пользователя
Chistiakov_A
NetUP Team
Сообщения: 190
Зарегистрирован: Пн мар 21, 2005 18:30

Сообщение Chistiakov_A »

XoRe писал(а):2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
Считаю данную затею вполне интересной. Мне приходила в голову подобная мысль - сделать дополнительную ВИКИ, где все, кто захотят смогу писать все, что угодно (с постмодерацией ессно)... Попробуем реализовать...

Аватара пользователя
Chistiakov_A
NetUP Team
Сообщения: 190
Зарегистрирован: Пн мар 21, 2005 18:30

Сообщение Chistiakov_A »

Chistiakov_A писал(а):
XoRe писал(а):2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
Считаю данную затею вполне интересной. Мне приходила в голову подобная мысль - сделать дополнительную ВИКИ, где все, кто захотят смогу писать все, что угодно (с постмодерацией ессно)... Попробуем реализовать...
Попробовали поднять движок
http://www.netup.ru/open_wiki
Просьба писать по делу и отнестись с пониманием...
Последний раз редактировалось Chistiakov_A Пн апр 16, 2007 14:54, всего редактировалось 1 раз.

Аватара пользователя
XoRe
Сообщения: 458
Зарегистрирован: Ср янв 10, 2007 16:04

Сообщение XoRe »

Большое спасибо, отнесемся с пониманием.

Аватара пользователя
marvin
Сообщения: 77
Зарегистрирован: Сб мар 24, 2007 11:18
Откуда: Нижняя Тура

Сообщение marvin »

А для статей по UTM4 этот движок использовать не возбраняется?

Аватара пользователя
marvin
Сообщения: 77
Зарегистрирован: Сб мар 24, 2007 11:18
Откуда: Нижняя Тура

Сообщение marvin »

В разделе ru/UTM5/Guide/RADIUS/Operation scheme/ есть сомнительное место: "IP-адрес, ассоциированный с сессией, помечается как свободный" - в описании действия по получении start-пакета. Может, это всё-таки относится к stop-пакету?

mikkey finn
Сообщения: 1612
Зарегистрирован: Пт ноя 10, 2006 15:23

Сообщение mikkey finn »

по их уверениям - именно по старт пакету НОВОЙ сессии. Потому как Netflow имеет таймауты, после которых маршрутизатор сбросит их аггрегатору.

Аватара пользователя
Lex
NetUP Team
Сообщения: 623
Зарегистрирован: Ср мар 09, 2005 12:12
Откуда: НетАП
Контактная информация:

Сообщение Lex »

marvin писал(а):В разделе ru/UTM5/Guide/RADIUS/Operation scheme/ есть сомнительное место: "IP-адрес, ассоциированный с сессией, помечается как свободный" - в описании действия по получении start-пакета. Может, это всё-таки относится к stop-пакету?
Действительно там ошибка. В ближайшее время исправим, спасибо.

mazzaika
Сообщения: 18
Зарегистрирован: Пн апр 23, 2007 11:27

Сообщение mazzaika »

А возможно ли скопилировать доку в chm, чтоб работать с ней было удобнее...
Для простого чтения pdf конечно хорошо подходит, но когда ищешь ответ на конкретный вопрос, гораздо удобнее пользовать chm с хорошей навигацией...

Закрыто