more design notes as comments