configuration and design notes