diff --git a/README.md b/README.md
index a06ae9d..bf87dd3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
+Introduction
+============
+
+This is the Juju charm for [openstack/networking-generic-switch](https://git.openstack.org/cgit/openstack/networking-generic-switch).
+
+
 Getting started
 ===============
 
@@ -13,6 +19,15 @@ Generate a config ini file with switch configuration, similar to the one below:
     username = admin
     password = admin
 
+`[genericswitch]` blocks should follow the syntax described in [networking-generic-switch documentation](https://git.openstack.org/cgit/openstack/networking-generic-switch/tree/README.rst)
+
+
+Limitations
+===========
+
+Since neutron-api-genericswitch is not part of Ubuntu Cloud Archive, the package has to be built
+manually. Build instructions exist in a [manufacturer's specific extension](https://bitbucket.org/kci1/openstack-networking-generic-switch-fastpath) of generic switch.
+
 
 Deploying locally
 =================
@@ -20,5 +35,8 @@ Deploying locally
     cd src
     charm build
 
-    juju deploy $PATH_TO_CHECKOUT/src/builds/neutron-api-genericswitch --resource genericswitch-ml2-config=/full/path/to/switchconfig.ini
+    juju deploy $PATH_TO_CHECKOUT/src/builds/neutron-api-genericswitch \
+        --resource genericswitch-ml2-config=/full/path/to/switchconfig.ini \
+        --resource package=/full/path/to/neutron-api-genericswitch.deb
+        
     juju add-relation neutron-api neutron-api-genericswitch