From 78d90e2ed09714b0f7473d453fe98150c853af0d Mon Sep 17 00:00:00 2001
From: Jordan Hall <jordan.hall@rapidweb.biz>
Date: Fri, 13 Jan 2017 17:15:48 +0000
Subject: [PATCH] Documentation and setting example requirement to 1.*

---
 README.md          | 46 ++++++++++++++++++++++++++++++++++++++++++++--
 test/composer.json |  2 +-
 2 files changed, 45 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 02b0958..b4c84ca 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,44 @@
-# php-dcom
-PHP Database Connection Object Manager
+# PHP DCOM
+
+The PHP DCOM (Database Connection Object Manager) is designed to allow easy management of 
+multiple database connection objects. It stores database connection details within a `.env`
+file in the root of your project.
+
+## Installation
+
+Simple run `composer require DivineOmega/php-dcom` to install.
+
+## Usage
+
+You need to create a `.env` file in the root of your project (alongside your 
+`composer.json` file). This will be used to store you database connection details,
+in the following format.
+
+```
+DCOM_MAIN_OBJECT_TYPE=mysqli
+DCOM_MAIN_DATABASE_TYPE=mysql
+
+DCOM_MAIN_DATABASE_HOST=localhost
+DCOM_MAIN_DATABASE_USERNAME=username
+DCOM_MAIN_DATABASE_PASSWORD=password
+DCOM_MAIN_DATABASE_NAME=testdb
+```
+
+You can then establish a connection to the database, as shown below. DCOM will
+ensure your application only uses a single connection to each database per request.
+
+```php
+require 'vendor/autoload.php';
+
+use \DivineOmega\DCOM\DCOM;
+
+$mysqli = DCOM::getConnection("main");
+```
+
+Note that the connection name passed to the `getConnection` method matches 
+what is defined in the `.env` file. You can therefore change this argument in
+order to manage and connect to multiple databases easily.
+
+## Example
+
+For an actual example of how to use PHP DCOM, see the [`test` directory](test/).
\ No newline at end of file
diff --git a/test/composer.json b/test/composer.json
index e1ccbb6..90c349d 100644
--- a/test/composer.json
+++ b/test/composer.json
@@ -1,6 +1,6 @@
 {
 
     "require": {
-        "DivineOmega/php-dcom": "dev-master"
+        "DivineOmega/php-dcom": "1.*"
     }
 }