Извън архитектурните и концептуални описания (без да включвам и потребителската документация), смятам че основната документация трябва да е в кода, или например скрипта за създаване на базата, за да се поддържа up to date. Javadoc е добра идея в това отношение.


Проблемът ти идва от думичката "извън". Всички методологии се целят в това процесът на софтуерното производство да бъде разбираем за всеки, включително и това какво е поискано, защо е поискано, какво е направено и защо е направено. Под "всеки" се разбира всички, които са ангажирани по някакъв начин в проекта. Американците им викат "stakeholders". Думичката "извън", която употребяваш, говори, че мислиш като програмист, т.е. тебе те интерсува само програмен код и скриптове, които са разбираеми (при това само донякъде, защото те дават отговор на въпроса "как?" но не и на въпроса "защо?") само за програмисти и забравяш, че има много други хора в този процес. РУП е създаден да обслужва всички.

Не ме разбирай погрешно - не съм им адвокат. Даже точно в това, което казах по-горе е и техния голям проблем - създали са едно средство, което трябва да обслужва всички участници в един проект, но са го направили да използва обекно-ориентиран подход и UML, които са разбирами само от (някои) програмисти.