diff --git a/README.rst b/README.rst
index 95c5581..66d227a 100644
--- a/README.rst
+++ b/README.rst
@@ -78,17 +78,16 @@ below:
 
 valence-api
 -----------
-A pecan based daemon to expose Valence REST APIs. The api service communicates
-to the controller through AMQP.
-
-valence-controller
---------------
-The controller implements all the handlers for valence-api. It reads requests
-from the AMQP queue, process it and send the reponse back to the caller.
+A python based daemon based on Flask framework to expose Valence REST APIs.
+The api service communicates to the PODM through REST interface using Redfish(TM) specification.
+For adding new api please refer https://github.com/openstack/valence/blob/master/doc/source/developer-guide/add_new_api.rst
 
 valence-ui
 --------
-valence-ui provides a GUI interface to invoke Valence APIs.
+valence-ui provides a Web based GUI interface that can be used to explore
+Rack Scale Design (RSD) artifacts and compose/disassemble nodes.
+valence-ui is implemented using Node.js runtime environment and hosted through apache.
+valence-ui makes us of React.js javascript libaray and invoke Valence REST APIs through ajax REST calls.
 
 ==========
 Features