Комментарии удалены?

[Hamster]

2 mazzy

Такое в голове держать выше сил человеческих.
Так что диаграммы есть.
Может местному CIS их не дают, но они есть.

А не дают понятно почему....

[Андре]

Цитата:

О... как я верил в это еще год назад.
Фиг, нет у них такой документации.
Действительно нет.

Ага. Только вот попробуй докажи это клиентам и партнерам

[mazzy]

Цитата:

Изначально опубликовано Андре
Ага. Только вот попробуй докажи это клиентам и партнерам

все, уже перестал.

Руководство начинающего медитатора:
http://a-bobkov.narod.ru/misc/meditator.txt

Сидели Шива с Паравати на высокой горе и спрашивает Паравати сдуру:
- Слушай, Шива, а чего это люди все так страдают?
- Это потому, что они желают страданий, - отвечал Шива.
- Hо как сделать, чтобы они не желали страданий?
- Да просто не желать, но ты же знаешь этих пассажиров, им хрен чего
объяснишь!
...

[Alks]

Цитата:

Изначально опубликовано George Nordic
http://w8.platonoff.com/refactoring/

Рефакторинг! Утонем в комментариях. Код - это и есть в данном случае комментарий + грамотное название методов и классов...
Другое дело, что в паре мест они действительно не помешеют...

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

PHP код:

// прирастим переменную i на единицу
i++; 


остерегают даже самые неудачные книжки по программированию.
На самом деле хороший комментарий не должен комментировать код (вернее почти не должен - везде есть исключения, иногда нестандартный приём в коде должен быть прокомментирован, чтобы не сбить с толку, но как правильно говорится в принципах рефакторинга код по возможности не должен содержать таких неочевидных/нестандартных моментов), комментарий должен комментировать ИДЕЮ. КАК МИНИМУМ должен быть прокомментирован каждый класс (в classDeclaration прописана сущность класса, его предназначение, место в иерархии классов) и каждый метод (тоже в целом - сущность метода, его параметры, возвращаемое значение, возможные побочные эффекты).
Учтивывайте то, что даже программист разрабатывавший код самолично через пару месяцев уже не узнаёт ни строчки из своего кода - тут уже степень закомментированности программы становится просто показателем эффективности труда, я уже не говорю про то что смена или привлечение нового программиста просто катастрофически затруднена если нет хоть какой то документации.

[linney]

В том-то и дело, что всего, что должно быть - нету...
И написание мелочной модификации - превращается в неделю ТУПОГО дебагирования

Старый добрый принцип: программу было трудно писать (верю) , так пусть ее будет трудно читать-модифицировать

[komar]

Цитата:

Изначально опубликовано mazzy

О... как я верил в это еще год назад.
Фиг, нет у них такой документации.
Действительно нет.

Похоже, и правда нету. Хотя система все-таки не похожа на написанную без документации вообще. То есть для самой первой версии, пусть даже тогда еще конкорда она таки должна была быть!

[Alks]

Цитата:

Изначально опубликовано mazzy

О... как я верил в это еще год назад.
Фиг, нет у них такой документации.
Действительно нет.

=8-(o)

Вы считаете возможно вести такой проект, как Аксапта без документации???!!!

[mazzy]

Цитата:

Изначально опубликовано Alks
Вы считаете возможно вести такой проект, как Аксапта без документации???!!!

Хм... Разрешите самоповториться?

Сидели Шива с Паравати на высокой горе и спрашивает Паравати сдуру:
- Слушай, Шива, а чего это люди все так страдают?
- Это потому, что они желают страданий, - отвечал Шива.
- Hо как сделать, чтобы они не желали страданий?
- Да просто не желать, но ты же знаешь этих пассажиров, им хрен чего
объяснишь!

[Alks]

Цитата:

Изначально опубликовано mazzy

Хм... Разрешите самоповториться?

Я верю не только в дзен, но и в здравый смысл.