Ненавижу писать хелп на свои проги,... :-(((

← →
Игорь Шевченко © (2004-08-20 13:17) [40]

Aleksey Pavlov © (20.08.04 12:52) [31]

> Но игрры - это одно, у них у всех интерфейс однотипный и
> содержит в себе не так много параметров

LOL

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

Открой в MS Word окно "Сервис|Параметры". Посчитай.

Что я скажу о конфигураторе - или выкинуть или сгруппировать параметры в обозримое количество групп. Если не группируются - выкинуть.

> При этом некоторые из этих параметров по определению не
> могут быть интуйтивно понятны.

Выкинуть и не морочить пользователю голову.

← →
WondeRu © (2004-08-20 13:24) [41]

>Если написал программу для людей, так объяснить им как ей пользоваться вроде не трудно.

а если их несколько сотен перевалило! Если сам будешь объяснять, то превратишься из разработчика в службу поддержки!

>Все серьезные программы имеют описания. И чем серьезнее программа, тем оно толще.

у нас ужо за тыщу страниц А4 перевалило

← →
Vovchik_A © (2004-08-20 13:26) [42]

2WondeRu © (20.08.04 13:24) [41]
Тогда, брат, извини... Логику менять надо.

← →
ShaggyDoc (2004-08-20 13:27) [43]

Наличие справки, документации, инсталлятора - главное отличие программного продукта от программы.

Наши гениальные программисты, занимающиеся написанием прог, считают написание help необязательным - как же не понять их гениальные творения? Лучше в форуме потрепаться. Да и зарплата, хоть небольшая, обычно и так капает.

Тупые буржуи, живущие в "мире чистогана и желтого дьявола", стремятся выпускать и продавать программные продукты. Чтобы зарабатывать. Help писать никто не любит, но они, по буржуинской традиции, стремятся превратить дерьмо в конфетку и продать. Наши упаковывают свои "бриллианты" в мешковину и потом жалуются на жизнь.

Другие же тупые буржуйские чайники читают Help. Наши не читают потому, что он или английский, или "наш". То есть никакой. Серьезный русскоязычный Help к серьезным программам пользователями перечитывается многократно и внимательно. А программисты действительно, не читают. Зачем, когда он сам все знает по любому предмету, с которым никогда дел не имел?

← →
Kerk © (2004-08-20 13:30) [44]

Игорь Шевченко © (20.08.04 12:38) [26]

> Sandman25 © (20.08.04 12:36) [24]
> > Обычно такими "программами" занимаются AVP и DrWeb
> Открой список процессов на своей машине, будешь приятно
> удивлен обилием программ "совсем без кнопочек". И "AVP и
> DrWeb" почему-то ими не занимаются. Странно, правда ?

Чем вирус для винды отличается от вируса для линукс?
Вирус для винды запускается и распростространяется сам, а вирус для линукса поставляется в виде исходников с мануалом и howto :)

← →
DiamondShark © (2004-08-20 13:41) [45]

> Леша, вот ответь на такой вопрос - почему к игрушкам help"ов
> чаще всего не пишут ?

Таки пишут.
Огромные печатные книги.

Разумеется, не для "тетриса".

← →
Думкин © (2004-08-20 13:41) [46]

> [43] ShaggyDoc (20.08.04 13:27)

То что вы описали - должны делать не программисты. У нас это делали и делают совсем другие люди. Хорошее руководство пользователя должно писаться отнюдь не программистами. И оно читается, причем в основном на бумажных носителях и тупыми нашими прогерами тоже.
Но глубокая вчитка в интерфейсные хелпы - встречается редко. В основном информация черпается из книг или опыта.
В одной конторе писали программы - к каждой хелп, основательный. Но я дико сомневаюсь, что он хоть кому-нибудь понадобился.
Кто-нибудь читал хелп по WinAmp, ACDsee, Total Commander. Конечно это не уровень программ с 1000 страничными хелпами. Но все-таки яйца от желтков надо отделять.

← →
КаПиБаРа © (2004-08-20 13:44) [47]

> Кто-нибудь читал хелп по WinAmp, ACDsee, Total Commander

Я читал help к Total Commander :)

← →
Игорь Шевченко © (2004-08-20 13:45) [48]

DiamondShark © (20.08.04 13:41) [45]

> Таки пишут.
> Огромные печатные книги.

таки это наверное, не help"ом называется :)

← →
Думкин © (2004-08-20 13:47) [49]

> [46] Думкин © (20.08.04 13:41)

Это не означает что хелпы писать не надо. Документация быть должна. Но и готовить ее должны по хорошему другие люди.

← →
Григорьев Антон © (2004-08-20 13:48) [50]

> Игорь Шевченко © (20.08.04 12:48) [30]
>
> > Софта с нормальным хелпом, imho, очень мало
>
>
> Весь софт от MS
>
> Delphi :)))

Это в Delphi-то нормальный хелп?!!!

Интерфейс, конечно, неплохо описан, но язык и VCL... Раньше я думал, что хелп в Delphi написан хорошо. Но потом почитал MSDN...

А вообще, есть две вещи, которые, в принципе, могут подразумеваться под хелпом: описание предметной области и описание интерфейса. ИМХО, интерфейс должен быть таким, чтобы тот, кто знает предметную область, мог работать с ним без описаний. Соответственно, и справка по интерфейсу при этом не нужна. А вот саму предметную область надо бы описать. Например, если программа для работы с железкой, то неплохо бы описать, какие параметры железки для чего нужны.

← →
DiamondShark © (2004-08-20 13:48) [51]

> таки это наверное, не help"ом называется :)

А, ну да. Юзер мануалом.

← →
DiamondShark © (2004-08-20 13:51) [52]

> Интерфейс, конечно, неплохо описан, но язык и VCL... Раньше
> я думал, что хелп в Delphi написан хорошо. Но потом почитал
> MSDN...

А при чём тут МСДН?

← →
Суслик © (2004-08-20 13:54) [53]

а мне вот нравится описание object pascal reference в дельфовом хелпе

← →
Игорь Шевченко © (2004-08-20 13:56) [54]

Григорьев Антон © (20.08.04 13:48) [50]

> Это в Delphi-то нормальный хелп?!!!

Ага.

> Раньше я думал, что хелп в Delphi написан хорошо. Но потом
> почитал MSDN...

MSDN тоже неплох, но я не вижу такой уж видимой разницы.

Григорьев Антон © (20.08.04 13:48) [50]
Например, если программа для работы с железкой, то неплохо бы описать, какие параметры железки для чего нужны.

это знать не к чему! инсталляторы меня съедят, если я им еще кучу инфы ненужной подкину!

> Например, если программа для работы с железкой

а если это шифратор?

2 ShaggyDoc
Хорошо сказано.

Всякий раз, когдла я сажусь писать Help, я обнаруживаю кучу мелких недоработок, а порой и ошибок в самой программе. Так что, хоть это и трудно поначалу, но, написав Help (а еще лучше - Документацию), я испытываю чувство "законченности" программы. ИМХО, умение написать внятное описание - признак высокого профессионализма разработчика. К сожалению, еще начиная с института, советская традиция обучения состоит в том, чтобы студент привык формально относиться к письменным трудам вроде "курсовая", "диплом", о лабораторных я не говорю... Это очень плохо. Неумение оформлять свои мысли сродни эдакому трудогольному эгоизму типа "я работу сделал, а уже сделать мою работу достоянием человечества - чья угодно забота, только не моя". Я считаю, что это перекос очень фундаментальный и имеет множество исторических корней наплевательского отношения к людям вообще и особенное восприятие "своей исторической роли", не совпадающее с общепринятым в мире. Дело в том, что есть большая разница между производством благ и производством вещей. Если вещью невозможно пользоваться или создателю вещи на это просто плевать, то вещь он произвел, но блага не произвел. Никакая новая ценность в мире не возникла. Но если производитель имеет психологию пролетария и считает, что источником всякой ценности является труд, то он не заметит разницы. Какая разница, кто-то пользуется вещью или нет? Важно, что Я СОЗДАЛ САМУ ВЕЩЬ. И пусть мне за нее ЗАПЛАТЯТ.
Существует экономическая точка зрения и она состоит в том, что целью общества должно быть не увеличение количества вещей, а увеличение их совокупной стоимости. А эта совокупная стоимость зависит от того, насколько вещи полезны и насколько ценны для тех, кто из может употребить. Я уже не раз здесь спорил на тему, что простой обмен может увеличивать совокупную ценность вещей и это одно из основных свойств рынка. Но почему-то эта точка зрения воспринимается в штыки и многие продолжают, как и Карл Маркс, считать, что даже валяющаяся на складе никому не нужная вещь, продолжает обладать какой-то "ценностью" или "стоимостью". Не продолжает. Если не превратить вещь в продукт (ту же программу) - считайте, что вы выбросили весь свой труд в мусорное ведро. А если кто-то еще и гордится этим - значит его попросту такой подход устраивает. Это лучший способ избежать всякой ответственности.
Разумеется, я не настаиваю на том, что документацию обязательно должен писать сам разработчик. Но разработчика, тем не менее, должно волновать, пишется документация или нет. Если же ему этот вопрос по барабану, если он воспринимает это как "чистой воды напряг", значит ему все равно, на что он тратит свою жизнь и энергию, лишь бы бабки платили. Это то же самое, как садовник, который любит сажать деревья, но считает, что поливать их - вообще не его дело - пусть кто хочет, тот и поливает.

← →
ShaggyDoc (2004-08-20 14:02) [58]

> Думкин © (20.08.04 13:41) [46]

> То что вы описали - должны делать не программисты. У нас это делали и делают совсем другие люди. Хорошее руководство пользователя должно писаться отнюдь не программистами.

Разумеется, это так. В нормальных фирмах так и делается. Они есть (примеры и в этой ветке), но у нас их меньше, чем "обычных" программистов. Которые должны делать все (если уж работаешь не у Билла), а не скулить "я не люблю манную кашу". Или менять работу, фирму (можно на Microsoft).

> [58] ShaggyDoc (20.08.04 14:02)

Разумеется. Вот к той, что делаю сейчас и описание делаю сам.
А скулить вообще никогда не надо - не нравится - меняй или меняйся. :)

Думкин © (20.08.04 14:06) [59]
А скулить вообще никогда не надо

ладно не буду :-))) по ходу написания хелпа пришлось даже править названия некоторых контролов! ;-) и хинты везде, где только бабахать!)))

Ненавижу писать хелп на свои проги,... :-((( Найти похожие ветки