- комментов почти ноль.
- или комменты типа "щас функция сделает со структурой много интересных вещей" (конец цитаты) хахаха... зачем было писать?
- Например, файл pass1.cpp в 3й версии очень сильно переписан, но по трекингу в начале файла этого вообще не видно, последнее апдэйт 2004м годом.
- я уж не говорю инфу про обще-архитектурные вещи.

Сравните с postgree, там основные файлы начинаются с описалова, что он делает и зачем это нужно, каждый функциональный блок со своим README идет, который описывает функционал блока, причем эти README порой на маленькую диссертацию тянут, dev-часть на сайте содержит описание архитектуры, есть куча как про вообще, так и по частям, видео выложены, где эти презентации вслух рассказывают, код-браузер и тп плюшли.

o_v_a,

А то есть, кодерам приплачивать надо, что бы они внятные каменты писали???
Тот же постгри такой же опенсорс.

dimitr,

Где лучше спрашивать? Здесь или есть лучше места?

kdv,

Я неправильно запрос сформулировал, наверное.

Конечно, общеархитектурные в коде комметить нельзя, разве что README в корне SRC. Я про ресурсы вообще. Что то типа такого http://www.postgresql.org/developer/backend/ со ссылками вплоть до исходного кода.

Для FB я нашел древний тестовый аналог - http://ibphoenix.com/resources/documents/development/doc_31 , точнее это еще про IB6|. Но я совсем не уверен, что эта инфа будет полностью верной для FB3