developer documentation

Würde es Sinn ergeben unter /doc/dev eine Entwicklerdokumentation abzulegen, welche die Theorie erklärt, die interne Funktionweise beschreibt und die Design-Entscheidungen begründet?