diff --git a/README.txt b/README.txt
index 7121c5b..322d8af 100644
--- a/README.txt
+++ b/README.txt
@@ -10,36 +10,39 @@ http://drupal.org/project/resp_img
 To submit bug reports and feature suggestions, or to track changes:
 http://drupal.org/project/issues/resp_img
 
--- REQUIREMENTS --
+-- DEPENDENCIES --
 
-none
+* field_formatter_settings
+* breakpoints
+* ctools
 
 -- INSTALLATION --
 
 * Install as usual, see http://drupal.org/node/70151 for further information.
+* Upgrade from 7.x version refer upgrade path documented on project page.
 
 -- TUTORIAL --
 
-Install a responsive theme like omega and create the following image styles at:
+* Install a responsive theme like omega and create the following image styles at:
 /admin/config/media/image-styles
 
 thumbnail_mobile: width 100px;
 thumbnail_narrow: width 150px;
 thumbnail_normal: width 220px;
 thumbnail_wide: width 300px;
-goto admin/config/media/resp_img and add the following
 
-add a suffix: _narrow - 500
-add a suffix: _normal - 720
-add a suffix: _wide - 900
-goto admin/config/media/resp_img/settings and enter _mobile for the default suffix
+* Configure breakpoints at admin/config/media/breakpoints
+Refer breakpoints project page: http://drupal.org/project/breakpoints to configure
 
-When using in combination with views choose your _mobile image style for all images
+default:(min-width: 0px)
+narrow:(min-width: 500px)
 
--- KNOWN PROBLEMS --
+* Configure groups at admin/config/media/breakpoints/groups/add
 
-If you enable 'Force resize' the module tries to resize everything, this works for plain images,
-but not for field_slideshow and some other jQuery slideshow like plugins.
-If you use barracuda/octopus (http://drupal.org/project/barracuda) you have to change the cache
-key, add $cookie_respimg to the fastcgi_cache_key directive inside nginx_advanced_include.conf
+Create a group for every active image type and select associated breakpoints
+eg. group for article image & images in blogs could be 2 different groups
 
+* Map breakpoints to images at admin/config/media/resp_img
+
+Associate the breakpoints to actual image cache sizes in this section for every group
+