diff --git a/docs/.nojekyll b/docs/.nojekyll
deleted file mode 100644
index e69de29bb..000000000
diff --git a/docs/Gemfile b/docs/Gemfile
new file mode 100644
index 000000000..ec073cbec
--- /dev/null
+++ b/docs/Gemfile
@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gem "jekyll-rtd-theme"
+
+gem "github-pages", group: :jekyll_plugins
diff --git a/docs/Makefile b/docs/Makefile
new file mode 100644
index 000000000..e2d8beed5
--- /dev/null
+++ b/docs/Makefile
@@ -0,0 +1,14 @@
+default:
+	@bundle install
+
+update:
+	@bundle update
+
+clean:
+	@bundle exec jekyll clean
+
+server: clean
+	@bundle exec jekyll server
+
+build: clean
+	@bundle exec jekyll build --profile
diff --git a/docs/_config.yml b/docs/_config.yml
new file mode 100644
index 000000000..509c3b6ac
--- /dev/null
+++ b/docs/_config.yml
@@ -0,0 +1,28 @@
+title: mermaid
+lang: en
+description: Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.
+
+theme: jekyll-rtd-theme
+# remote_theme: rundocs/jekyll-rtd-theme
+
+sass:
+  style: compressed
+
+copyright:
+  revision: true
+
+edit: true
+addons_branch: true
+
+addons:
+  - github
+  - i18n
+  - analytics
+
+readme_index:
+  with_frontmatter: true
+
+exclude:
+  - Makefile
+  - Gemfile
+  - Gemfile.lock