Create a hosted version of design system documentation

Matt Buck
2020-07-17T19:34:56Z

We need to host the design system documentation in order to involve the community in the design of Studio.

## Considerations

* The design system documentation should be as easy to contribute to as possible.
* It should be the single source of truth for both design and development efforts for Voxable Studio components.
* The prose describing a component should be colocated with its Figma designs, link to its repo, its current version and build status, technical documentation, and Storybook page.

## Architecture

* We'll use Netlify for hosting.
* [Once this issue is resolved](https://github.com/gitpod-io/gitpod/issues/1118), contributors can use Gitpod to load a fully functional dev environment for the docs within their browser. This will significantly reduce the barrier to entry for contributing to the docs.

## Tasks

- [x] Create a hosted, autobuilding version of the docs on Netlify
- [x] Enable commenting on merge requests with a link to the deploy preview
- [ ] Ensure existing pages show up as part of the Page collection
- [ ] [Add a Components collection](https://vuepress.vuejs.org/theme/default-theme-config.html#custom-layout-for-specific-pages)
- [ ] Attach a custom domain

## References

* https://yonkov.github.io/post/setting-up-vuepress-with-netlify-cms/
* https://github.com/yonkov/Vuepress-project/tree/master/.vuepress/public/admin
* https://github.com/DemoMacro/VuePress-NetlifyCMS
* https://github.com/vuejs/vuepress/issues/143
* https://vuepressbook.com/netlify.html
* https://blog.michaelbrooks.dev/adding-netlifycms/