diff --git a/_docs/upgrade.md b/_docs/upgrade.md
index f446cd2..ea5df97 100644
--- a/_docs/upgrade.md
+++ b/_docs/upgrade.md
@@ -4,7 +4,11 @@ toc:
 nav: 5
 ---
 
+## Upgrade
+
 **ToDo:** Very short description about how to upgrade
 
 For more information about what has changed with Pico 1.0 and a step-by-step
-upgrade tutorial please refer to the [upgrade page]({{ site.base_url}}/upgrade.html).
+upgrade tutorial, please refer to the [upgrade page]({{ site.base_url}}/upgrade.html).
+
+---
diff --git a/upgrade.md b/upgrade.md
index e089fed..f2214ae 100644
--- a/upgrade.md
+++ b/upgrade.md
@@ -1,7 +1,8 @@
 ---
 layout: simple
 title: Upgrade
-headline: Upgrade Pico 0.8/0.9 to Pico 1.0
+headline: Upgrade Pico 0.8 and 0.9 to Pico 1.0
+description: Quick links: [What's new](#whats-new) | [How to upgrade?](#how-to-upgrade)
 ---
 
 ## What's new?