From a6ab82d6c0d5b206cfc0e76b71a848babf205c0a Mon Sep 17 00:00:00 2001
From: Derek McQuay <dmcquay@apprenda.com>
Date: Thu, 9 Mar 2017 17:17:07 -0800
Subject: [PATCH] update kubernetes example-app explanation

Clarify some potentially confusing issues with how to run and build the
example-app binary.
---
 Documentation/kubernetes.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/Documentation/kubernetes.md b/Documentation/kubernetes.md
index 5c9be1f1..d0cec100 100644
--- a/Documentation/kubernetes.md
+++ b/Documentation/kubernetes.md
@@ -93,12 +93,20 @@ __Caveats:__ No health checking is configured because dex does its own TLS termi
 
 ## Logging into the cluster
 
-The example app can be used to log into the cluster. Choose the GitHub option and grant access to dex to view your profile.
+The `example-app` can be used to log into the cluster and get an ID Token.
+
+To build the app, you can run `make` and it will build the `example-app` binary in the root of the repo in the `bin` directory. To build the `example-app` requires at least a 1.7 version of Go. 
 
 ```
 $ ./bin/example-app --issuer https://dex.example.com:32000 --issuer-root-ca examples/k8s/ssl/ca.pem
 ```
 
+Please note that the `example-app` will listen at http://127.0.0.1:5555 and can be changed with the `--listen` flag.
+
+Once the example app is running, choose the GitHub option and grant access to dex to view your profile.
+
+The default redirect uri is http://127.0.0.1:5555/callback and can be changed with the `--redirect-uri` flag and should correspond with your GitHub OAuth2 client. 
+
 The printed ID Token can then be used as a bearer token to authenticate against the API server.
 
 ```
-- 
GitLab