Новый формат Документации

ИС УТП АвтоПарк - использование, проблемы, достижения.

Новый формат Документации

Сообщение Леонид Сандал » Вторник 23.10.2007 12:32

Мы переезжаем на несколько иной формат Документации и Новостей - см. http://www.autopark.ru/wiki.
Wiki движок специально предназначен для коллективной работы над, как правило, документацией. Самый известный проект - Википедия (http://www.wikipedia.org).

Преимущества для тех кто пишет:

1 Вносить изменения намного проще, чем в той технологии, которой мы пользовались до сих пор. Соответственно, надо гораздо меньше думать над тем, стоит ли заниматься отражением какого-либо факта в документации или ну его, ибо себе дороже ;) Соответственно, документация будет полнее (я думаю, существенно полнее). Можно посмотреть, например, состав Новостей с 10.10.2007 - раньше о такой ерунде мы никогда не писали, а ведь кому-то может оказаться полезным.
2 Движок намного лучше приспособлен под документацию, например, есть стандартная функция "Версия для печати", что, как Вы знаете, важно. И очень полезная возможность структурирования информации по многоуровневым категориям.
3 Вносить изменения можем не только мы, но и Вы, если, конечно, есть желание ;) - больше авторов - больше информации - больше пользы.
4 Нормальная поддержка коллективной работы, включая разруливание конфликтов (когда одну статью терзают несколько авторов) и полную историю ВСЕХ изменений.
5 Мгновенная доставка изменений до потребителя, ибо все это делается в онлайне. Нет заморочек с установкой обновления Новостей (хотя она и делается простыми кликами, но все равно этим надо заниматься).

Преимущества для тех, кто читает:
1 Чем лучше тем, кто пишет, тем лучше тем, кто читает ;)
2 Чтобы быть в курсе Новостей и вообще всех изменений достаточно сделать RSS подписку здесь - здесь
3 Легко распечатать

Перевод старой Документации на новый формат будет происходить постепенно - в новой есть ссылки. Но Новости отныне только в новом формате (на то они и Новости).
Аватара пользователя
Леонид Сандал
pit
pit
 
Сообщения: 1382
Зарегистрирован: Среда 30.05.2007 18:54
Откуда: Полак АйТи

Сообщение Сергей Королев » Вторник 23.10.2007 12:48

Weeee-HAAAAA!!! :Yahoo!:

Спасибо огромное, это очень удобно.
Один вопрос - как будет выглядеть локальная документация у предпрриятий? тоже wiki-движок, или в прежнем формате?
Аватара пользователя
Сергей Королев
 
Сообщения: 94
Зарегистрирован: Среда 13.06.2007 08:15
Откуда: МП Химкиэлектротранс

Сообщение Сергей Королев » Вторник 23.10.2007 13:10

А, пришло письмо, всё стало ясно. Теперь всё будет тут.
Аватара пользователя
Сергей Королев
 
Сообщения: 94
Зарегистрирован: Среда 13.06.2007 08:15
Откуда: МП Химкиэлектротранс

Сообщение Павел Штатнов » Вторник 23.10.2007 13:21

Отличная идея. Спасибо.
Аватара пользователя
Павел Штатнов
 
Сообщения: 528
Зарегистрирован: Четверг 07.06.2007 11:20
Откуда: Ивантеевка

Сообщение Леонид Сандал » Вторник 23.10.2007 13:49

Сергей Королев писал(а):Один вопрос - как будет выглядеть локальная документация у предпрриятий? тоже wiki-движок, или в прежнем формате?


А также письмо, пришедшее по почте:

Обрадовали. Интернет не на всех рабочих местах…


Варианты:
а) Нормальным было бы так - у всех пользователей локальной сети есть выход в Инет (трафик ничтожный, ибо фактически только текст). Понятны опасения относительно предоставления всем такого доступа в Инет. Можно сделать ограниченный (на заданный перечень адресов) доступ, однако это некоторый геморой в настройке маршрутизатора.
б) Можно делать локальную копию с помощью offline броузеров (вот пример обзора таких программ - http://itc.ua/article.phtml?ID=12432&IDw=29&pid=18. Т.е. смысл в следующем - на сервере предприятия делается (по расписанию) копия интернет сервера с Документацией, причем, что важно, в html виде. Все желающие могут смотреть (с помощью IE, FireFox, Opera и т.п.) там - как в обычной сетевой папке.
в) Развернуть на Windows сервере Apache и время от времени тиражировать туда содержимое Документации - подробности тут (Википедия). Но, это, видимо, из области фантастики.


На самом деле актуальным является вот какой вопрос - а каков тот средний пользователь, который читал html Документацию с экрана компьютера? В том смысле, что это вопрос с двумя подвопросами:
а) Кто ее вообще читал?
б) Из тех, кто читал - кто читал на экране?

Нам кажется, что большое количество пользователей, вроде диспетчеров, таксировщиков, кладовщиков и т.д., в лучшем случае имеют печатную копию и, часто, вовсе не из Документации. Что касается пользователей, работа которых предполагает существенно больший объем знаний и умений, то, как нам кажется, им бы не вредно было иметь доступ к Интернет.
Очень хотелось бы знать, какова на Ваш (всех) взгляд, ситуация в данном вопросе?
Аватара пользователя
Леонид Сандал
pit
pit
 
Сообщения: 1382
Зарегистрирован: Среда 30.05.2007 18:54
Откуда: Полак АйТи

Сообщение Сергей Королев » Вторник 23.10.2007 13:57

Да всё правильно, у нас документацию по софту, кроме АСУ не читает никто.
Аватара пользователя
Сергей Королев
 
Сообщения: 94
Зарегистрирован: Среда 13.06.2007 08:15
Откуда: МП Химкиэлектротранс

Сообщение Павел Штатнов » Вторник 23.10.2007 14:20

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

1. Делай раз.
2. Делай два.
3. Делай три.
......

Смело переводите документацию в WEB
Аватара пользователя
Павел Штатнов
 
Сообщения: 528
Зарегистрирован: Четверг 07.06.2007 11:20
Откуда: Ивантеевка

Сообщение Светлана Хорькова » Вторник 23.10.2007 15:56

Леонид Сандал писал(а):а) Кто ее вообще читал?
б) Из тех, кто читал - кто читал на экране?


читали в первую очередь асушники,
пользователи только когда отсылали к документации
если над тектом нужно было поразмыслить, или был написан пример, то печатали
Аватара пользователя
Светлана Хорькова
 
Сообщения: 1637
Зарегистрирован: Четверг 07.06.2007 11:23
Откуда: А/k-1792 г.Клин

Документация - Автопарк

Сообщение Татьяна Гуркина » Среда 24.10.2007 07:23

Нам тоже понравилось
Аватара пользователя
Татьяна Гуркина
 
Сообщения: 45
Зарегистрирован: Пятница 08.06.2007 16:01
Откуда: г.Видное

Re: Документация - Автопарк

Сообщение Павел Штатнов » Среда 24.10.2007 07:59

GTN писал(а):Нам тоже понравилось



О, наконец-то, Видное вышло на форум. Татьяна, поздравляю тебя с твоим первым сообщением!!!
Аватара пользователя
Павел Штатнов
 
Сообщения: 528
Зарегистрирован: Четверг 07.06.2007 11:20
Откуда: Ивантеевка

Сообщение Антон Фурин » Среда 24.10.2007 09:22

У нас документацию читаю я и еще два человека, больше никто. Иногда я распечтываю новости для некоторых отделов.
Аватара пользователя
Антон Фурин
 
Сообщения: 74
Зарегистрирован: Пятница 08.06.2007 07:18
Откуда: Солнечногорск

Сообщение Орещук Светлана » Среда 24.10.2007 10:04

Новости читаю только я. Распечатываю для информации по отделам, если нужно.
Орещук Светлана
 
Сообщения: 243
Зарегистрирован: Пятница 08.06.2007 07:32
Откуда: Можайское ПАТП

Сообщение Сергей Королев » Среда 24.10.2007 10:05

Неправда, я тоже читаю! =)
Аватара пользователя
Сергей Королев
 
Сообщения: 94
Зарегистрирован: Среда 13.06.2007 08:15
Откуда: МП Химкиэлектротранс

Сообщение Леонид Сандал » Среда 23.01.2008 16:02

Что-то ситуация с чтением Новостей удручающая (я уж молчу про Документацию как таковую и совсем молчу про Свежие правки).

Сегодняшнее обновление (ww_00262) старых Новостей, в котором большими буквами написана отсылка на новые Новости, навеяно свежим заявлением одного из пользователей о том, что он (пользователь) исправно читает Новости и последняя датируется 08.10.2007.

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

Трудно регулярно поглядывать туда? Трудно классифицировать Новости, т.е. понять, интересны ли они для предприятия и, если да, то каким именно пользователям их следует адресовать? Другие трудности?
Аватара пользователя
Леонид Сандал
pit
pit
 
Сообщения: 1382
Зарегистрирован: Среда 30.05.2007 18:54
Откуда: Полак АйТи

Сообщение Леонид Сандал » Среда 23.01.2008 16:15

Леонид Сандал писал(а):Что-то ситуация с чтением Новостей удручающая (я уж молчу про Документацию как таковую и совсем молчу про Свежие правки).

Сегодняшнее обновление (ww_00262) старых Новостей, в котором большими буквами написана отсылка на новые Новости, навеяно свежим заявлением одного из пользователей о том, что он (пользователь) исправно читает Новости и последняя датируется 08.10.2007.

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

Трудно регулярно поглядывать туда? Трудно классифицировать Новости, т.е. понять, интересны ли они для предприятия и, если да, то каким именно пользователям их следует адресовать? Другие трудности?


Полный финиш! Только написал этот пост - бамс - два обращения:

Вы планируете делать сведения в ПФ в формате XML? Нам надо.


Подскажите, пожалуйста, а в Автопарке не поддержано формирование ПФР за 2007 в формате XML7. Или мы не там ищем?
Аватара пользователя
Леонид Сандал
pit
pit
 
Сообщения: 1382
Зарегистрирован: Среда 30.05.2007 18:54
Откуда: Полак АйТи

След.

Вернуться в Обсуждение АвтоПарк

Кто сейчас на конференции

Сейчас этот форум просматривают: Ahrefs (Bot) и гости: 24

cron