?

Log in

No account? Create an account
November 2016   01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
cartoon

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

Posted on 2011.06.18 at 23:06

Comments:


melkus
melkus at 2011-06-19 14:43 (UTC) (Link)
На мой взгляд тут описывается идеальный вариант, который может не работать по тысяче причин. Начиная с вмешательства заказчика в процесс документирования и заканчивая психологией. Т.е. к примеру тяжело сидеть и соблюдать все правила в то время как заказчик падла заливается когда ему угодно и постоянно ломает билд.

При этом надо заметить что к базе у меня претензий нет - всё так и есть, но вот когда идут уточнения, как например про заливки, во мне просыпается махровый технарь и начинает вопить что все это бессмысленная трата времени и вообще отцы ошибок не делают, нехер их код проверять, а если и делают, то так надо было :)
Gaperton
gaperton at 2011-06-19 15:05 (UTC) (Link)
> На мой взгляд тут описывается идеальный вариант, который может не работать по тысяче причин.

C 99 года я наблюдаю этот вариант, и не разу не видел, чтобы он не работал. Для меня он не идеальный - это реальность, к которой я привык.

А вот волшебной "документации", сочетающей все три качества из трех выделенных мной видов, я не видел ни разу в жизни.

> начинает вопить что все это бессмысленная трата времени и вообще отцы ошибок не делают, нехер их код проверять, а если и делают, то так надо было :)

Статистика показывает, что ошибаются все, включая "отцов". В среднем программистом на С++ вносится от 20 до 40 ошибок на тысячу строк кода, в зависимости от стиля программирования.

Кроме того, ревью это не привилегия, а обязанность, перед которой все равны, в том числе и "отцы". Не может человек требовать от людей того, что не готов делать сам. Иначе он никакой не "отец", а лохопед с зашкаливающим ЧСВ. :)
melkus
melkus at 2011-06-20 08:53 (UTC) (Link)
Про волшебную документацию ничего не скажу - мне тяжело судить без опыта, но вроде все правильно. Сам придерживаюсь мнения что каждый документ должен быть кому то нужен, если он никому не нужен - то и писать его не стоит.

>Статистика показывает, что ошибаются все, включая "отцов".
Это была ирония. А ревью действительно обязанность и многих надо ещё как то заставлять это делать. Тем не менее меня пока пугает глобальный ревью, возможно потому что у меня в проекте не так много людей и как результат по многим направлениям мне придется самому делать ревью, что сильно накладно.

С++ я практически ненавижу как раз из-за того что Java многие ошибки показывает сразу, да и анализаторы кода позволяют многое поймать. Что не отменяет необходимости периодически писать JNI расширения на С++.
Previous Entry  Next Entry