Способ мышления-Форт



Глава 5. Разработка: элементы Форт-стиля - часть 25


Эта проблема может быть уменьшена, если руководитель проекта тщательно проверяет код и убеждается в точности примечаний.

Наконец, подробное комментирование может дать ложное чувство безопасности. Не надейтесь на то, что, поскольку каждая `строчка` имеет примечание, `задача` хорошо прокомментирована. По-строчные примечания не подчеркивают важные аспекты работы определения. Что, к примеру, за мысль заложена в использованном алгоритме подсчета контрольной суммы? Как ее понять из повествовательных комментариев?

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

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

А как же горизонтальный формат? Быть может, это дело практики или личного искуства, но я просто обязан защитить горизонтальный формат как не менее ценный и, в некоторых случаях, более выигрышный.

Если Форт-код хорошо написан, то в нем не должно быть неясностей. Это означает, что:

* лексиконы поддержки имеют хорошо спроектированный синтаксис * преобразования на стеке закомментированы * выполнен целевой комментарий (если он не ясен из имени определения или стекового комментария) * определения не слишком длинны * не слишком много аргументов передается через стек одному определению (смотрите "Шикарный стек" в главе 7).

Форт просто не таков, как другие языки, в которых по-строчные примечания - это одна из немногих вещей, которые можно сделать для повышения читаемости программ.

Мастерски написанный на Форте код подобен поэзии, он содержит точное значение, которое и программист, и машина легко читают. Вашей `целью` должно быть написание такого кода, к которому примечания не нужны, даже если Вы захотите его комментировать.


Содержание  Назад  Вперед