diff --git a/.github/workflows/build-docs.yml b/.github/workflows/build-docs.yml
index df868344..fc3adff9 100644
--- a/.github/workflows/build-docs.yml
+++ b/.github/workflows/build-docs.yml
@@ -23,7 +23,7 @@ jobs:
         # Or use mhausenblas/mkdocs-deploy-gh-pages@nomaterial to build without the mkdocs-material theme
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          EXTRA_PACKAGES: build-base pygments
           #CUSTOM_DOMAIN: optionaldomain.com
           #CONFIG_FILE: folder/mkdocs.yml
-          #EXTRA_PACKAGES: build-base
           # GITHUB_DOMAIN: github.myenterprise.com
diff --git a/.gitignore b/.gitignore
index 9eb7b2db..8f9ffe82 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,4 +5,6 @@ vendor/
 .php-cs-fixer.cache
 phpunit.xml
 .vscode/
-phpstan.neon
\ No newline at end of file
+phpstan.neon
+# mkdocs
+site
\ No newline at end of file
diff --git a/README.md b/README.md
index c9d010fd..bb3ac6eb 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,9 @@
 # feed-io
 
 [![Packagist](https://img.shields.io/packagist/v/php-feed-io/feed-io.svg)](https://packagist.org/packages/php-feed-io/feed-io)
+[![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://php-feed-io.github.io/feed-io/)
+
+**📖 [Read the full documentation](https://php-feed-io.github.io/feed-io/)**
 
 [feed-io](https://github.com/php-feed-io/feed-io) is a PHP library built to consume and serve news feeds. It features:
 
diff --git a/doc/specifications-support.md b/docs/specifications-support.md
similarity index 98%
rename from doc/specifications-support.md
rename to docs/specifications-support.md
index 6a1d63b8..eb07deac 100644
--- a/doc/specifications-support.md
+++ b/docs/specifications-support.md
@@ -4,7 +4,7 @@ This document explains which attributes are supported by feed-io and how to acce
 
 ## top level document : feed (atom) / channel (rss) / top-level (json)
 
-interface : FeedInterface
+**interface : FeedInterface**
 
 | atom            | rss                     | json          | getter          | setter          |
 | --------------- | ----------------------- | ------------- | --------------- | --------------- |
@@ -36,7 +36,7 @@ interface : FeedInterface
 
 ## entry (atom) / item (rss) / item (json)
 
-Interface : ItemInterface
+**Interface : ItemInterface**
 
 | atom                | rss         | json                        | getter          | setter          |
 | ------------------- | ----------- | --------------------------- | --------------- | --------------- |
diff --git a/UPGRADE-3.0.md b/docs/upgrades/UPGRADE-3.0.md
similarity index 90%
rename from UPGRADE-3.0.md
rename to docs/upgrades/UPGRADE-3.0.md
index 48dc61ab..f1c26a51 100644
--- a/UPGRADE-3.0.md
+++ b/docs/upgrades/UPGRADE-3.0.md
@@ -7,6 +7,8 @@ In version 2.x FeedIo::format() returned a DomDocument. Now that feed-io support
 Before :
 
 ```php
+<?php
+
 // Feed creation
 $feed = new \FeedIo\Feed();
 
@@ -27,6 +29,8 @@ Now you get the string :
 
 
 ```php
+<?php
+
 // Feed creation
 $feed = new \FeedIo\Feed();
 
@@ -43,6 +47,8 @@ Instead of a DomDocument.
 Before :
 
 ```php
+<?php
+
 $feedIo = \FeedIo\Factory::create()->getFeedIo();
 
 $result = $feedIo->read('http://php.net/feed.atom');
@@ -54,6 +60,8 @@ $dom = $result->getDocument();
 After :
 
 ```php
+<?php
+
 $feedIo = \FeedIo\Factory::create()->getFeedIo();
 
 $result = $feedIo->read('http://php.net/feed.atom');
@@ -62,7 +70,7 @@ $dom = $result->getDocument()->getDOMDocument();
 
 ```
 
-This is because Result::getDocument()'s return value is a wrapper for both XML and JSON streams.
+This is because `Result::getDocument()`'s return value is a wrapper for both XML and JSON streams.
 
 ### That's it
 
diff --git a/UPGRADE-4.0.md b/docs/upgrades/UPGRADE-4.0.md
similarity index 77%
rename from UPGRADE-4.0.md
rename to docs/upgrades/UPGRADE-4.0.md
index 21e7ce60..947fe700 100644
--- a/UPGRADE-4.0.md
+++ b/docs/upgrades/UPGRADE-4.0.md
@@ -6,18 +6,20 @@ The major change in version 4.0 is the full migration to PHP 7.1. It has an impa
 
 From now on, all types are explicits in method signatures. It has an impact on classes that implements :
 
- - \FeedIo\FeedInterface 
- - \FeedIo\Feed\ItemInterface
- - \FeedIo\Feed\NodeInterface
- - \FeedIo\Feed\ElementsAwareInterface
- - \FeedIo\Feed\Item\AuthorInterface
- - \FeedIo\Feed\Item\MediaInterface
- - \FeedIo\Feed\Node\CategoryInterface
- - \FeedIo\Feed\Node\ElementInterface
+ - `\FeedIo\FeedInterface`
+ - `\FeedIo\Feed\ItemInterface`
+ - `\FeedIo\Feed\NodeInterface`
+ - `\FeedIo\Feed\ElementsAwareInterface`
+ - `\FeedIo\Feed\Item\AuthorInterface`
+ - `\FeedIo\Feed\Item\MediaInterface`
+ - `\FeedIo\Feed\Node\CategoryInterface`
+ - `\FeedIo\Feed\Node\ElementInterface`
 
 For instance, `FeedIo\FeedInterface::setUrl($url)` becomes :
 
 ```php
+<?php
+
     /**
      * @param string $url
      * @return FeedInterface
@@ -27,6 +29,8 @@ For instance, `FeedIo\FeedInterface::setUrl($url)` becomes :
 As a consequence, you need to adapt any class that implements `FeedIo\FeedInterface` according to the new signature : 
 
 ```php
+<?php
+
     /**
      * @param string $url
      * @return FeedInterface
@@ -41,6 +45,8 @@ As a consequence, you need to adapt any class that implements `FeedIo\FeedInterf
 becomes : 
 
 ```php
+<?php
+
     /**
      * @param string $url
      * @return FeedInterface
diff --git a/UPGRADE-5.0.md b/docs/upgrades/UPGRADE-5.0.md
similarity index 100%
rename from UPGRADE-5.0.md
rename to docs/upgrades/UPGRADE-5.0.md
diff --git a/UPGRADE-6.0.md b/docs/upgrades/UPGRADE-6.0.md
similarity index 100%
rename from UPGRADE-6.0.md
rename to docs/upgrades/UPGRADE-6.0.md
diff --git a/mkdocs.yml b/mkdocs.yml
index 02dd78c5..f635106f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,7 +1,26 @@
 site_name: feed-io Documentation
 theme:
   name: material
+  features:
+    - content.code.copy
+
 
 nav:
   - Home: index.md
   - Code Quality: codecontributions.md
+  - Specification: specifications-support.md
+  - Upgrade:
+      - Upgrade to v3: upgrades/UPGRADE-3.0.md
+      - Upgrade to v4: upgrades/UPGRADE-4.0.md
+      - Upgrade to v5: upgrades/UPGRADE-5.0.md
+      - Upgrade to v6: upgrades/UPGRADE-6.0.md
+
+markdown_extensions:
+  - pymdownx.highlight:
+      use_pygments: true
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
\ No newline at end of file