improve design and build notes