Серьезно, это еще и в Питере? В 2018 году? Какого хрена?

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

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

Сенектутем
С нас в курсаче требуют контрольные примеры, схему главной функции, иерархическую структуру вызовов функций, описание каждой функции (прототип, назначение, описание всех локальных и формальных переменных), инструкцию для пользователя, результаты тестирования + сам код (да, 2,5к строк кода прямо в отчёте)

И это я ещё решила сделать вид, что не использую свои библиотеки, и просто скидать все нужные функции в один срршник перед вставкой в отчёт

Я слышала, что ИТМО, если не КТ, то такая же шарага

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

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

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

leprechaun
Вощем четаю я твои пасты и тиха фалламарфирую, блядь... И етаму учат в институтах. Блядь. Сыстема абразавания у нас пыздец с отрыжкой сафка похожа у нас вообсче вся.

leprechaun
И тыбя за огромный адын сыпыпы/аш тоже па галофки ни пагладят... нада чётка структуриравать код па фаилам. в прадакшане за такое ибут сильна.