README improvements

Author: sebgoa

README.md

@@ -1,8 +1,25 @@
 # Kubernetes Python Client
 
 [![Build Status](https://travis-ci.org/kubernetes-incubator/client-python.svg?branch=master)](https://travis-ci.org/kubernetes-incubator/client-python)
+[![PyPI version](https://badge.fury.io/py/kubernetes.svg)](https://badge.fury.io/py/kubernetes)
 
-Python clients for talking to a [kubernetes](http://kubernetes.io/) cluster.
+Python client for the [kubernetes](http://kubernetes.io/) API.
+
+## Installation
+
+From source:
+
+```
+git clone https://github.com/kubernetes-incubator/client-python.git
+cd client-python
+python setup.py install
+```
+
+From [PyPi](https://pypi.python.org/pypi/kubernetes/) directly:
+
+```
+pip install kubernetes
+```
 
 ## Example
 
@@ -54,7 +71,25 @@ python -m examples.example1
 (replace example1 with the example base filename)
 
 
-# Generated client README
+## Documentation
+
+All APIs and Models' documentation can be found at the [Generated client's README file](kubernetes/README.md)
+
+## Community, Support, Discussion
+
+You can reach the maintainers of this project at:
+
+* [Slack](http://slack.kubernetes.io): #sig-api-machinery
+* Mailing List: [https://groups.google.com/forum/#!forum/kubernetes-sig-api-machinery](https://groups.google.com/forum/#!forum/kubernetes-sig-api-machinery)
+
+If you have a problem with the package or suggestions. Please file an [issue](https://github.com/kubernetes-incubator/client-python/issues).
+
+### Code of Conduct
+
+Participation in the Kubernetes community is governed by the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/master/code-of-conduct.md).
+
+## Kubernetes Incubator
 
-All APIs and Models' documentation can be find at the [Generated client's README file](kubernetes/README.md)
+This is a [Kubernetes Incubator project](https://github.com/kubernetes/community/blob/master/incubator.md). 
 
+* SIG: sig-api-machinery