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

А что, экзамен по русскому языку при приеме в ВУЗы уже отменили? Курсовых и дипломных работ студенты не пишут? Нельзя написать качественный диплом, не умея писать.

По серьезным контрактам документацию серьезные техписы пишут, которые это 6 лет минимум изучали, не отвлекаясь на всякую чушь вроде кодирования. Разделение труда рулит.

В серьезной конторе кодеришку вообще близко к любой форме общения с заказчиком не подпускают.

в этом случае могу посочувствовать вам, умение изъясняться и знание руского языка не очень коррелирует меж собой

Ну почему же? Ты яркий тому пример. Языком не владеешь, изъясняешься в результате путано, и это все является причиной такой адской каши в твоей голове.

Чесслово, знаю немало замечательных программистов

Не, ну ты ж понимаешь, что твоя оценка из качества вообще куска какашки не стоит.

А не надо брать на работу выпускников животноводческих политехов. В приличных ВУЗах за несоответствие ГОСТам розгами секут.

А что, если, человек работает в международной компании, и там нет гостов.

Ололошечки. ISO всякие ничуть не менее формальны.

Обучают, вы просто не там учитесь.

программист должен уметь разработать полный комплект документации

Собственно, чем обосновано это мнение?

«Светлана», а почему вы мужик?

Технический писатель

Никто не понимает, что это такое. Скорее, это идиотический вариант заменить начальника «отдела нормоконтроля». Причем его подпись на документе, в суде не имеет юридической силы, см. ГОСТ.

Аледятел, есть такая должность в штатном расписании. Более того, у нужных людей такие буквочки вообще в дипломе написаны.

P.S. Полное впечатление, что автор пишет нам откуда-то из паралельной вселенной.

Собственно, чем обосновано это мнение?

Должностной инструкцией исполнителя. В ней есть пункт: «Разработка конструкторской, эксплуатационной и программной документации, по заданию руководителя проекта».

Представь себе, по ISO никто не заморачиваются. Документацию всю оформляют автоматизированно по типу Sphinx на Python и все довольны, никому госты и исошки не сдались, если только NASA, думаю, вы там не будете работать, аноним :-) Вот, что юзают для документации программисты:
http://www.stack.nl/~dimitri/doxygen/

Соответственно, исходный вопрос следует переформулировать следующим образом: почему все Еръ забили на эту инструкцию?

Сама-то что об этом думаешь?

Нормальные «кадры» - это кто, хипстеры в шортах?

Это которые умеют хоть что-то делать. Работать с идиотами в около гос. конторах идут только от безысходности.

Что-то по факту они получают...рядовые 20-35, начальники отделов 40-70, про 150 это вы серьёзно загнули. В провинции так вообще, верхняя планка 40.

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

А пытаться как ТС вписать в должностную инструкцию программисту ещё и починку утюгов - это конечно можно попробовать, но кто ж туда работать пойдёт.

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

По серьезным контрактам документацию серьезные техписы пишут, которые это 6 лет минимум изучали, не отвлекаясь на всякую чушь вроде кодирования. Разделение труда рулит.

Что они 6 лет изучали, эти ваши серьезные «техписы», не отвлекаясь? Стрелки осциллографов?

В идеальном обществе это должны делать специальные приставленные к нему люди, тащемта.

Что-то по факту они получают...рядовые 20-35, начальники отделов 40-70, про 150 это вы серьёзно загнули. В провинции так вообще, верхняя планка 40.

Это в каких-нибудь ФГУП-ах. В гос. корпорациях наподобие Ростелекома зарплаты бывают выше рыночных. Но по личному опыту, лучше работать за меньшие деньги где-нибудь в другом месте.

Возможно, тут просто синдром утенка в терминальной стадии. Вырос ТС в описанной среде, и теперь просто не может принять нечто иное, другое :)

А пытаться как ТС вписать в должностную инструкцию программисту ещё и починку утюгов

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

Ви таки задолбали уже своими ГОСТами, весь свет на них не сошёлся и мерить всё по одной этой планке - как-то глупо и вообще недалеко.

Любая компания на территории РФ?

Если только гос-уг какое нибудь

ЛПП. Выезжайте уже иногда из страны Московии к нам, в Россию.

В том что программист этого делать не должен.

Да и про инженеров и полный комплект ты тоже очень лихо привираешь, надо признать.

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

Неужели?

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

Зачем вы так упорно продолжаете проецировать ваши глупые фантазии на реальный мир?

Дык помимо инженера есть же ещё макаки типа тебя, которые за него напишут по ГОСТу, оформят по ГОСТу и сдадут заказчику эксплуатационную документацию.

Вырос ТС в описанной среде

Это надо было очень, очень постараться, чтобы настолько избегать любых контактов с реальностью.

мб англицкому?

Если ты имеешь в виду английский, то ему тоже.

Он имел в виду «аглицкий», а написал, что написал) (да еще и не раз).

На документацию обычно не предусматриваются бюджеты и по остаточному принципу. Информация очень быстро устаревает и не соответствует реальной картине.

В этом плане doxygen, javadoc системы, а также отличные встроенные системы как в питоне (характерная черта - все доки в коде)

Учить надо не документированию, а эффективным способам передачи информации на уровне смысловой составляющей. Например одни любят читать, другие смотреть диаграммы...

Из ГОСТ-ов не всегда легко извлечь пользу. И не реально все покрыть блок-схемами, хотя и хорошо бы их иметь.

В идеале, документация должна описывать так предметную область, чтобы можно реализовать не зависимо от привязок к ПО. Кто-то ненавидит шарп или перл - если описание отвязано от языка, платформы и т.п. такой доке цены нет. Это как правило интерфейсные типы, IDL? Что там еще есть? В ГОСТ слишком все формализовано и бюрократизировано, можно докопаться к любому проекту на нарушения.

Может быть смотреть в сторону проектов и платформ, имеющих развитые средства, (почти) встроенной в языки документации и генерации, включая поддержку markup? Это языки наверное: python, java, erlang, php, elisp (хотя в нем для других языков слабовата поддержка - всего-то надо навести мышкой на что-то (функция,метод) и появится подсказка с кратким описанием (кстати ищу нормальное решение для emacs+doxygen - doxymacs использую))? И тем не менее код на C в ядре относительно прекрасно документирован. (Помнится C++ задумывался как само-документируемый...)

Да и про инженеров и полный комплект ты тоже очень лихо привираешь, надо признать

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

Я так понимаю что кроме жалких попыток нахамить и фразы «полный комплект конструкторской документации» произносимой с придыханием, у тебя за душой ничего нет?

На мой взгляд

ничего себе, вот это довод!

кроме разработки собственно заказного ПО

т.е. другое ПО документировать совсем-совсем не надо?

программист должен

кому он должен? договор есть?

уметь разработать

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

полный комплект

что подразумевается под полным комплектом? это когда ты в документации указываешь отладочную информацию, алгоритмы, и пр. вещи, которые могут заинтересовать другого программиста? если да, то это ССЗБ, лишающее себя работы

в соответствии с ГОСТ

ага. А так же ДСТУ, ISO, IEEE, POSIX, DIN... Ишь, чего захотел! Стандарты эти твои - одна бюрократия. Каждый пишет документацию так, как хочет, однако соответствуя требованиям заказчика, либо своей совести.

Так на том она и хочет построить, чтобы любого программиста можно было заменить по отчётному периоду и времени индексации з\п, админов то уже заставляют во многих конторах писать полностью документацию с видео о том. как он настраивал сервак в этой фирме....

Думаю, что из местных мало кто может грамотно ответить на вопрос: «Что содержит документ „Руководство системного программиста“»?

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

С этим возникают очень серьезные проблемы.

Само собой, особенно если ты в школе не научился писать сочинения/изложения на заданную тему.

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

Тред-детектор быдлокодеров и плохих студентов с радужными мечтами

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

Хрен с ним пускай скажет, я буду это РЭ писать за разработчиков? Я могу написать, но давай вычтем мою зарплату из его договора?

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

Они никогда не создавали свой проект. Не были руководителями. Вы на разных языках разговариваете. Они привыкли на коленке наваять кусок кода. Хипстеры в шортах.

А техническому писателю ты голой код дашь или сочинение в свободном стиле?

наши технические писатели, разбирают код площадки после перелива на предрелизный, у нас php и ruby, подходит программист ведущих и объясняет как может изменения, после чего, они смотрят код, один смотрит php другой ruby и уже подробно документируют изменения.

1) это не работа разработчика

2) это работа, которую нужно сделать

3) это работа, за которую нужно платить

4) для этого в конторе есть отдельная должность

Причем тут ты и причем тут зарплата разработчика? Может зарплату шофера тоже из его вычесть? А зарплату курьера из твоей?

а эта мечтательница

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

А чему там учить то ?
Если такие умные, то почему в туалет до сих пор по госту не ходим ?

а толку что это баба? Мужики HR'ы такие же больные на голову.