Документирование

Схлестнулись мы тут с коллегой относительно документации к ПО +) и конечно, когда вся документация к коду содержится в голове у разработчика это безусловно минус. С другой стороны создание и поддержание актуальной документации это серьезная задача, требующая массу ресурсов.

По мне так, создание грамотной системы интерфейсов использование код конвеншен и JavaDoc (не в виде отмазки, а в виде приличной рабочей документации, создающейся с самого начала) для небольшой команды полностью покрывает все потребности в документировании.

Однако, для больших систем и больших команд такой подход не применим. Как правильно? Я незнаю +) если вы знаете поделитесь опытом +)))