some cleanup of the readme

README.rst

@@ -1,16 +1,26 @@
 python-redfish
 ==============
 
-This repository will be used to house the Redfish python library.  This library
-will be used to help Python developers communicate with the Redfish API
+This repository will be used to house the Redfish python library, a reference
+implementation to enable Python developers to communicate with the Redfish API
 (http://www.redfishspecification.org/).
 
+.. note:
+
+    The current Redfish specification revsion is 0.91 - anything and everything
+    in this library is subject to change until the DMTF ratifies the Redfish API
+    standard.
+
 Directory Structure
 -------------------
 
 This project follows the same convention as OpenStack projects, eg. using pbr
 for build and test automation.
 
+    examples/
+    tests/
+
+
 Requirements
 ------------
 
@@ -19,3 +29,12 @@ To use the enclosed examples, you will need Python 2.7
 SSL verification requiring server certificates be installed.  Parameters to
 relax the requirements are available in the library, but these configurations
 are discouraged due to security concerns.
+
+Further References
+------------------
+
+The data model documentation can be found here:
+  http://www.redfishspecification.org/redfish-data-model-and-schema/
+
+The overall protocol documentation can be found here:
+  http://www.redfishspecification.org/

docs/Redfish_API_Data_Model.md

@@ -1,2 +0,0 @@
-# Redfish: Data Model and Schema
-The data model documentation can be found [here](http://www.redfishspecification.org/redfish-data-model-and-schema/ "Redfish: Data Model and Schema").

docs/Redfish_Specification_Documentation.md

@@ -1,2 +0,0 @@
-# Redfish Specification
-The overall protocol documentation can be found [here](http://www.redfishspecification.org/ "Redfish Specification").

examples/__init__.py

@@ -0,0 +1 @@
+__author__ = 'deva'

examples/simple.py

@@ -0,0 +1,3 @@
+from redfish import connection
+
+server = connection