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

«Не держись за ГОСТ, как слепой за стену» (ц)

И как минимум некоторых таки учат писать документацию. А лучше бы учили русскому языку...

программист должен уметь разработать полный комплект документации в соответствии с ГОСТ и требованиям ПЗ

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

Как это не обучают, ещё как обучают. Любой курсовик, любая лаба - вполне себе документация, а вершиной всему становится диплом.

Таки где таких учат? Может назовете ВУЗ и предмет, где изучают оформление документации по ЕСПД и ЕСКД?

Я хз, что в вузах, но таки в шараге мы курсачи по еспд фигачим.

Может назовете ВУЗ и предмет, где изучают оформление документации по ЕСПД и ЕСКД?

Это максимум на ПТУ тянет или на какое-нибудь училище для будущих кадров бумажкогенераторов в гос. учреждениях. Программисты то там не нужны.

Может назовете ВУЗ и предмет, где изучают оформление документации по ЕСПД и ЕСКД?

А зачем это _изучать_? Это что, самоцель? Нормоконтроль прошли и норм

Кто не обучает, с какого это? Меняй вуз

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

У всех претендентов с этим проблемы

Претендентов на какое место, простите?

Потому что ВУЗы готовят инженеров и математиков, а их документация — это всякие госты, еспд и прочее. И этому их вполне обучают — по принципу «неправильно оформил — не зачли работу».

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

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

Кандидат должен быть хорошим телепатом, чтобы ответить на подобный вопрос именно так, как вы хотите услышать.

программистов учить русском? Вы ничего не перепутали? мб англицкому?

программист должен уметь разработать полный комплект документации в соответствии с ГОСТ и требованиям ПЗ.

Разве это не работа технического писателя? На кой это программисту?

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

Ну так и отлично же, это формум технарей, а не кого попало.

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

Это типичный материал из справочника: http://mockean.ucoz.ru/famjokes.html#_Toc176849068

программистов учить русском?

Русскому

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

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

А зачем это _изучать_?

Ну, макакам из бодишопов это изучать ненужно. Но если хотите работать по серьезным контрактам, будьте любезны соответствовать.

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

интересно аж стало, каким это программистам нужен русский язык =)

«Серьезные контракты» - это какие? Распилы очередные чтоли? Да, там лапшу надо уметь вешать мастерски, не спорю :)

Как-то работал с одним НПП, в котором документация на русском и код на Аде.

Потому что выпускающим кафедрам тупа пофик.

ЗЫ Сам учись «на кошечках».

Кто такой этот «технический писатель», он что готов грамотно написать РЭ, обсудить все нюансы и утвердить его у заказчика?

по серьезным контрактам

маркетоидненько

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

Но вот буквоедение типа встреченного выше по топику - уже перегиб, другая крайность.

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

Программист (да и любой инженер) должен уметь выражать свои мысли. Если ты не умеешь выражать их на родном языке, ты не умеешь выражать их и на иностранном.

Или вы работаете в компании, занимающейся разработкой для руских клиентов? мб вы пишите на доки на русском?

Оба раза «да». А еще мы пишем «русских» и «пишете».

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

Дай ссылку на вакансию, интересно стало, чтож я в жизни упустил.

Ты давно с «серьезными контрактами» работаешь? Про системного аналитика не слышал?

Документация по ГОСТ была нечитабельна во всех случаях, что я сталкивался. Структурированно, формально, красиво, но бесполезно. Это не тот случай, когда нужна формализация.

Лучше бы их учили психологии потребителей (если такая есть).

Кто такой этот «технический писатель»

http://www.rabota.ru/guide/dolzhnostnye_instruktsii/dolzhnostnaja_instruktsij...

он что готов грамотно написать РЭ, обсудить все нюансы и утвердить его у заказчика?

Не знаю что такое РЭ, но если основное требование к этому документу - соответствие ГОСТам и прочим формальным требованиям, то над документом должен работать в том числе и технический писатель.

Или вы работаете в компании, занимающейся разработкой для руских клиентов?

Можно подумать, что на локальном ИТ-рынке нужны только юрики и лирики.

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

Ответ неверный. Правильный ответ: «Содержание документа регламентируется ГОСТ 19.503-79. United system for program documentation. System programmer's guide. Requirements to contents and form of presentation».

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

в этом случае могу посочувствовать вам

Оставь свое сочувствие для тех, кто в нем нуждается.

Так ваша вакансия-то как звучит? А то мы тут собрались, ждём.

Правильный ответ - «а по какому надо?».

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

РЭ - это «Руководство по эксплуатации». Для сложного изделия может состоять из сотен томов.

Бывает круче. Получают люди продукт, призванный автоматизировать некие задачи, курят доки, затем сабж и по ходу дела выясняется, что ряд заявленных функций не работает. Или функции работают, да не так. Например, нажатие кнопки «Сгенерировать отчёт» удаляет всю базу =)

Ответ неверный. Правильный ответ: «Содержание документа регламентируется ГОСТ 19.503-79. United system for program documentation. System programmer's guide. Requirements to contents and form of presentation».

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

Любой курсовик, любая лаба - вполне себе документация...

Это если делают сами, а не козлят =)

РЭ - это «Руководство по эксплуатации». Для сложного изделия может состоять из сотен томов.

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

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

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

госконтракт

Не госконтрактами едиными.

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

И там тебе очень быстро объяснят, что госконтракт, это не...

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

Ну скажите уже, что за компания, чтобы я обходил это место стороной

Любая компания на территории РФ? В ТЗ обычно пишут, «Разрабатываемая КД и ЭД, должна соответствовать действующим ГОСТ на территории РФ, на момент сдачи изделия» и прилагают перечень.

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

наизусть знать интерфейс офисного пакета майкрософт ворд.

Упоротость запросов сохранена.

Поддерживаю. А что, если, человек работает в международной компании, и там нет гостов. Там всё в PDF давно, и Google Docs. Это только в СССР распечатывают доки и читают их за круглым столом в присутствии жирных энтерпрайз начальников :-)

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

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

Насчет работы за еду - тоже вопрос очень тонкий. Зарплаты в гос. организациях вполне приемлемы. Это 45-150 тыс. для рядовых программистов, для руководителей уровня нач. отдела от 500 тыс.

Но, это допуск, требования там известны.