Гость
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / !!!мотивация написания документации для программы / 25 сообщений из 50, страница 1 из 2
28.09.2005, 22:45
    #33294524
vlas
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
А какова мотивация для программера ,создающего прогу на продажу
и для работодателя,которому нужна эта прога?

И хотелось узнать чем эти мотивации друг от друга отличаются)))

Мне кажется для программера создание документации нуно для:

1 Прозрачность структуры программы
2 Описание множества функций в общей связке
3 Создание общего вида программы
4 Увеличение конкурентоспособности программы
....
Может я в чем нибудь ошибаюсь....
интересно было бы узнать как к этому
относятся работодатели))
А еще хотелось бы услышать все мнения по этому вопросу
...
Рейтинг: 0 / 0
28.09.2005, 23:29
    #33294549
Сахават Юсифов
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Никакая мотивация не поможет.
Первым делом делаешь быстрый прототип. Тут не документации.
Вторым делом создаешь самы трудные (интересные) методы.
Так как все уже почти готово, то быстро делаешь остальную ****у.
Тут выскакивают пара ошибок, которые отнимают пару недель пока переделываешь всю логику.
Потом не нравиться интерфейс. Кое-как доводишь. Ты уже остыл, все обрыдло,
глаза бы не глядели, а тут новая идея, как быстро заработать деньги на суперпроекте. И так по циклу. Какая на х*** документация?
...
Рейтинг: 0 / 0
28.09.2005, 23:46
    #33294556
vlas
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Теория теорией,а практика практикой!!!!!!!
очень даже интересно

И получается,что работодателю прежде всего нужна функциональность,
а потом уже документация..... вернее ... когда все работет - уже не до нее...
это наверно неправильный подход в в тории ,но эффективный для программера
на практике.......
А у кого нить встречались такие конторы ,заказывающие себе написать
базу, при этом требующие докумантацию... и все такое,
а не только исходники?
...
Рейтинг: 0 / 0
29.09.2005, 09:26
    #33294783
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторА у кого нить встречались такие конторы
встречались.

Документация разработчика имеет очень большой смысл для команды больше чем из 2 человек. Это экономит время. Адептов XP прошу не беспокоиться.

Есть много книг на тему организации процесса разработки, где тема документирования занимает не последнее место.
Из наиболее свежих рекомендую Стива Макконнелла и его "Совершенный код". Если вы ранее не интресовались подобными вопросами, то эта книга будет вам весьма интресна.

Да, для двух и менее разработчиков документирование тоже имеет смысл. Кто не осознал, тот не писал.
...
Рейтинг: 0 / 0
29.09.2005, 11:16
    #33295098
Laox
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
vlasА какова мотивация для программера ,создающего прогу на продажу
и для работодателя,которому нужна эта прога?

И хотелось узнать чем эти мотивации друг от друга отличаются

А ты как - по делу спрашиваешь или просто интересуешься?

А вообще дурацкий вопрос насчет мотивации. Ну замени слово "прога" на какой-нить девайс типа станка. И теперь спроси - есть ли какая нить мотивация у того, кто этот станок производит и у того, кто этот станок юзает?
...
Рейтинг: 0 / 0
29.09.2005, 12:47
    #33295544
Programmer_Ortodox
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
И вообще, больше документации - чище задница
...
Рейтинг: 0 / 0
29.09.2005, 15:12
    #33296135
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторИ вообще, больше документации - чище задница
Совершенно верно.
Документация должна быть такой толщины, чтобы задница была надежно прикрыта со всех сторон :))
...
Рейтинг: 0 / 0
04.10.2005, 09:39
    #33302809
Так_забежал_просто
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Programmer_OrtodoxИ вообще, больше документации - чище задница Да, точно. В общем, на практике, вся информация, которая передаётся от заказчика к исполнителю, должна быть задокументирована. За исключением редких случаев особо доверительных отношений и особо малого размера проекта. Заставляет обе стороны гораздо ответственнее относиться к делу. И снимает многие претензии. И, кроме того, минимальные комментарии в коде всегда должны быть. Если разработчиков больше одного человека, каждый кусок кода должен комментироваться подробно.
...
Рейтинг: 0 / 0
04.10.2005, 09:53
    #33302856
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
замечу еще, что особо доверительные отношения иногда портятся, а особо малые проекты иногда разрастаются :)
...
Рейтинг: 0 / 0
06.10.2005, 14:44
    #33309197
evorobey
Гость
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Документация нужна, чтобы все заинтересованные лица имели одну и ту же постановку задачи и одну и ту же концепцию ее технического решения
...
Рейтинг: 0 / 0
08.10.2005, 19:40
    #33313184
PVP
PVP
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Если программа делается "для себя" и будет запускаться и использоваться под наблюдением разработчиков, то документация не нужна. Ее все равно читать ни кто не будет. При возникновении вопросов пользователи не полезут в книгу, а позовут программиста. То же относится и к программистам – они гораздо охотнее дергают друг друга по любой мелочи, чем ищут ответы в документах, даже если таковые имеются.

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

Но если программа делается на продажу, как программный продукт, то без документации ей грош цена. Разве что, какая-нибудь элементарная игрушка может разойтись без подробного руководства программиста, описания методики внедрения, настройки, эксплуатации, а только снабженная контекстными подсказками.
...
Рейтинг: 0 / 0
08.10.2005, 22:26
    #33313258
PL99
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
PVPЕсли программа делается "для себя" и будет запускаться и использоваться под наблюдением разработчиков, то документация не нужна. Ее все равно читать ни кто не будет. При возникновении вопросов пользователи не полезут в книгу, а позовут программиста.Если есть документация, то программист по телефону легко ответит на все вопросы одной фразой - "читайте руководство пользователя". Если же в IT отделе нет возможности написать доку, то программист, тем более, не ответит на вопросы пользователя, если только эти вопросы не касаются разработки, которая еще свежа в памяти (обычно от недели до полугода, про функционал, реализованный год назад подавляющее большинство знакомых мне программистов могут сказать только одно - "ты чего, я это делал год назад!")
...
Рейтинг: 0 / 0
10.10.2005, 09:20
    #33313991
a40
a40
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторЕсли программа делается "для себя" и будет запускаться и использоваться под наблюдением разработчиков, то документация не нужна.

Вы либо не писали программ для пользователей в количестве больше 10, либо Вам очень крупно повезло не побывать в ситуации, когда документация необходима. И для пользователей и для программистов.
...
Рейтинг: 0 / 0
10.10.2005, 14:14
    #33315061
PVP
PVP
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
a40 авторЕсли программа делается "для себя" и будет запускаться и использоваться под наблюдением разработчиков, то документация не нужна.

Вы либо не писали программ для пользователей в количестве больше 10...Интересно, как сосчитать количество написанных программ?
...
Рейтинг: 0 / 0
10.10.2005, 14:20
    #33315081
PVP
PVP
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
PVP a40 авторЕсли программа делается "для себя" и будет запускаться и использоваться под наблюдением разработчиков, то документация не нужна.

Вы либо не писали программ для пользователей в количестве больше 10...Интересно, как сосчитать количество написанных программ?А, дошло. Это пользователей больше 10. Писал.
...
Рейтинг: 0 / 0
08.11.2005, 11:49
    #33366027
Dogen
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
vlas
1 Прозрачность структуры программы
2 Описание множества функций в общей связке
3 Создание общего вида программы
4 Увеличение конкурентоспособности программы


Да это все программисту до лампочки, особенно 2 и 4. Равно как и 1 и 3 :))

Не вполне понятно, о какой документации речь. О пользовательской, для администратора или для программистов?.. Во всех трех случаях подход различается, ну и авторы разные пишут.
...
Рейтинг: 0 / 0
08.11.2005, 13:02
    #33366335
Slider_spb
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Единственная мотивация - это деньги. Если заказчик говорит, что без документации не будет денег за проект, ух какое желание доки писать появляется :)
...
Рейтинг: 0 / 0
08.11.2005, 13:26
    #33366437
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторДа это все программисту до лампочки, особенно 2 и 4. Равно как и 1 и 3 :))

Я бы уволил сразу. Особенно за 1.

:))
...
Рейтинг: 0 / 0
08.11.2005, 13:59
    #33366584
Сахават Юсифов
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Программиста уволить невозможно. Обычно ждут - когда ж он закончит? А он никогда не заканчивает! Ему становится неинтересно и он вас бросает, оставляя очередного уродца.
...
Рейтинг: 0 / 0
08.11.2005, 14:42
    #33366696
tobox
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторПрограммиста уволить невозможно.
Это там где порядка нет, где нервы и авралы.
В общем, очень во многих местах :))
...
Рейтинг: 0 / 0
08.11.2005, 14:45
    #33366715
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
авторПрограммиста уволить невозможно. Обычно ждут - когда ж он закончит? А он никогда не заканчивает! Ему становится неинтересно и он вас бросает, оставляя очередного уродца.

Извините, Сахват, мне почему-то подумалось, что Вы за себя говорите. У вас большой опыт, Вам виднее :))
...
Рейтинг: 0 / 0
08.11.2005, 15:38
    #33366910
Сахават Юсифов
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Calm авторПрограммиста уволить невозможно. Обычно ждут - когда ж он закончит? А он никогда не заканчивает! Ему становится неинтересно и он вас бросает, оставляя очередного уродца.

Извините, Сахват, мне почему-то подумалось, что Вы за себя говорите. У вас большой опыт, Вам виднее :))

Calm, поживите с мое и Вас вылечать.
...
Рейтинг: 0 / 0
08.11.2005, 18:14
    #33367441
Calm
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
да нет, Сахават, вы правы. К сожалению, я нередко вижу такое.
Но хотелось бы, чтобы люди стремились избегать таких ситуаций :)
...
Рейтинг: 0 / 0
09.11.2005, 11:55
    #33368505
Dogen
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
Calm авторДа это все программисту до лампочки, особенно 2 и 4. Равно как и 1 и 3 :))

Я бы уволил сразу. Особенно за 1.

:))

Само собой. На практике обычно сильно ощущается значение именно п.1. И коллегами и начальством :)
...
Рейтинг: 0 / 0
09.11.2005, 23:16
    #33370067
М.Голованов
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
vlasАМне кажется для программера создание документации нуно для:

1 Прозрачность структуры программы
2 Описание множества функций в общей связке
3 Создание общего вида программы
4 Увеличение конкурентоспособности программы
....
Может я в чем нибудь ошибаюсь....


Лучшее и самое точное описание программы - это ее текст. Все остальное - неполно и искаженно.
...
Рейтинг: 0 / 0
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / !!!мотивация написания документации для программы / 25 сообщений из 50, страница 1 из 2
Целевая тема:
Создать новую тему:
Автор:
Найденые пользователи ...
Разблокировать пользователей ...
Читали форум (0):
Пользователи онлайн (0):
x
x
Закрыть


Просмотр
0 / 0
Close
Debug Console [Select Text]