docs(using_deis): add docs for deis build

Author: Matthew Fisher

client/deis.py

@@ -784,9 +784,18 @@ def builds(self, args):
 
     def builds_create(self, args):
         """
-        Create a new build of an application
+        Creates a new build of an application.
 
         Usage: deis builds:create <image> [--app=<app>]
+
+        Arguments:
+          <image>
+            A fully-qualified docker image, either from DockerHub (e.g. deis/example-go)
+            or from an in-house registry (e.g. myregistry.example.com:5000/example-go).
+
+        Options:
+          --app=<app>
+            The uniquely identifiable name for the application.
         """
         app = args.get('--app')
         if not app:

docs/using_deis/deploy-application.rst

@@ -30,9 +30,9 @@ Select a Build Process
 ----------------------
 Deis supports three different ways of building applications:
 
- 1. `Heroku Buildpacks`_
- 2. `Dockerfiles`_
- 3. `Docker Image`_ (coming soon)
+ 1. `Heroku Buildpack`_
+ 2. `Dockerfile`_
+ 3. `Docker Image`_
 
 Buildpacks
 ^^^^^^^^^^
@@ -46,6 +46,14 @@ Dockerfiles are a powerful way to define a portable execution environment built
 
 Learn how to use deploy applications on Deis :ref:`using-dockerfiles`.
 
+Docker Image
+^^^^^^^^^^^^
+Deploying a Docker image onto Deis allows you to take a Docker image from either a public
+or a private registry and copy it over bit-for-bit, ensuring that you are running the same
+image in development or in your CI pipeline as you are in production.
+
+Learn how to deploy applications on Deis using :ref:`deis_builds`.
+
 
 .. _`twelve-factor methodology`: http://12factor.net/
 .. _`Heroku Buildpacks`: https://devcenter.heroku.com/articles/buildpacks