diff --git a/README.md b/README.md
index 43da064..addcf61 100644
--- a/README.md
+++ b/README.md
@@ -20,5 +20,9 @@
 To install from the local `docker` daemon in minikube:
 
 ```bash
-helm install -n hippie xos-services/hippie-oss/ -f examples/image-tag-candidate.yaml -f examples/imagePullPolicy-IfNotPresent.yaml
-```
\ No newline at end of file
+helm -f examples/image-tag-candidate.yaml -f examples/imagePullPolicy-IfNotPresent.yaml
+```
+
+## Configure this service
+
+To get this service to work, you'll need to push the TOSCA in `samples/oss-service.yaml`
\ No newline at end of file
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000..addcf61
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,28 @@
+# Hippie OSS 
+
+This service is intended to be an example implementation of a service that integrates XOS with an external OSS system.
+As the name suggests this service will be very welcoming and validate any ONU that is connected to the system.
+
+Peace and Love
+
+> NOTE: This service depends on RCORDSubscriber so make sure that the `rcord-synchronizer` is running
+
+## How to install this service
+
+Make sure you have `xos-core`, `rcord-lite` and `kafka` running.
+
+To install from master:
+
+```bash
+helm install -n hippie xos-services/hippie-oss/
+```
+
+To install from the local `docker` daemon in minikube:
+
+```bash
+helm -f examples/image-tag-candidate.yaml -f examples/imagePullPolicy-IfNotPresent.yaml
+```
+
+## Configure this service
+
+To get this service to work, you'll need to push the TOSCA in `samples/oss-service.yaml`
\ No newline at end of file