Add a top level introduction to the index

Change-Id: Icfe152a2829c2cb82a0955b91052183d7c488510
Merge "Add a top level introduction to the index"
heatclient is not working with os-auth-token

heatclient is failing if os-auth-token (OS_AUTH_TOKEN) is
provided. With this change, user can provide either auth token
or password with heatclient command line tool (heat).

Closes Bug: #1248265

Change-Id: I22b6af351dd3a371443f432b04785c706eff8325
Returning the json body after a stack-create or stack-update

This allows the downstream service access to the data coming
back from the REST API, primarily the stack id.

implements blueprint return-id-on-stack-create

Change-Id: I24db9c28fca1f50f5ef1452679f444095d22d103
Merge "heatclient is not working with os-auth-token"
Add a basic man page for heat

This shows a taste of commands and shows how to access the help

Closes-bug: #1153824
Change-Id: Ia69072c224e8940927dce0c984040d4c81bcee45
Encode output for fixing UnicodeDecodeError

Current heatclient doesn't handle properly outgoing encode process.
For resolving it, this patch implements a process to encode everything
going out of the client, for example, prints.

This patch used two new modules (gettextutils.py and strutils.py)
taken from oslo-incubator in order to use safe_encode() and
safe_decode().

Closes-Bug: #1249233

Change-Id: Ia8c955a80d68126cd9c1fd791bda3e331a2aa5c9