Проект по обновлению документации UTM5
Проект по обновлению документации UTM5
Компанией NetUP был начат проект по переработке документации к биллинговой системе UTM5. Целью является доходчивое донесение до конечного пользователя (системного администратора) сведений о использовании системы.
Пре-релизы частей документации будут появляться прежде всего здесь: http://www.netup.ru/netup_wiki
Новые части будут появляться сразу после написания.
Соответственно, если возникнут пожелания и замечания, прошу писать в данной ветке форума. Возможно, ваши замечания и пожелания помогут вашим коллегам. В дальнейшем для обсуждения каждого большого раздела документации будет создано по ветке.
Пре-релизы частей документации будут появляться прежде всего здесь: http://www.netup.ru/netup_wiki
Новые части будут появляться сразу после написания.
Соответственно, если возникнут пожелания и замечания, прошу писать в данной ветке форума. Возможно, ваши замечания и пожелания помогут вашим коллегам. В дальнейшем для обсуждения каждого большого раздела документации будет создано по ветке.
В майском релизе основной акцент будет сделан только на наиболее проблемных участках, касающихся UTM5, поскольку практически нереально переработать всю документацию к маю.
Некоторые вопросы, относящиеся к настройке стороннего програмного обеспечения, не являются на данный момент приоритетом и будут рассмотрены в более поздних ревизиях.
Новые части документации будут содержаться в актуальном состоянии.
Некоторые вопросы, относящиеся к настройке стороннего програмного обеспечения, не являются на данный момент приоритетом и будут рассмотрены в более поздних ревизиях.
Новые части документации будут содержаться в актуальном состоянии.
К сожалению - это не представляется возможным по вполне понятным причинам:XoRe писал(а): А вы доступ на запись откройте...
Я думаю, народ быыстро нарисует валидного контента выше крыши
a) документация должна быть технически корректна
б) документация должна быть стилистически корректна
в) документация должна быть полна и описывать весь функционал, заявленный в функциональной таблице
г) документация должна быть единообразно структурирована
в) документация должна пройти редактирование (включая техническую редакцию техническим специалистом/программистом)
Весь комплекс задач решить открытием доступа пользователям сложно.
И главное, UTM5 - коммерческий продукт, и компания обязана собственными силами разрабатывать и поддерживать к нему документацию.
Если вы желаете помочь с написанием - милости прошу. Статью можете постить прямо здесь, или присылать на supinfo@netup.ru с меткой темы Документация.
Но скорее ожидаются комментарии и пожелания к существующим разделам. Возможно, какие-то моменты не совсем понятны и прозрачны. Такие комментарии и пожелания очень приветсвуются.
2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
Т.е. в результате будет не строгая документация, а скорее некая экспертная система, полная советов и руководств.
К примеру, чтоб utm5_core подключился к mysql, нужно прописать в настройках mysql опцию old_password=1.
В документации об этом ничего нет.
А на форуме полно тем с этой информацией, но темы уезжают вниз и не все любят пользоваться поиском.
А так можно было бы держать это на виду.
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
Т.е. в результате будет не строгая документация, а скорее некая экспертная система, полная советов и руководств.
К примеру, чтоб utm5_core подключился к mysql, нужно прописать в настройках mysql опцию old_password=1.
В документации об этом ничего нет.
А на форуме полно тем с этой информацией, но темы уезжают вниз и не все любят пользоваться поиском.
А так можно было бы держать это на виду.
- Chistiakov_A
- NetUP Team
- Сообщения: 190
- Зарегистрирован: Пн мар 21, 2005 18:30
Считаю данную затею вполне интересной. Мне приходила в голову подобная мысль - сделать дополнительную ВИКИ, где все, кто захотят смогу писать все, что угодно (с постмодерацией ессно)... Попробуем реализовать...XoRe писал(а):2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
- Chistiakov_A
- NetUP Team
- Сообщения: 190
- Зарегистрирован: Пн мар 21, 2005 18:30
Попробовали поднять движокChistiakov_A писал(а):Считаю данную затею вполне интересной. Мне приходила в голову подобная мысль - сделать дополнительную ВИКИ, где все, кто захотят смогу писать все, что угодно (с постмодерацией ессно)... Попробуем реализовать...XoRe писал(а):2Altaire:
Тогда такое предложение - сделать ещё один открытый раздел.
Чтобы умудренные опытом пользователи UTM могли делиться этим опытом с другими, писали и наполняли FAQ, выкладывали готовые решения.
http://www.netup.ru/open_wiki
Просьба писать по делу и отнестись с пониманием...
Последний раз редактировалось Chistiakov_A Пн апр 16, 2007 14:54, всего редактировалось 1 раз.
-
- Сообщения: 1612
- Зарегистрирован: Пт ноя 10, 2006 15:23
- Lex
- NetUP Team
- Сообщения: 623
- Зарегистрирован: Ср мар 09, 2005 12:12
- Откуда: НетАП
- Контактная информация:
Действительно там ошибка. В ближайшее время исправим, спасибо.marvin писал(а):В разделе ru/UTM5/Guide/RADIUS/Operation scheme/ есть сомнительное место: "IP-адрес, ассоциированный с сессией, помечается как свободный" - в описании действия по получении start-пакета. Может, это всё-таки относится к stop-пакету?