lots of design work in comments and readme