diff --git a/.travis.yml b/.travis.yml
index 8d10a43f007..ebff7d8b01b 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -12,12 +12,15 @@ build: &rust_build
         - rustup component add rust-src
         - cargo test --no-run  # let's measure compile time separately
         - cargo test
+        - cargo doc --all --no-deps
     env:
         - RUSTFLAGS="-D warnings", CARGO_INCREMENTAL=0
 
 matrix:
     include:
         - os: linux
+          before_script:
+              - DEPLOY_DOCS=1
           <<: *rust_build
         - language: node_js
           node_js: node
@@ -43,3 +46,14 @@ branches:
         - staging
         - master
         - trying
+
+deploy:
+    provider: pages
+    skip-cleanup: true
+    github-token: $DOCS_TOKEN  # Set in the settings page of your repository, as a secure variable
+    keep-history: true
+    local-dir: target/doc
+    branch: gh-pages
+    on:
+        branch: master
+        condition: $DEPLOY_DOCS = 1
diff --git a/README.md b/README.md
index 3a0c9dee163..7c81413d935 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
 # Rust Analyzer
 
 [![Build Status](https://travis-ci.org/rust-analyzer/rust-analyzer.svg?branch=master)](https://travis-ci.org/rust-analyzer/rust-analyzer)
+[![Master docs](https://img.shields.io/badge/docs-master-blue.svg)](https://rust-analyzer.github.io/rust-analyzer/ra_ide_api/index.html)
 
 Rust Analyzer is an **experimental** modular compiler frontend for the Rust
 language. It is a part of a larger rls-2.0 effort to create excellent IDE