update design decisions draft