Content updates to design guide
Merge pull request #1729 from cfarquharson/master

Content updates to design guide