Миф о документации, продолжение

[gaperton]

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

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

Comments

[donz_ru]

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

[gaperton]

> ты сам говоришь, что мир не идеален и не веришь, что кто-то пишет хорошую документацию

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

> но при этом приводишь пример идеальной разработки, при которой документация практически не нужна. Не находишь диссонанс?

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

[gaperton]

...почему это не является нормой.

[donz_ru]

Пока отвечу только про веру цитатой тебя:
"А я вам, во-первых - на предмет "аккуратно" и "всегда" не поверю. :) Ну, в самом деле, говорить всякое можно, но меру-то знать надо. :)"

[gaperton]

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

[donz_ru]

А у меня, значится, исключительная религиозный фанатизм и никаких фигур речи быть не может? :)

[gaperton]

Могут, почему нет. У меня-то после "не поверю" смайлик стоит, что какбэ намекать должно, что я не до конца серьезен, нет?

А у тебя смайлик где? :)

[donz_ru]

"Без смайликов юмор не понимаем?" (с) :)
Я просто привел пример, когда ты со скептицизмом относишься к одной стороне разработки, но не проявляешь сомнений относительно другой. Вообще странно, что это можно было воспринять в религиозном аспекте.

[gaperton]

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

Не со "скептицизмом отношусь", и "не проявляю сомнений", а предметно обосновываю, почему так.

> Вообще странно, что это можно было воспринять в религиозном аспекте.

Потому, что ты оперируешь понятиями "веришь", "со скептицизмом", "сомнения".

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