diff --git a/CHANGELOG.md b/CHANGELOG.md
index e6fdb4d..ae3f0c2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+* fixed broken links in docs
+
 ### Added
 - Added Changelog to docs.
 
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
new file mode 100644
index 0000000..8583671
--- /dev/null
+++ b/docs/CONTRIBUTING.md
@@ -0,0 +1,7 @@
+---
+title: libzim Contribution
+---
+
+{%
+    include-markdown "../CONTRIBUTING.md"
+%}
\ No newline at end of file
diff --git a/docs/license.md b/docs/LICENSE.md
similarity index 100%
rename from docs/license.md
rename to docs/LICENSE.md
diff --git a/docs/index.md b/docs/index.md
index 2cadb0d..6cae110 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -4,4 +4,5 @@ title: libzim Documentation
 
 {%
     include-markdown "../README.md"
+    rewrite-relative-urls=false
 %}
diff --git a/mkdocs.yml b/mkdocs.yml
index d2a5da6..4de3f8a 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -13,7 +13,8 @@ nav:
   - Home: index.md
   - API Reference: api_reference/
   - Changelog: 'changelog.md'
-  - License: license.md
+  - Contributing: CONTRIBUTING.md
+  - License: LICENSE.md
 
 theme:
   name: material