updated readme with design notes