Ситуация.
Приглашают фри на некий проект по расширению функционала навороченной самописки.
Чел начинает работать по нему и тут ему говорят:
"Прежние прогеры не написали техдокументацию и руководства пользователей. Займись этим, это первоочередная задача".
Ваши действия?

Судя по названию ветки, не стоит тебе писать документацию.

Садись и пиши. Заодно сам въедешь

(1) Почему, книга с подобным названием - достаточно неплоха и даже в школах изучается... :-)

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

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

(1)писать, если зарплата устраивает.

если юзеры есть адекватные которые в курсе ради чего все затевалось

любая работа хорошая - платят же

50 на 50 - или делать или нет

встроенной справки недостаточно ?

(0) хвастаешься?

(0) зависит от того, кто будет принимать работу.

может так статься,что тока зря время потратишь

Если адекватная оплата и время, то почему нет то? Или не барское это дело? :)

Приглашают фри на некий проект, а он такой приходит и начинает ломаться, как девочка - это не буду, так не хочу

(0) Любой каприз - за деньги клиента. Если не согласны - автоматически получаются пункты 2 и 3.

нассать им в кактус и  закатить истирику с швырянием мониторов об стену и показыванем фактов офисному персоналу уже советовали ?

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

(17) писать доку и кодить немного разные вещи

(0) Вообще-то объем и суть работ принято обсуждать заранее.

(19) Мож он не на объем работ продался, а тупо на почасовку.

(0) Татары? Они любят рубь за два.

(18)
"Прежние прогеры не написали техдокументацию и руководства пользователей. Займись этим, это первоочередная задача"
взяли явно как прогера, а просят еще писульками заняться, вот автор и советуется.

(0) Если оплата устраивает, то вписаться. Да и кто будет проверять твою писанину? Конечно, может быть, скучно. Но и писать код часто не так весело

(15)+1
конечно если лениво - для фри это вполне себе аргумент

(20) Тогда пусть возрадуется, что просят документацию писать, а не минеты строчить.

имхо - садись и пиши :)
это теперь твоя работа

(0) было что то подобное, потом ещё и зарплату поменьше предложили ) после чего и были посланы на юг.

(27) ну, что-ж.. это капитализьмус, дружочек.. тут и обмануть могут :)

+(3) Бедный Йорик...

(28) И на старуху бывает порнуха...

(0) деньги не пахнут

(31) Так написано, как будто какашку убрать заставили. Это одна из основных квалифицированных деятельностей разраотчика

Если оплата по факту - это какбэ намекает, что предыдущим не заплатили...или не всё заплатили. см. п.3
Если предоплата ЗА НАПИСАНИЕ МАНУАЛА - мы прославлять судьбу свою должны (С) см п.1

Вопрос франям:
У вас документацию кто пишет? Сами прогеры или техписатели?
Как отличается стоимость часа прогера и техписателя?

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

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

та любой каприз ...

это работа. хотя тяжеловато в чужом коде разбираться, всегда хочется сделать лучше.

За деньги-то - почему нет. Писанина всяко проще кодирования, заодно и разберешься что к чему.

А я бы послал.
Не царское дело. Пусть техписателей ищут. И квалифицированней получится и дешевле.
Если так стоит вопрос, то похоже какой-то несерьезный проект.

Бежать нечего, отмазываться тоже не за что. Просто "нет"

А вдруг все это дело переделывать топик стартеру нужно будет. Так хоть разберется что к чему.

(0) Адекватному заказчику- все плюшки.Тем более, тебе все равно нужно самому разобраться.Естественно, не как нагрузка.
Так что за тебя мы решить не сможем.

Я бы дописывал функционал и постепенно писал документацию.

(44)+ Если заказчик схавал от предшественника проект без документации, то от тебя схавает вариант постепенного написания этой самой документации.

(34) отвечаю - когда как

что есть техдокументация в (0)? Руководство администратора? Руководство технической поддержки? Техпроект на разработку для разработчика?

номенклатура документов весьма обширна же

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

Многочисленные инструкции в зависимости от объемов и клиентов - разрабы или техписатели. Смысла привлекать техписателя на 5 страниц нет. Вот на сотню-другую, со схемами и прочим - можно отдать попытаться.

Ставки разные конечно

аналитики еще тоже пишут документаций всяких много...

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

гыгы... когда сие в 1С для типовых будет интересно...

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

Есть некий проект.
Давно уже пережёванно - какой доля трудозатрат уйдёт на тот или иной этап.
Какова доля написание документации в проекте в целом?
5%? 10?

(50) Нуну. 30-40%

(51) Дануна.

(34) Разработчики-методисты по идее пишут. Кто кроме них кто может нормально написать?

(52) Раз на раз не приходится. По небольшим проектам может быть и 70/30 %, по большим - 20/80 %
Когда пишешь уже точно знаешь структуру базы, алгоритмы, иначе оценить невозможно.

Отдать нормальному исполнителю :)

(52) Это еще зависит от того, с какой детализацией писать.
Если писать в стиле
"Документ "Установка параметров амортизации"" предназначен для установки параметров амортизации"
, то можно и быстренько написать.

(0)
> "Прежние прогеры не написали техдокументацию и руководства
> пользователей. Займись этим, это первоочередная задача"
Требуется документацию изготовить или учинить разборки с теми прогерами?

(56) большинство так и пишут) Читал как то описание к нетленке  в довольно специфической област. Описание на 6 страницах из которых одна текста все остальное скриншоты в духе документ списание материалов предназначен для списания материалов )

(58) ты бы удивился если бы было "Документ Списание материалов предназначе для оприходования материалов?" , скажи спасибо название хоть чуть-чуть соответствует ожидаемому поведению.

Реально написание документации занимает примерно 30% времени от времени разработки продукта . Предыдущие проги неплохо сэкономили

И так люди с опытом говорят, что 20 - 30%.
Если нетленку пару лет ваяли, значит мне понадобится 9 месяцев.
Если подсчитать стоимость работы и выложить заказчику - его кондрашка хватит.

(61) Если ты этого не делал, значит руководство сэкономило (до поры до времени)
Или ты плохой или не было времени (если гонят делать что-то следующее некогда описывать что-то предыдущее)

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

(0) Нафиг ты же фри... скажи - сами пишите, я свободный художник, документация не мое, я вам тут не нанимался.

(0) Нужны деньги? писать умеешь? Пиши.
Не любишь писанину, не жалко потерять клиента? Откажись.
Но писать документацию всегда полезно кодеру. Важно оценить и узнать цену.

вот

(0) Беги оттуда нахир, мой тебе совет.

(0) Не поверишь почему.

(0) Советами зоебут.

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

Код, это единственная докумекнтация. Спросите тех, кто раздрочил РАУЗ.  Кто сит ещё чего-то, бейте в е***ло.

(50)(52)
+1 к (60)

всё так и есть - около 30%

Пример из жизни:

Документация для сотрудника техподдержки/грамотного пользователя с описанием основных учетов(самых крупных бизнес-процессов) подсистемы. Каждый учет расписывается от регистров. Указывается, по какому принципу тот или иной док пишет движения в регистры.

Расписываются алгоритмы отчетов.

На подсистему уровня 600 часов около 200 часов потребовалось на доку. Объем 150-200 листов (точно не помню), со скринами и блоксхемами.

Задействовался техписатель. На его 8 часов около 1.5-2 часов в день приходилось от аналитика. Аналитик продумывал структуру дока, содержание, блок-схемы. Рассказывал и показывал программу.

(61) ну, в (70) от нас попросили, когда решили саппортить начинать своими силами, а не силами франча, разработавшего нетленку.

По идее, если контора хочет не зависеть от вендора, особенно, если решение нетиповое - без документации такого как в (70) уровня будет сложновато - потребуются разрабы очень приличного уровня, чтоб не наколбасить в базе, пока толком не разберёшься.

(71) +100500. Да и самим пользователям необходимо понимать какие операции и как делать. Вообще чем дольше работаю на фикси тем больше понимаю что на каждую операцию у пользователя должна быть инструкция и он должен быть под роспись ознакомлен, а иначе залюбят до смерти

Примерно также сказали и мне. Изучила самописку, написала инструкцию. В чем  проблемы?
и такое бывает часто, не вижу ничего плохого

(10) Встроенной справке на самописке?;) Никогда такое не видела) Разве что в 1С совместимых

Автор вбросил и испарился

(75) Так документацию пишет