Есть три причины, из-за которых документацию к программам никто не пишет:
1) Неграмотность. Человек напрягает мозг, рожает три предложения, MS Word подчеркивает семь ошибок. Финиш, депрессия.
2) Непонимание того, что было сделано. "Ну, типа вот сюда скопипастили код отсюда, оно и заработало". Забавно, что непонимающих может быть сколь угодно много. Например, аналитик нифига не понимает, что ему сказал заказчик и пишет задание кучей общих фраз. Программист, пишет что-нибудь, типа "если баги вылезут — разберемся". Тестировщик тоже не хочет быть крайним, проверяет самые очевидные случаи и смывается. И т.д., пока до пользователя не дойдет.
3) Смесь первых двух пунктов — человек понимает, как все сделано, и осознает, что сделано жутко криво. Настолько криво, что описывать стыдно.

Бонус: Человек боится, что если он все хорошо и понятно опишет, то его уволят, заменив на студента. Вариант: понимает, что та часть кода, за которую он отвечает, в проекте уже давно ничего не делает, но благодаря мутному описанию этого еще никто не заметил

#ttoesn

add comment recommend bookmark subscribe