ReSQL.ru
     
powered by simpleCommunicator - 2.0.49     © 2025 Programmizd 02
Мобильная версия    Контакт    Правила    FAQ    Помощь
Доб. в избранное | Игнор. тему | Прикреп. тему | Пометить прочит. / непрочит. | Фильтр
Форумы / Разработка информационных систем [игнор отключен] [закрыт для гостей] / !!!мотивация написания документации для программы
25 сообщений из 50, страница 1 из 2
  1  все
!!!мотивация написания документации для программы
    #33294524
vlas
Скрыть профиль Поместить в игнор-лист Сообщения автора в теме
vlas
Гость
А какова мотивация для программера ,создающего прогу на продажу
и для работодателя,которому нужна эта прога?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

:))

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

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


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


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