more text edits to design guide
Merge pull request #1586 from cfarquharson/master

more text edits to design guide