Updated documents

Author: piyush-garg

docs/integrations.md

@@ -34,12 +34,10 @@ __Link:__ [https://github.com/chouseknecht/kompose-install-role](https://github.
 
 ### Fabric8 Maven Plugin by Red Hat
 
-__Description:__  "To bring docker-compose based Java application to Kubernetes/Openshift Cluster using Maven Plugin"
+__Description:__  "The fabric8-maven-plugin is used to bring your Java applications onto Kubernetes or Openshift. The main task of this plugin is to build Docker Images and generate Kubernetes or  Openshift resource descriptors. A docker-compose configuration is one of the method to bring up docker compose deployments on a Kubernetes/Openshift cluster. Fabric8-maven Plugin processes the external docker-compose file and generates Kubernetes/Openshift resources using Kompose."
 
 __Links:__
 
-* [Introduction](https://maven.fabric8.io/#introduction)
+* [Quickstart](http://kompose.io/maven-example/)
 
-* [Maven-Configuration](https://maven.fabric8.io/#configuration)
-          
-* [Example](https://maven.fabric8.io/#docker-compose)
+* [Documentation](https://maven.fabric8.io/)

docs/maven-example.md

@@ -0,0 +1,56 @@
+# Fabric8 Maven Plugin + Kompose:
+
+Lets deploy a Springboot Java application with Docker Compose file using fabric8 maven plugin to Kubernetes/Openshift.
+
+__1. Clone the example project from github__
+```bash
+$ git clone https://github.com/piyush1594/Kompose-Example.git
+```
+Navigate (cd) to `Kompose-Example` directory.
+
+__2. Install the kompose through maven plugin__ 
+```
+$ mvn fabric8:install
+```
+This command installs the `kompose` and other binaries on the host.
+
+
+__3. Add the fabric8 maven plugin to project__ 
+```
+$ mvn io.fabric8:fabric8-maven-plugin:3.5.28:setup
+```
+This command adds the fabric8 maven plugin to `pom.xml` of project. 
+
+__4. Configure the fabric8 maven plugin to use Docker Compose file__
+```
+<plugin>
+  <groupId>io.fabric8</groupId>
+  <artifactId>fabric8-maven-plugin</artifactId>
+
+  <!-- ... -->
+
+  <configuration>
+    <composeFile>path for docker compose file</composeFile>
+  </configuration>
+
+  <executions>
+    <execution>
+      <goals>
+        <goal>resource</goal>
+        <goal>build</goal>
+      </goals>
+    </execution>
+  </executions>
+</plugin>
+```
+Add the `<configuration>` and `<executions>` sections to `pom.xml` as shown in above `pom.xml` snippet. Update the `<composeFile>` to provide the relative path of Docker Compose file from `pom.xml`
+
+__5. Deploy application on Kubernetes/OpenShift__
+
+ Make sure that Kubernetes/OpenShift cluster or Minikube/MiniShift is running.
+
+```bash
+$ mvn fabric8:deploy  
+```
+
+Now that your service has been deployed, let's access it by querying `pod`, `service` from Kubernetes/OpenShift.