Updates to Design guide documentation
Merge pull request #1575 from cfarquharson/master

Updates to Design guide documentation