diff --git a/docs/modules/' b/docs/modules/'
new file mode 100644
index 0000000..e913403
--- /dev/null
+++ b/docs/modules/'
@@ -0,0 +1,46 @@
+= Quickstart
+Swarmlab
+:idprefix:
+:idseparator: -
+:!example-caption:
+:!table-caption:
+:page-pagination:
+  
+
+This is where your wondeful journey in the vast world of Swarmlab begins.
+
+== Senario 1
+
+* you are a *teacher* and want to prepare your lesson 
+** create exercises and examples
+** share them with your students
+* you are a *student* and want to try your newly acquired knowledge on some project
+* you are a *Developer* and would like to denug your application or a real world senario
+** you want to provide POC
+* you are a *user* and just want to try out stuff
+** you want to play around with examples but are too scared to do so on your system
+
+Well this is where you start!
+
+=== link:hybrid/start-labroom.html[start labroom]
+=== link:hybrid/start-storage.html[start storage]
+=== link:hybrid/start-microservices.html[start service]
+
+
+== Senario 2
+
+You have already completed senario 1 (using swarmlab or you own resources) and would now like to collaborate with others.
+
+* as a teacher you would like to share the lesson you have prepared and work on it throughout the semester
+* as a developer you want to coordinate with your team
+* as a student you want to communicate and cooperate with your friends
+
+Lets begin!
+
+=== create network
+=== invite
+=== share
+==== app
+==== volume
+
+
diff --git a/docs/modules/hybrid/pages/overview-hybrid.adoc b/docs/modules/hybrid/pages/overview-hybrid.adoc
index ddd7a44..d569fb1 100644
--- a/docs/modules/hybrid/pages/overview-hybrid.adoc
+++ b/docs/modules/hybrid/pages/overview-hybrid.adoc
@@ -8,10 +8,10 @@ Swarmlab
 
 This is the area where you will find the available *Instances* and run the desired one.
 
-== Labrooms
+== link:/swarmlab/docs/hybrid/start-labroom.html[Labrooms]
 
-== Storage
+== link:/swarmlab/docs/hybrid/start-storage.html[Storage]
 
-== MicroServices
+== link:/swarmlab/docs/hybrid/start-microservices.html[MicroServices]
 
 
diff --git a/docs/modules/hybrid/pages/overview.adoc b/docs/modules/hybrid/pages/overview.adoc
index 145f4e8..b40a6ff 100644
--- a/docs/modules/hybrid/pages/overview.adoc
+++ b/docs/modules/hybrid/pages/overview.adoc
@@ -9,7 +9,15 @@ Swarmlab
 This is the area where you will find the available *labrooms* and join the desired one.
 
 
-== Private/Local
-== Instanches
-== Hybrid/Public
+== link:/swarmlab/docs/hybrid/start-labroom.html[Private/Local]
+A labroom is a contained environment created to suit your unique needs.
+
+== link:/swarmlab/docs/hybrid/start-storage.html[Instances]
+If you would like to store data for your work we provide storage options.
+
+== link:/swarmlab/docs/hybrid/manage-instanches.html[Instances]
+This is the area where you can View and Manage your running Instances
+
 == Builders
+Build your own virtual machine using a fiendly environment and no code at all!
+Get started here.
diff --git a/docs/modules/quickstart/pages/overview.adoc b/docs/modules/quickstart/pages/overview.adoc
index dfeb954..315a4e9 100644
--- a/docs/modules/quickstart/pages/overview.adoc
+++ b/docs/modules/quickstart/pages/overview.adoc
@@ -22,9 +22,9 @@ This is where your wondeful journey in the vast world of Swarmlab begins.
 
 Well this is where you start!
 
-=== start service
-=== start storage 
-=== start labroom
+=== link:/swarmlab/docs/hybrid/start-labroom.html[start labroom]
+=== link:/swarmlab/docs/hybrid/start-storage.html[start storage]
+=== link:/swarmlab/docs/hybrid/start-microservices.html[start service]
 
 
 == Senario 2
@@ -37,10 +37,9 @@ You have already completed senario 1 (using swarmlab or you own resources) and w
 
 Lets begin!
 
-=== create network
-=== invite
-=== share
-==== app
-==== volume
+=== link:/swarmlab/docs/venus/deploy.html[create network]
+=== link:/swarmlab/docs/venus/join.html[invite/join]
+=== link:/swarmlab/docs/venus/share-volume.html[volumes]
+=== link:/swarmlab/docs/venus/share-app.html[apps]
 
 
diff --git a/docs/modules/venus/pages/overview-share.adoc b/docs/modules/venus/pages/overview-share.adoc
index 13ec10b..6ed01db 100644
--- a/docs/modules/venus/pages/overview-share.adoc
+++ b/docs/modules/venus/pages/overview-share.adoc
@@ -8,13 +8,11 @@ Swarmlab
   
 This is the area where you can share your apps or your volumes.
 
-== App
+== link:/swarmlab/docs/venus/share-app.html[App]
 
-This page is start
-
-== Volume
-
-This page is scale
+This is the area where we will guide you to share your app
 
+== link:/swarmlab/docs/venus/share-volume.html[Volume]
 
+This is the area where we will guide you to share and connect to volumes.
 
diff --git a/docs/modules/venus/pages/overview.adoc b/docs/modules/venus/pages/overview.adoc
index 1651fc4..740e773 100644
--- a/docs/modules/venus/pages/overview.adoc
+++ b/docs/modules/venus/pages/overview.adoc
@@ -12,14 +12,12 @@ share app/volume stous collaborators
 
 == Network
 
-* Join 
-* Deploy
+* link:/swarmlab/docs/venus/deploy.html[Deploy] 
+* link:/swarmlab/docs/venus/join.html[Join]
 
 == Share
 
-* App
-* Volume
-
-== Stats
+* link:/swarmlab/docs/venus/share-app.html[App]
+* link:/swarmlab/docs/venus/share-volume.html[Volume]
 
 
diff --git a/docs/modules/venus/pages/share-app.adoc b/docs/modules/venus/pages/share-app.adoc
index aa5c6f0..a2ce2fe 100644
--- a/docs/modules/venus/pages/share-app.adoc
+++ b/docs/modules/venus/pages/share-app.adoc
@@ -8,7 +8,7 @@ Swarmlab
 :experimental:
 
 
-This is the area where we will guide you to share you app
+This is the area where we will guide you to share your app
 
 == browse apps