Restructure README

Author: edenhill

README.md

@@ -111,26 +111,27 @@ c.close()
 See [examples](examples) for more examples.
 
 
-Broker Compatibility
-====================
-The Python client (as well as the underlying C library librdkafka) supports
-all broker versions >= 0.8.
-But due to the nature of the Kafka protocol in broker versions 0.8 and 0.9 it
-is not safe for a client to assume what protocol version is actually supported
-by the broker, thus you will need to hint the Python client what protocol
-version it may use. This is done through two configuration settings:
+Install
+=======
 
- * `broker.version.fallback=YOUR_BROKER_VERSION` (default 0.9.0.1)
- * `api.version.request=true|false` (default true)
+**Install self-contained binary wheels for OSX and Linux from PyPi:**
 
-When using a Kafka 0.10 broker or later you don't need to do anything
-(`api.version.request=true` is the default).
-If you use Kafka broker 0.9 or 0.8 you must set `api.version.request=false`
-and set `broker.version.fallback` to your broker version,
-e.g `broker.version.fallback=0.9.0.1`.
+    $ pip install confluent-kafka
 
-More info here:
-https://github.com/edenhill/librdkafka/wiki/Broker-version-compatibility
+**Install AvroProducer and AvroConsumer:**
+
+    $ pip install confluent-kafka[avro]
+
+**Install from source from PyPi** *(requires librdkafka + dependencies to be installed separately)*:
+
+    $ pip install --no-binary :all: confluent-kafka
+
+**Install from source directory:**
+
+    $ pip install .
+
+    # for AvroProducer or AvroConsumer
+    $ pip install .[avro]
 
 
 Prerequisites
@@ -139,7 +140,7 @@ Prerequisites
  * Python >= 2.7 or Python 3.x
  * ([librdkafka](https://github.com/edenhill/librdkafka) >= 0.9.2)
 
-The latest version of librdkafka is embedded in the OSX and manylinux wheels,
+The latest version of librdkafka is embedded in the OSX and Linux wheels,
 for other platforms or when a specific version of librdkafka is desired, follow these guidelines:
 
  * For **Debian/Ubuntu** based systems, add the Confluent APT repository and then do `sudo apt-get install librdkafka-dev python-dev`:
@@ -150,30 +151,32 @@ http://docs.confluent.io/current/installation.html#rpm-packages-via-yum
 
  * On **OSX**, use **homebrew** and do `sudo brew install librdkafka`
 
-**NOTE:** The pre-built manylinux wheels do NOT contain SASL Kerberos support. If you need SASL Kerberos support you must install librdkafka and its dependencies using the above repositories and then build confluent-kafka from source using the instructions below.
+**NOTE:** The pre-built Linux wheels do NOT contain SASL Kerberos support. If you need SASL Kerberos support you must install librdkafka and its dependencies using the above repositories and then build confluent-kafka from source using the instructions below.
 
 
-Install
-=======
-
-**Install self-contained binary wheels for OSX and Linux from PyPi:**
-
-    $ pip install confluent-kafka
-
-**Install AvroProducer and AvroConsumer:**
 
-    $ pip install confluent-kafka[avro]
+Broker Compatibility
+====================
+The Python client (as well as the underlying C library librdkafka) supports
+all broker versions >= 0.8.
+But due to the nature of the Kafka protocol in broker versions 0.8 and 0.9 it
+is not safe for a client to assume what protocol version is actually supported
+by the broker, thus you will need to hint the Python client what protocol
+version it may use. This is done through two configuration settings:
 
-**Install from source from PyPi** *(requires librdkafka + dependencies to be installed separately)*:
+ * `broker.version.fallback=YOUR_BROKER_VERSION` (default 0.9.0.1)
+ * `api.version.request=true|false` (default true)
 
-    $ pip install --no-binary :all: confluent-kafka
+When using a Kafka 0.10 broker or later you don't need to do anything
+(`api.version.request=true` is the default).
+If you use Kafka broker 0.9 or 0.8 you must set `api.version.request=false`
+and set `broker.version.fallback` to your broker version,
+e.g `broker.version.fallback=0.9.0.1`.
 
-**Install from source directory:**
+More info here:
+https://github.com/edenhill/librdkafka/wiki/Broker-version-compatibility
 
-    $ pip install .
 
-    # for AvroProducer or AvroConsumer
-    $ pip install .[avro]
 
 
 Build