From 264b7224b947000bc2feae416af41da5770eedc2 Mon Sep 17 00:00:00 2001
From: Danny Hermes <daniel.j.hermes@gmail.com>
Date: Tue, 25 Aug 2015 09:50:57 -0700
Subject: [PATCH] Basic beginning of authentication module.

---
 docs/gcloud-auth.rst | 26 ++++++++++++++++++++++++++
 docs/index.rst       |  1 +
 2 files changed, 27 insertions(+)
 create mode 100644 docs/gcloud-auth.rst

diff --git a/docs/gcloud-auth.rst b/docs/gcloud-auth.rst
new file mode 100644
index 000000000000..ecd0f7b25c4a
--- /dev/null
+++ b/docs/gcloud-auth.rst
@@ -0,0 +1,26 @@
+Authentication
+--------------
+
+Quick overview
+==============
+
+*   **If you're running in Compute Engine or App Engine**,
+    authentication should "just work".
+
+*   **If you're developing locally**,
+    the easiest way to authenticate is using the `Google Cloud SDK`_:
+
+    .. code-block:: bash
+
+        $ gcloud auth login
+
+.. _Google Cloud SDK: http://cloud.google.com/sdk
+
+
+*   **If you're running your application elsewhere**,
+    you should download a service account JSON keyfile
+    and point to it using an environment variable:
+
+    .. code-block:: bash
+
+        $ export GOOGLE_APPLICATION_CREDENTIALS="/path/to/keyfile.json"
diff --git a/docs/index.rst b/docs/index.rst
index 6c27b1eb1318..31c8fc80a566 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -4,6 +4,7 @@
   :caption: gcloud
 
   gcloud-api
+  gcloud-auth
 
 .. toctree::
   :maxdepth: 0