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

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

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

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

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

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

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

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

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

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

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

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

Но если программа делается на продажу, как программный продукт, то без документации ей грош цена. Разве что, какая-нибудь элементарная игрушка может разойтись без подробного руководства программиста, описания методики внедрения, настройки, эксплуатации, а только снабженная контекстными подсказками.
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
08.10.2005, 22:26
    #33313258
PL99
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
Dogen
Участник
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
!!!мотивация написания документации для программы
vlas
1 Прозрачность структуры программы
2 Описание множества функций в общей связке
3 Создание общего вида программы
4 Увеличение конкурентоспособности программы


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

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

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

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

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

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

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

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

:))

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

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


Лучшее и самое точное описание программы - это ее текст. Все остальное - неполно и искаженно.
...
Рейтинг: 0 / 0
| Ответить | Цитировать | Написать  
  1  все
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / !!!мотивация написания документации для программы / 25 сообщений из 50, страница 1 из 2
Целевая тема:
Создать новую тему:
Автор:
Найденые пользователи ...
Разблокировать пользователей ...
Читали тему (0):
Читали форум (0):
Пользователи онлайн (0):
Польз. соглашение
созд. / загр.: 284ms
Закрыть
start [/forum/topic.php?fid=33&mobile=1&tid=1549522]:
 0ms
get settings:
 8ms
get forum list:
 14ms
check forum access:
 4ms
check topic access:
 4ms
track hit:
 155ms
get topic data:
 11ms
get forum data:
 2ms
get page messages:
 73ms
get tp. blocked users:
 2ms
others: 11ms
total:  284ms
x
x
Закрыть


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