Страница 1 из 4

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

СообщениеДобавлено: Вторник 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 Легко распечатать

Перевод старой Документации на новый формат будет происходить постепенно - в новой есть ссылки. Но Новости отныне только в новом формате (на то они и Новости).

СообщениеДобавлено: Вторник 23.10.2007 12:48
Сергей Королев
Weeee-HAAAAA!!! :Yahoo!:

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

СообщениеДобавлено: Вторник 23.10.2007 13:10
Сергей Королев
А, пришло письмо, всё стало ясно. Теперь всё будет тут.

СообщениеДобавлено: Вторник 23.10.2007 13:21
Павел Штатнов
Отличная идея. Спасибо.

СообщениеДобавлено: Вторник 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 Документацию с экрана компьютера? В том смысле, что это вопрос с двумя подвопросами:
а) Кто ее вообще читал?
б) Из тех, кто читал - кто читал на экране?

Нам кажется, что большое количество пользователей, вроде диспетчеров, таксировщиков, кладовщиков и т.д., в лучшем случае имеют печатную копию и, часто, вовсе не из Документации. Что касается пользователей, работа которых предполагает существенно больший объем знаний и умений, то, как нам кажется, им бы не вредно было иметь доступ к Интернет.
Очень хотелось бы знать, какова на Ваш (всех) взгляд, ситуация в данном вопросе?

СообщениеДобавлено: Вторник 23.10.2007 13:57
Сергей Королев
Да всё правильно, у нас документацию по софту, кроме АСУ не читает никто.

СообщениеДобавлено: Вторник 23.10.2007 14:20
Павел Штатнов
У нас документацию тоже никто не читает. Все требуют узкоспециализированных инструкций на бумаге под нос типа:

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

Смело переводите документацию в WEB

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


читали в первую очередь асушники,
пользователи только когда отсылали к документации
если над тектом нужно было поразмыслить, или был написан пример, то печатали

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

СообщениеДобавлено: Среда 24.10.2007 07:23
Татьяна Гуркина
Нам тоже понравилось

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

СообщениеДобавлено: Среда 24.10.2007 07:59
Павел Штатнов
GTN писал(а):Нам тоже понравилось



О, наконец-то, Видное вышло на форум. Татьяна, поздравляю тебя с твоим первым сообщением!!!

СообщениеДобавлено: Среда 24.10.2007 09:22
Антон Фурин
У нас документацию читаю я и еще два человека, больше никто. Иногда я распечтываю новости для некоторых отделов.

СообщениеДобавлено: Среда 24.10.2007 10:04
Орещук Светлана
Новости читаю только я. Распечатываю для информации по отделам, если нужно.

СообщениеДобавлено: Среда 24.10.2007 10:05
Сергей Королев
Неправда, я тоже читаю! =)

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

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

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

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

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

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

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

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


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

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


Подскажите, пожалуйста, а в Автопарке не поддержано формирование ПФР за 2007 в формате XML7. Или мы не там ищем?