docs: add render method to docs (#485)

Author: eddyerburgh

docs/en/README.md

@@ -18,6 +18,7 @@ Vue Test Utils is the official unit testing utility library for Vue.js.
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [render](api/render.md)
   * [renderToString](api/renderToString.md)
   * [Mounting Options](api/options.md)
     - [context](api/options.md#context)

docs/en/SUMMARY.md

@@ -14,6 +14,7 @@
 * [API](api/README.md)
   * [mount](api/mount.md)
   * [shallow](api/shallow.md)
+  * [render](api/render.md)
   * [renderToString](api/renderToString.md)
   * [Mounting Options](api/options.md)
     - [context](api/options.md#context)

docs/en/api/README.md

@@ -2,6 +2,7 @@
 
 * [mount](./mount.md)
 * [shallow](./shallow.md)
+* [render](./render.md)
 * [renderToString](./renderToString.md)
 * [Mounting Options](./options.md)
   - [context](./options.md#context)

docs/en/api/render.md

@@ -0,0 +1,103 @@
+# `render(component {, options}])`
+
+- **Arguments:**
+
+  - `{Component} component`
+  - `{Object} options`
+    - `{Object} context`
+      - `{Array<Component|Object>|Component} children`
+    - `{Object} slots`
+        - `{Array<Componet|Object>|Component|String} default`
+        - `{Array<Componet|Object>|Component|String} named`
+    - `{Object} mocks`
+    - `{Object|Array<string>} stubs`
+    - `{Vue} localVue`
+
+- **Returns:** `{CheerioWrapper}`
+
+- **Options:**
+
+See [options](./options.md)
+
+- **Usage:**
+
+Renders an object to a string and returns a [cheerio wrapper](https://github.com/cheeriojs/cheerio).
+
+Cheerio is a jQuery-like library to traverse the DOM in Node.js. It has a similar API to the Vue Test Utils [`Wrapper`](wrapper/README.md).
+
+`render` uses [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) under the hood, to render a component to static HTML.
+
+`render` is included in the `@vue/server-test-utils` package.
+
+**Without options:**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo)
+    expect(wrapper.text()).toContain('<div></div>')
+  })
+})
+```
+
+**With Vue options:**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo, {
+      propsData: {
+        color: 'red'
+      }
+    })
+    expect(wrapper.text()).toContain('red')
+  })
+})
+```
+
+**Default and named slots:**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+import Bar from './Bar.vue'
+import FooBar from './FooBar.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const wrapper = render(Foo, {
+      slots: {
+        default: [Bar, FooBar],
+        fooBar: FooBar, // Will match <slot name="FooBar" />,
+        foo: '<div />'
+      }
+    })
+    expect(wrapper.text()).toContain('<div></div>')
+  })
+})
+```
+
+**Stubbing global properties:**
+
+```js
+import { render } from '@vue/server-test-utils'
+import Foo from './Foo.vue'
+
+describe('Foo', () => {
+  it('renders a div', () => {
+    const $route = { path: 'http://www.example-path.com' }
+    const wrapper = render(Foo, {
+      mocks: {
+        $route
+      }
+    })
+    expect(wrapper.text()).toContain($route.path)
+  })
+})
+```

docs/en/api/renderToString.md

@@ -25,10 +25,12 @@ Renders a component to HTML.
 
 `renderToString` uses [`vue-server-renderer`](https://ssr.vuejs.org/en/basic.html) under the hood, to render a component to HTML.
 
+`renderToString` is included in the `@vue/server-test-utils` package.
+
 **Without options:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {
@@ -42,7 +44,7 @@ describe('Foo', () => {
 **With Vue options:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {
@@ -60,7 +62,7 @@ describe('Foo', () => {
 **Default and named slots:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 import Bar from './Bar.vue'
 import FooBar from './FooBar.vue'
@@ -82,7 +84,7 @@ describe('Foo', () => {
 **Stubbing global properties:**
 
 ```js
-import { renderToString } from '@vue/test-utils'
+import { renderToString } from '@vue/server-test-utils'
 import Foo from './Foo.vue'
 
 describe('Foo', () => {