В чём сейчас модно делать справку в программах?
- chm
- pdf
- держать всё на сайте
- держать всё локально в файлах
- устроить локальный веб-сервер
- в последних трёх пунктах открывать это системным браузером или запудзырить компонент на форму...

Или что-то ещё?

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

Мы вот так :)
http://help.grandsmeta.ru/

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

> на мой взгляд, пдф наиболее удобен


пдф удобен, что его можно просто создать, распечатав. А вот, чтобы настроить типа контекстную справку (по ключевым словам), тут мен помнится я на 15 страниц такой справки возился очень долго...

> Dimka Maslov ©   (14.04.16 22:00) [3]
>

мож есть тулза какая-нить? наверняка должна быть. в противном случае, да, запарненько будет...

http://www.osp.ru/pcworld/2003/06/165867/ - что-то типа такого.

> Dimka Maslov ©   (14.04.16 20:43) 

если речь именно о руководстве пользователя, то только и исключительно веб-версия на сайте, причем, не сгенерированная какой-то утилитой, а полноценно сверстанная. Желательно с видео примерами и т.д. для примера: https://www.remoteutilities.com/support/documentation/

Во-первых, это удобно. Во-вторых, значительно улучшит ранжирование сайта в поисковых системах. В-третьих, пользователи легко через поисковик найдут интересующий их материал.


> chm

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


> pdf

это только и исключительно для спецификация и прочей legal-информации, т.е. для того, что потенциально может уйти в печать. ни в коем случае не слушай pdf-филов.  


> держать всё локально в файлах
> - устроить локальный веб-сервер
> - в последних трёх пунктах открывать это системным браузером
> или запудзырить компонент на форму...

каменный век.

-----
жаль мне никто это не объяснил лет 10 назад.

> > pdf
>
> это только и исключительно для спецификация и прочей legal-
> информации, т.е. для того, что потенциально может уйти в
> печать. ни в коем случае не слушай pdf-филов.  
>

многие не согласятся. У меня куча инструкций именно в пдф. Причем тут фильность? че не приобрету - к нему инструкция в пдф.


> если речь именно о руководстве пользователя, то только и
> исключительно веб-версия на сайте

ага. это удобно. но исключительно при наличии интернета.

> [7] KilkennyCat ©   (15.04.16 02:53)
> че не приобрету - к нему инструкция в пдф

Так вопрос о контекстной справке.

> KilkennyCat ©   (15.04.16 02:53) [7]


> че не приобрету - к нему инструкция в пдф.

жертвы собственных заблуждений, по большей части. я тоже был среди них по этому вопросу.

я предпочитаю, по таким темам, учится у победителей (MS, Apple, Orcale, Adobe и т.д.) и на собственном опыте.
даже для Делфи, последние несколько лет, использую онлайн документацию. причем статьи ищу через гугл. это удобнее, чем их встроенный chm.

> Причем тут фильность?

это она самая.

> но исключительно при наличии интернета.

интернет, в наше время, огромная редкость.

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

> интернет, в наше время, огромная редкость.

в андроид-планшете встроенную навигацию по яндекс-картам не ты разрабатывал? :) она без интернета не работает.

А вот я летом в деревне сижу, там хорошо работается. Интернета нет. Как мне пользоваться твоей справкой? И даже там, где он есть, он не всегда есть. Вообще, просто посчитать надежность отказа системы "сервер_со_справкой-доступ_к_интернету-клиент" и системы "просто_одинокий_комп_на_котором_есть_все_нужное"?


> Inovet ©   (15.04.16 03:13) [8]

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

Приплыли, а я то тут при чем? ;)

> мож есть тулза какая-нить?


Acrobat называется.


> Во-первых, это удобно.


Согласен, однако это внутренний продукт и справка нужна для того, чтобы ко мне каждые пять минут не бегали с вопросами. К тому же у нас есть компы, которые по принципиальным соображениям от интернета отрублены. Тут придётся поднимать внутри сети сервер справки и пилить для него ещё и поисковую систему.


> У меня куча инструкций именно в пдф


У меня тоже. Но всё-таки люди не хотят рыться в документации, а хотят в нужный момент просто нажать F1

> Rouse_ ©   (14.04.16 20:48) [1]
> Мы вот так :)
> http://help.grandsmeta.ru/

На какой cms сделано?

> интернет, в наше время, огромная редкость

Ты не представляешь чрез какую опу приходится пользоваться этими онлайнсправками.
из локальной сети интернета нет.
Есть в "терминальном" доступе.

Еще больше попали те, у кого за интернетом надо на отдельный комп идти...
Так что онлайнсправка это ..... смотря для чего :)

> KSergey ©   (15.04.16 09:31) [13]

bitrix

Eraser ©   (15.04.16 02:26) [6]
> Во-первых, это удобно.
кому? разработчику или пользователю? можешь не отвечать, я знаю ответ, что бы ты не сказал типа "у нас не так".

с давних пор таскаю с собой JETSQL40.CHM, VBLR6.CHM, ... справку из старых офиса, mssql т.к. нынешняя "онлайн" стала жутко неудобная, хрен что найдешь даже зная, что нужно, кидает на какие то левые разделы из "net-а" и т.д. а то бывало попадал на разделы "under construction" хотя в старой все есть.

> нынешняя "онлайн" стала жутко неудобная


Так ведь это не проблема "онлайн"-"оффлайн", а проблема качества самой документации.

> повторюсь, pdf - он для печати на принтере, не для чего
> более.


Ну спасибо! А я, дурак, их читаю. Теперь буду только печатать :)

> Так ведь это не проблема "онлайн"-"оффлайн", а проблема качества самой документации.
как бы сказать... вроде да, но нет. не ссылаясь на мелкософт вижу у себя в конторе где есть и чисто клиентские и серверные продукты. клиентские готовят, проверяют, продумывают, пытаются предугадать заранее, что нужнее/удобнее будет. т.к. обновления клиента агентами делается редко, и трудно, исправления донести часто не получается без "насилия", не любят они этого, т.е. поставили раз, и все должно соответствовать.
а вот серверное... возможность в любой момент доделать, изменить, фактически провоцирует делать "спустя рукава", расслабляет такое "удобство", "серверники" ленятся думать, проверять сделанное.

ИМХО. сам подход, обязывает. (если конечно без "железной" руки, в одинаковых условиях) то что вижу это подтверждает. как это "должно быть правильно" мне пофигу.

p.s.
> http://help.grandsmeta.ru/
404 для /images/cont/input-checkbox.gif /images/cont/input-radio.gif