Add an updated state and links to docs and code
Merge pull request #32 from jclinton/add-design-docs

Add an updated state and links to docs and code