|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Хотел выделить именно слово пишется. Почему в проектах пишется пользовательская документация, например для различных АРМ. Почему бы не снять её в виде удобного видео ролика? Где будет шаг за шагом всё показано и рассказано. Точнее это бы было несколько роликов, каждый бы отвечал за собственную часть документации. Так проще внести изменения в документацию. Ну и конечно нельзя ограничиться только одним видео, должна быть и документация в справочном виде, чтобы можно было пройтись поиском, когда знаешь что ищешь и когда в целом уже знаком с системой. Но ни разу не встречал такой документации. Именно документации, а не ознакомительного ролика. А ведь при правильном подходе, на мой взгляд, это будет и удобнее для потребителей документации и хорошо для производителя продукта. И поставляться это всё может в удобной программной обёртке, с содержанием, индексированием роликов, чтобы удобно было навигироваться и чтобы всё было связано - печатный вариант и видео версия. Или может так делают, а просто я не встречал? ... |
|||
:
Нравится:
Не нравится:
|
|||
14.09.2010, 19:22 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
junixar Или может так делают, а просто я не встречал? просто не встречал ... |
|||
:
Нравится:
Не нравится:
|
|||
14.09.2010, 20:43 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Скажем так - не ПИШЕТСЯ, а РАЗРАБАТЫВАЕТСЯ :) Но не суть важно... Видеороликов полно - сейчас лениво искать, но встречал их массу. Фишка в другом: если разрабатывается документация для ПОТРЕБИТЕЛЯ - владельца мобилы, покупателя коробочного софта и пр. - тогда записывайте и прикладывайте к девайсу или софтине любые ролики, бумажное руководство и не понадобится. А если разрабатывается (пишется, составляется) документация по госконтракту? Как сдачу-приемку работы тогда обеспечить? Военпред ролики смотреть не станет - ему вынь да положь ТЗ, технический проект, рабочую и эксплуатационную документацию, программу и методику испытаний на бумаге - тогда есть шанс сдать ему работу... Кстати, последняя редакция некоторых ГОСТ предусматривает интерактивную документацию в электронном виде. Правда, не совсем понятно, как техник самолета будет шарахаться по лючкам и отсекам борта с ноутбуком, тыкать в кнопки и выполнять на борту регламентные работы? В общем, интересную тему Вы открыли... Предлагаю отдохнуть и расслабиться . И посмеяться от всей души :) ... |
|||
:
Нравится:
Не нравится:
|
|||
14.09.2010, 21:01 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
точно, "просто не встречал"! ток на вскидку: ISCRA Framework, Восточный экспресс, 1C ... ... |
|||
:
Нравится:
Не нравится:
|
|||
15.09.2010, 08:40 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
1. В процессе разработки документации требуется ее много ПРАВИТЬ. Что удобнее делать с текстом. 2. По законодательству некоторых стран к продукту должна быть приложена документация. Сочтут ли соответствующие органы видеоролики документацией - я не в курсе. 3. Тексты писать банально дешевле. Техпис может быть хоть заикой, а для видеороликов нужен диктор, еще и ему платить. ... |
|||
:
Нравится:
Не нравится:
|
|||
15.09.2010, 12:32 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Есть требования ГОСТ, которым некоторые организации очень любят следовать. А некоторые особо прогрессивные хотят помимо руководства на бумажном носителе получить демо-ролики. Документы потом сдадут в бухгалтерию, как отчетные материалы по проекту, а роликами потом будут реально пользоваться в работе. Кроме того, эффект от демонстрации руководства пользователя на бумажном носителе сильнее при демонстрации его аудиту, как одного из результатов проекта. Дескать, вот как хорошо подрядчики поработали, смотрите, какое толстое руководство пользователя на неё получилось. ... |
|||
:
Нравится:
Не нравится:
|
|||
15.09.2010, 12:46 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
junixarПочему в проектах пишется пользовательская документация, например для различных АРМ. Почему бы не снять её в виде удобного видео ролика? Где будет шаг за шагом всё показано и рассказано. Такие видеоматериалы широко используются при дистанционном обучении (через интернет) в различных учебных курса (т. е. предполагается как-бы разовое их использование - для получения обших навыков работы или для ознакомления с возможностями системы). Имхо, они малоудобны при использовании их в качестве повседневной эксплуатационной документации, когда требуется быстро найти ответ для решения возникшей проблемы. ... |
|||
:
Нравится:
Не нравится:
|
|||
15.09.2010, 16:14 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
А я думал речь в топике о спец. программе которая сама будет создавать документацию к любой системе!!! ..... а тут ролики какие-то ... |
|||
:
Нравится:
Не нравится:
|
|||
16.09.2010, 10:05 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
junixar wrote: > Хотел выделить именно слово пишется. Почему в проектах пишется > пользовательская документация, например для различных АРМ. Почему бы не > снять её в виде удобного видео ролика? некоторые и снимают. Зайди на сайт kdenlive например. Posted via ActualForum NNTP Server 1.4 ... |
|||
:
Нравится:
Не нравится:
|
|||
16.09.2010, 10:22 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Ivan DurakА я думал речь в топике о спец. программе которая сама будет создавать документацию к любой системе!!! ..... а тут ролики какие-то и еще сама писать системы ... |
|||
:
Нравится:
Не нравится:
|
|||
16.09.2010, 11:37 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafmIvan DurakА я думал речь в топике о спец. программе которая сама будет создавать документацию к любой системе!!! ..... а тут ролики какие-то и еще сама писать системы и сама ими потом будет пользоваться!! ... |
|||
:
Нравится:
Не нравится:
|
|||
16.09.2010, 11:38 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
В продолжение темы. Отодвинем в сторону технические и психологические проблемы разработки и использования мультимедийной документации и рассмотрим чисто финансовые вопросы. Чтобы создать ролик, сначала надо все-таки НАПИСАТЬ текст (сценарий этого ролика) и этот текст проверить (протестировать). Большинство свою работу по документированию на этом завершают. Чтобы создать ролик (экранизировать текстовый документ- сценарий) надо понести дополнительные трудовые (соответственно, финансовые) затраты: 1 должен быть специалист по созданию роликов, т. е. уметь работать с соответствующим ПО; 2 в отличие от текстовой документации, где иногда можно дать чисто словесное описание (типа: в данном окне будет показан список товаров в заданном ценовом диапазоне), в ролике надо ПОКАЗАТЬ это окно ( использовать закадровый голос нет смысла), т. е. для ролика надо готовить правдоподобную БД (демонстрационную БД) со всей необходимой для визуализации информацией. Разработка, ввод и тестирование такой БД (или материалов для визуализации) – тоже требует дополнительных затрат. Итак: Пусть у нас есть некий продукт (скажем, 1С), стоимость которого 0.9 уе. Стоимость текстовой документации для него – 0.1 уе. Стоимость медиа документации для него – 0.3 уе Пусть в продаже есть 3 коробки: 1C-Т: с текстовой документацией 0.9+0.1=1.0 уе. 1C-М: с медиа документацией 0.9+0.3=1.2 уе. 1C-Т/М: с комбинированной 0.9+0.1+ 0.3=1.3 уе. Какую коробку купит пользователь? Если вы ответите на этот маркетинговый вопрос, то получите ответ и на свой вопрос: почему документация ПИШЕТСЯ, а не ЭКРАНИЗИРУЕТСЯ? Дело в цене, в качестве (или в отсутствии предложения) ? PS К сведению: экранизация многих произведений с треском провалилась. ... |
|||
:
Нравится:
Не нравится:
|
|||
16.09.2010, 18:09 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Вот сейчас закрыл глаза и представил видео ролик с SQL*Reference... Тоже ведь пользовательская документация. А если серьезно, то очень слабо представляю себе полноценную документация в виде видео-ролика. Вот ознакомительный или учебный фильм - легко себе представляю. А в документации главное - обеспечить поиск и фильм тут вряд ли поможет. ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 09:23 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Bogdanov Andreyв документации главное - обеспечить поиск и фильм тут вряд ли поможет. в той, о которой идет речь, поиск далеко не главное ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 10:47 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafmв той, о которой идет речь, поиск далеко не главноеА о которой "идет речь"? У топикстартера сказано "пользовательская документация, например для различных АРМ". Что в этой документации главное? ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 11:03 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Bogdanov Andreyiscrafmв той, о которой идет речь, поиск далеко не главноеА о которой "идет речь"? У топикстартера сказано "пользовательская документация, например для различных АРМ". Что в этой документации главное? лаконичность, наглядность. Ее главное назначение - представить в удобном для понимания какую-то часть БД. Да и на чтение у людей, которые пользуются этими "АРМ", обычно нет времени. Видеоурок + краткая памятка - это все, что возможно "переварить" ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 11:35 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafmВидеоурокНу так я и написал про учебные или ознакомительные фильмы. Но наличие этого никак не заменяет потребность в документации. ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 12:02 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafm[Да и на чтение у людей, которые пользуются этими "АРМ", обычно нет времени. В таком случае вам надо разрабатывть "интуитивно понятный интерфейс", в котором на каждой экранной форме пользователю доступна одна, максимум две возможные и правильные в текущем контексте операции-действия (подсказки, кнопки, пункты меню и т. п.). ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 15:48 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafmлаконичность, наглядность. Видеоматериалы удобны в том случае, когда пользователь мало знаком со специальной терминологией системы. В этом случае вместо многословного и малопонятного текста действительно проще продемонстрировать на экране, как это делается (армейское правило: "Делай, как я"). Например, вместо описания, как отремонтировать водопроводный кран (отвинтите шайбу, снимите маховик, открутите еще что-то, завинтите крон-гайку и т. п. непонятные термины) проще показать, как это делается в натуре. По этому пути идут всевозможные самоучители, типа - как самому настелить линолеум; - как получить максимум удовольствия в сексе; - как самому обрезать садовые кусты и т. п. где вместо текстового описания приведены рисунки, иллюстрирующие последовательность выполняемых операций (типа комиксы). ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 16:03 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
ЮВiscrafm[Да и на чтение у людей, которые пользуются этими "АРМ", обычно нет времени. В таком случае вам надо разрабатывть "интуитивно понятный интерфейс", в котором на каждой экранной форме пользователю доступна одна, максимум две возможные и правильные в текущем контексте операции-действия (подсказки, кнопки, пункты меню и т. п.). это безусловно. ... |
|||
:
Нравится:
Не нравится:
|
|||
20.09.2010, 16:29 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
Документация разная бывает. Для видеоролика хорошо подходит руководство, в котором по шагам можно проследить использование программы - запустили, ввели, нажали, увидели и т.п.. Т.е. некий алгоритм или процедуру. Примеры такой документации я видел. А если, положим, нам нужно расписать структуру БД, или допустимые значения параметра и их эффект, то наверное лучше это сделать в виде текста или диаграмм. Так и искать будет проще. Впрочем видеокурс тоже может быть полезным, ведь есть люди которые на слух и вид лучше иформацию воспринимают. Примеры такой документации я тоже видел. Ещё можно добавить, что в ряде случаев требуется описывать диаграммы словами. Ведь есть ещё и незрячие, которые впринципе диаграмму не могут видеть, но могут её представить по словестному описанию. Или в браузере отключен показ картинок. ... |
|||
:
Нравится:
Не нравится:
|
|||
22.09.2010, 20:36 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
ЮВ В таком случае вам надо разрабатывть "интуитивно понятный интерфейс", :) Только не забудьте прописать в ТЗ о том, что "пользователь должен обладать понятливостью и интуицией" :) ... |
|||
:
Нравится:
Не нравится:
|
|||
15.10.2010, 00:23 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
sudo :) Только не забудьте прописать в ТЗ о том, что "пользователь должен обладать понятливостью и интуицией" :) Вы будете смеяться, но в грамотно написанном ТЗ всегда оговариваются минимальные требования к квалификации (уровню подготовки) будущих пользователей ПО и разработчики ПО должны учитывать это требование. Наивно полагать, что вы выйдете на улицу, поймаете первого встречного, посадите его за компьютер, и он сразу начнет работать с вашей программой. ... |
|||
:
Нравится:
Не нравится:
|
|||
15.10.2010, 12:17 |
|
Почему пользовательская документация до сих пор ПИШЕТСЯ?
|
|||
---|---|---|---|
#18+
iscrafm Да и на чтение у людей, которые пользуются этими "АРМ", обычно нет времени. Видеоурок + краткая памятка - это все, что возможно "переварить" Во первых, текст гораздо компактнее чем видео - часовой урок уместится на десятке страниц текста, который читается минут пять. Во вторых, никто никогда не усвоит все с одного раза, так что возможность прочитать кусочек, попробовать как это выглядит на реальном приложении - с видео гораздо труднее. Ну и поиск - пользователь хочет уточнить, как выполнить определенную задачу, как ему показать именно нужный фрагмент ? P.S. Делают такие штуки, я например их никогда не смотрю - времени жалко. ... |
|||
:
Нравится:
Не нравится:
|
|||
20.10.2010, 22:57 |
|
|
start [/forum/topic.php?fid=33&fpage=30&tid=1548194]: |
0ms |
get settings: |
7ms |
get forum list: |
12ms |
check forum access: |
4ms |
check topic access: |
4ms |
track hit: |
41ms |
get topic data: |
11ms |
get forum data: |
2ms |
get page messages: |
56ms |
get tp. blocked users: |
1ms |
others: | 314ms |
total: | 452ms |
0 / 0 |