Extract info from #7

Author: AD7six

README.md

@@ -5,6 +5,18 @@
 
 A utility for parsing and generating service DSNs
 
+## What is a DSN?
+
+A [data source name](http://en.wikipedia.org/wiki/Data_source_name) (DSN) is a string which defines how to connect to a service. Since it's a string, it's portable, not language or implementation dependent and anything capable of parsing it can know how to connect to the service it points at.
+
+## What does this repo do?
+
+This repo only provides a means of converting a DSN string into an array and vice versa.
+
+## Wrapper classes?
+
+When using a wrapper class, this repo provides an array _in the format expected_ by a particular consumer. So for example, the CakePHP wrapper classes provide arrays in the format the framework understands for a given DSN string.
+
 ## Basic usage
 
 The main dsn class implements a parse function which returns a dsn instance:
@@ -46,10 +58,6 @@ In all of the above cases, the returned instance is the "raw" dsn data:
 
 If the behavior of the raw dsn needs to be modified - use a wrapper implementation
 
-## Dsn Wrapper classes
-
-Wrapper classes allow developers to adapt a dsn to their own specific usage.
-
 ## References
 
 [12 factor applications][1]