diff --git a/docs/branching_strategies.md b/docs/branching_strategies.md
index 152188e..01ca734 100644
--- a/docs/branching_strategies.md
+++ b/docs/branching_strategies.md
@@ -1,4 +1,4 @@
-# branching strategies
+# branching
 
 ---
 
diff --git a/docs/common_commands.md b/docs/common_commands.md
index 74839a6..48b174d 100644
--- a/docs/common_commands.md
+++ b/docs/common_commands.md
@@ -1,4 +1,4 @@
-# common git commands
+# common commands
 
 These are commands and options that I use frequently. See the linked documentation for more options and information.
 
diff --git a/docs/glossary.md b/docs/glossary.md
index 2cce947..4947850 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -1,4 +1,4 @@
-# git glossary
+# glossary
 
 > [source (git-scm.com)](https://git-scm.com/book/en/v2) (unless otherwise noted)
 
diff --git a/docs/ssh_setup.md b/docs/ssh_setup.md
index a1a25d2..ea48c93 100644
--- a/docs/ssh_setup.md
+++ b/docs/ssh_setup.md
@@ -1,4 +1,4 @@
-# ssh key setup for git
+# ssh key setup
 
 ---
 
diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
deleted file mode 100644
index 38e0d3c..0000000
--- a/docs/troubleshooting.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# troubleshooting
-
----
-
-
-ssh warnings remote key
-
-missing branches
-
-warnings
-
-line endings
-
-pull request flow
-
-ui flow
-
diff --git a/mkdocs.yml b/mkdocs.yml
index 765e47a..8ee5138 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -1,2 +1,7 @@
 site_name: learngit
 theme: cyborg
+repo_url: https://github.com/benharri/learngit
+edit_uri: blob/master/docs/
+markdown_extensions:
+    - toc:
+        permalink: True