docs: Vuepress-powered docs (#296)

* * created vuepress docs

* chore: upgrade deps

* docs: patreon link

* Docs changes

docs/api/README.md

@@ -0,0 +1,5 @@
+# API Reference
+
+::: warning WIP
+PR welcome!
+:::

docs/api/apollo-mutation.md

@@ -0,0 +1 @@
+# ApolloMutation component

docs/api/apollo-provider.md

@@ -0,0 +1,104 @@
+# ApolloProvider
+
+## Constructor
+
+```javascript
+const apolloProvider = new VueApollo({
+  // Multiple clients support
+  // Use the 'client' option inside queries
+  // or '$client' on the apollo definition
+  clients: {
+    a: apolloClientA,
+    b: apolloClientB,
+  },
+  // Default client
+  defaultClient: apolloClient,
+  // Default 'apollo' definition
+  defaultOptions: {
+    // See 'apollo' definition
+    // For example: default loading key
+    $loadingKey: 'loading',
+  },
+  // Watch loading state for all queries
+  // See the 'watchLoading' advanced option
+  watchLoading (state, mod) {
+    loading += mod
+    console.log('Global loading', loading, mod)
+  },
+  // Global error handler for all smart queries and subscriptions
+  errorHandler (error) {
+    console.log('Global error handler')
+    console.error(error)
+  },
+})
+```
+
+Use the apollo provider into your Vue app:
+
+```javascript
+new Vue({
+  el: '#app',
+  apolloProvider,
+  render: h => h(App),
+})
+```
+
+## Methods
+
+### prefetchAll
+
+(SSR) Prefetch all queued component definitions and returns a promise resolved when all corresponding apollo data is ready.
+
+```javascript
+await apolloProvider.prefetchAll (context, componentDefs, options)
+```
+
+`context` is passed as the argument to the `prefetch` options inside the smart queries. It may contain the route and the store.
+
+`options` defaults to:
+
+```javascript
+{
+  // Include components outside of the routes
+  // that are registered with `willPrefetch`
+  includeGlobal: true,
+}
+```
+
+### getStates
+
+(SSR) Returns the apollo stores states as JavaScript objects.
+
+```JavaScript
+const states = apolloProvider.getStates(options)
+```
+
+`options` defaults to:
+
+```javascript
+{
+  // Prefix for the keys of each apollo client state
+  exportNamespace: '',
+}
+```
+
+### exportStates
+
+(SSR) Returns the apollo stores states as JavaScript code inside a String. This code can be directly injected to the page HTML inside a `<script>` tag.
+
+```javascript
+const js = apolloProvider.exportStates(options)
+```
+
+`options` defaults to:
+
+```javascript
+{
+  // Global variable name
+  globalName: '__APOLLO_STATE__',
+  // Global object on which the variable is set
+  attachTo: 'window',
+  // Prefix for the keys of each apollo client state
+  exportNamespace: '',
+}
+```

docs/api/apollo-query.md

@@ -0,0 +1 @@
+# ApolloQuery component

docs/api/apollo-subscribe-to-more.md

@@ -0,0 +1 @@
+# ApolloSubscribeToMore component

docs/api/dollar-apollo.md

@@ -0,0 +1,3 @@
+# Dollar Apollo
+
+This is the apollo manager added to any component that uses apollo. It can be accessed inside a component with `this.$apollo`.

docs/api/smart-query.md

@@ -0,0 +1,3 @@
+# Smart Query
+
+Each query declared in the `apollo` definition (that is, which doesn't start with a `$` char) in a component results in the creation of a smart query object.

docs/api/smart-subscription.md

@@ -0,0 +1,3 @@
+# Smart Subscription
+
+Each subscription declared in the `apollo.$subscribe` option in a component results in the creation of a smart subscription object.