Уныние

[metaclass]

Сижу читаю описание postscript, завожу Ghostscript, чтобы он видел свои шрифты на винде, итд, итп и гложет мысль: "Вот если я это прикручу в продакшен, ведь потом кому-то придется весь этот ад изучать и ставить повторно, потому что никто времени на обучение других сотрудников не выделит, да и сотрудников этих то нету".

Даже с учетом того, что я уже написал в баг-трекере кратко, где и как это берется - этого никто не найдет, потому что 1) надо знать, что вообще есть баг-трекер 2) нужно чтобы этот баг-трекер пережил, скажем, мое увольнение(в лучшем случае) или попадание в дурдом(в худшем), 3) нужно догадаться что там можно искать по ключевым словам, 4) нужно знать ключевые слова.

Т.е. следует постулат: документацию больше нескольких строчек на любую сущность писать бесполезно, потому что ее: 1)некому читать 2)никто не поймет используемых идей 3)никто не знает что документация существует.

PS: Кстати,я еще завел порочную практику часть документации вместо баг-трекера держать в виде latex документов в svn. А то трекер очень уж сука тормозит, ибо "веб-приложение", и неудобно крупные документы в нем делать.
Будущим поколениям, открывающим мои папки в "Windows Explorer" - пламенный превед.

Comments

[lionet.livejournal.com]

Заведи папку в Google Docs с проектными документами (docs, spreadsheets), и расшарь её на заинтересованных лиц.

[fas-tm.livejournal.com]

Т.е. ты сознательно создал условия чтобы будущий работник предал тебя анафеме :)
Вероятно он будет ныть в своем ЖЖ и рассказывать про "ад и израиль, жаб и червей"(с)

[alexott.livejournal.com]

а зачем тебе postscript, при наличии pdf?

[henu3detb.livejournal.com]

ух блин...
mediawiki. А если не жалко 10 долларов, то confluenсe.

[clayrat.livejournal.com]

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