Documentation should recommend to use hostnames for links

[bfirsh]

redis = Redis(
    host=os.environ.get('REDIS_1_PORT_6379_TCP_ADDR'),
    port=int(os.environ.get('REDIS_1_PORT_6379_TCP_PORT'))
)

This is bonkers. We should do this instead:

redis = Redis(host="redis-1", port="6379")

[bfirsh]

Blocked by #229 and moby/moby#6270.

[aanand]

If we add a non-numeric link alias as discussed in #37, this doesn't block on anything.

[bfirsh]

Also discussed in #349.

Alright, let's do that.

[d11wtq]

If you link with redis:redis, then it is simplified to:

redis = Redis(host="redis", port="6379")

This should probably be a default too, since that "alias" is just internal to the container linking to it.

[aanand]

Yeah, redis should be equivalent to redis:redis. Working on a PR now.

[bfirsh]

fixed in #364