diff --git a/README.md b/README.md
index 336cbbe..e6b7fab 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Corten
 
-Corten is a stack-based virtual machine written in Rust as a hobby. It's based on the [Iridium 1](spec.md#Iridium) architecture from Fletcher Haynes's [So you want to build a language VM](https://blog.subnetzero.io/post/building-language-vm-part-01/).
+Corten is a stack-based virtual machine written in Rust as a hobby. It's based on the [Iridium 1](docs/spec.md#Iridium) architecture from Fletcher Haynes's [So you want to build a language VM](https://blog.subnetzero.io/post/building-language-vm-part-01/).
 
 ## Build Status
 
diff --git a/docs/README.md b/docs/README.md
index d38a4c8..e33b8b7 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,7 +1,11 @@
-# Corten
+# Welcome
 
 Corten is a stack-based virtual machine written in Rust as a hobby. It's based on the [Iridium 1](spec.md#Iridium) architecture from Fletcher Haynes's [So you want to build a language VM](https://blog.subnetzero.io/post/building-language-vm-part-01/).
 
+## Specifications
+
+See [specifications](spec.md) page.
+
 ## Build Status
 
 | Service   | Status                                                                                                                                    |