diff --git a/README.md b/README.md
index e865a2c55..cf8e7d3b8 100644
--- a/README.md
+++ b/README.md
@@ -36,8 +36,13 @@ See the [install instructions](/docs/install.md)
 
 ## Quick Start
 
-- [Documentation](/docs)
+- [Documentation](https://cosmos.network/docs/)
 - [Examples](/examples)
+- [Cosmos Hub Specification](https://cosmos.network/docs/spec/)
+<!---
+uncomment once the godocs improve
+- [Godocs for API referrence](https://godoc.org/github.com/cosmos/cosmos-sdk)
+-->
 
 ## Disambiguation