diff --git a/docs/integrations.md b/docs/integrations.md
index da52decf..9a366e13 100644
--- a/docs/integrations.md
+++ b/docs/integrations.md
@@ -53,5 +53,5 @@ Technically, Fabric8 Maven Plugin processes the external docker-compose.yml file
 
 **Links:**
 
-- [Quickstart](/docs/maven-example.md)
-- [Documentation](https://maven.fabric8.io/#docker-compose)
+* [Quickstart](/maven-example)
+* [Documentation](https://maven.fabric8.io/#docker-compose)
diff --git a/docs/maven-example.md b/docs/maven-example.md
index a4b472c4..5165a62a 100644
--- a/docs/maven-example.md
+++ b/docs/maven-example.md
@@ -16,7 +16,7 @@ Let's deploy a Springboot Java application with Docker Compose file using Fabric
 - Linux or MacOS or Windows
 - JDK 1.7+ - [JDK Quick Installation Guide](http://openjdk.java.net/install/)
 - Maven 3.x+ - [Maven Installation Guide](http://www.baeldung.com/install-maven-on-windows-linux-mac)
-- Kompose - [Kompose Installation Guide](/docs/installation.md)
+- Kompose - [Kompose Installation Guide](/installation)
 
 **1. Clone the example project from GitHub**
 
diff --git a/docs/user-guide.md b/docs/user-guide.md
index fdefae57..9519106e 100644
--- a/docs/user-guide.md
+++ b/docs/user-guide.md
@@ -472,4 +472,4 @@ For Windows, there is also `credsStore` which is `wincred`. Technically it will
 
 Kompose supports Docker Compose versions: 1, 2 and 3. We have limited support on versions 2.1 and 3.2 due to their experimental nature.
 
-A full list on compatibility between all three versions is listed in our [conversion document](/docs/conversion.md) including a list of all incompatible Docker Compose keys.
+A full list on compatibility between all three versions is listed in our [conversion document](/conversion) including a list of all incompatible Docker Compose keys.