HommerДавайте перечислим все известные проблемы, несуразности, неочевидности, недоработки, костыли. Всё что помнится и что забыто. Без ужимок и самоцензуры :)

И через полгода-год этот документ устареет

Хочешь - никто тебе не мешает. Проштудируй трекер, десяток форумов, Stack Overflow.
Напишешь статью для Хабра.
Была статья MySQL gotchas - ты напишешь Firebird gotchas.
Её будут читать, тысячи их.

А через пару лет она устареет, если ты сам не будешь ее регулярно обновлять и до/пере-писывать.
А ты будешь?

Вон wiki есть - firebirdsql.su - идея была хорошая, сделать справочник языка, учитывающий все версии, гед можно быстро в каждой команде увидеть когда и что она научилась делать.
И то все полумертвое.

Заведи на неё раздел "несуразности без самоцензуры" и наполняй, и систематизируй, и структурируй