Update to follow doc portal updates.

Author: pglombardo

README.md

@@ -4,7 +4,7 @@
 
 # Instana
 
-The instana package provides Python metrics and traces (request, queue & cross-host) for [Instana](https://www.instana.com/).
+The `instana` Python package collects key metrics and distributed traces for [Instana](https://www.instana.com/).
 
 This package supports Python 2.7 or greater.
 
@@ -13,52 +13,37 @@ Any and all feedback is welcome.  Happy Python visibility.
 [![Build Status](https://travis-ci.org/instana/python-sensor.svg?branch=master)](https://travis-ci.org/instana/python-sensor)
 [![OpenTracing Badge](https://img.shields.io/badge/OpenTracing-enabled-blue.svg)](http://opentracing.io)
 
-## Usage & Installation
+## Installation
 
-The instana package will automatically collect metrics and distributed traces from your Python processes.  Just install and go.
+None
 
-`pip install instana` into the virtual-env or container ([hosted on pypi](https://pypi.python.org/pypi/instana))
+_Instana automatically instruments your Python web servers automatically.  No user steps are required.  To configure which Python processes this applies to, see the [Configuration page](https://docs.instana.io/ecosystem/python/configuration/#general)._
 
-The Instana package can then be activated _without any code changes required_ by setting the following environment variable for your Python application:
+##  Manual Installation
 
-    export AUTOWRAPT_BOOTSTRAP=instana
+If you wish to manually instrument your applications you can install the package with the following into the virtualenv, pipenv or container ([hosted on pypi](https://pypi.python.org/pypi/instana)):
 
-alternatively, if you prefer the manual method, simply import the `instana` package inside of your Python application:
+    pip install instana
 
-    import instana
+or to alternatively update an existing installation:
 
-See our detailed [Installation document](INSTALLATION.md) for additional information covering Django, Flask, End-user Monitoring (EUM) and more.
+    pip install -U instana
 
-## OpenTracing
+### Activating Without Code Changes
 
-This Python package supports [OpenTracing](http://opentracing.io/).  When using this package, the OpenTracing tracer (`opentracing.tracer`) is automatically set to the `InstanaTracer`.
+The Instana package can then be activated _without any code changes required_ by setting the following environment variable for your Python application:
 
-```Python
-import opentracing
+    export AUTOWRAPT_BOOTSTRAP=instana
+
+This will cause the Instana Python package to automatically instrument your Python application.  Once it finds the Instana host agent, it will begin to report Python metrics and distributed traces.
 
-with opentracing.tracer.start_active_span('asteroid 💫') as pscope:
-    pscope.span.set_tag(ext.COMPONENT, "Python simple example app")
-    pscope.span.set_tag(ext.SPAN_KIND, ext.SPAN_KIND_RPC_SERVER)
-    pscope.span.set_tag(ext.PEER_HOSTNAME, "localhost")
-    pscope.span.set_tag(ext.HTTP_URL, "/python/simple/one")
-    pscope.span.set_tag(ext.HTTP_METHOD, "GET")
-    pscope.span.set_tag(ext.HTTP_STATUS_CODE, 200)
-    pscope.span.log_kv({"foo": "bar"})
-    # ... work ...
+### Activating via Import
 
-    with opentracing.tracer.start_active_span('spacedust 🌚', child_of=pscope.span) as cscope:
-        cscope.span.set_tag(ext.SPAN_KIND, ext.SPAN_KIND_RPC_CLIENT)
-        cscope.span.set_tag(ext.PEER_HOSTNAME, "localhost")
-        cscope.span.set_tag(ext.HTTP_URL, "/python/simple/two")
-        cscope.span.set_tag(ext.HTTP_METHOD, "POST")
-        cscope.span.set_tag(ext.HTTP_STATUS_CODE, 204)
-        cscope.span.set_baggage_item("someBaggage", "someValue")
-        # ... work ...
-```
+Alternatively, if you prefer the really manual method, simply import the `instana` package inside of your Python application:
 
-## Configuration
+    import instana
 
-For details on how to configure the Instana Python package, see [Configuration.md](https://github.com/instana/python-sensor/blob/master/Configuration.md)
+See also our detailed [Installation document](https://docs.instana.io/ecosystem/python/installation) for additional information covering Django, Flask, End-user Monitoring (EUM) and more.
 
 ## Documentation