diff --git a/docs/architecture.md b/docs/architecture.md
index 5ab27e12..77d6d8ec 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -1,4 +1,4 @@
-# Kompose - Internal Design
+# Internal Design
 
 `kompose` has 3 stages: Loader, Transformer and Outputter. Each Stage should have well defined interface so it is easy to write new Loader, Transformer or Outputters and plug it in. Currently only Loader and Transformer interfaces are defined.
 
diff --git a/docs/conversion.md b/docs/conversion.md
index f5dbef78..8f3fad29 100644
--- a/docs/conversion.md
+++ b/docs/conversion.md
@@ -1,3 +1,5 @@
+# Conversion reference
+
 This document outlines all the conversion details regarding `docker-compose.yaml` values to Kubernetes / OpenShift artifacts.
 
 | Value | Version | Supported | K8s / OpenShift | Notes |
diff --git a/docs/setup.md b/docs/setup.md
index 76e3fc91..39b8ed28 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -1,4 +1,4 @@
-## Installation
+# Installation
 
 We have multiple ways to install Kompose. Our prefered method is downloading the binary from the latest GitHub release.