diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
deleted file mode 100644
index 4d41f302..00000000
--- a/CONTRIBUTING.md
+++ /dev/null
@@ -1,15 +0,0 @@
-## How to contribute to guides.rubygems.org
-
-#### If you want to contribute to RubyGems itself, visit [the RubyGems Guides](http://guides.rubygems.org/contributing/)
-This guide just covers the details of contributing to the guides themselves.
-
-### Setting up a local development environment
-
-The guides are built with [Jekyll](https://github.com/jekyll/jekyll). To run the site locally, you'll first need to install Jekyll via `gem install jekyll`. Once installed, you can start the development server via `jekyll server` and point your browser to [http://localhost:4000](http://localhost:4000)
-
-### Things you can't update here!
-
-Most of the site can be modified directly in this repository. However, the files below are generated from the [RubyGems source](https://github.com/rubygems/rubygems). Any changes to them need to be updated there and will get applied here when the next RubyGems version is released.
-
-* command-reference.md
-* specification-reference.md
diff --git a/command-reference.md b/command-reference.md
index eb93db86..97abad2c 100644
--- a/command-reference.md
+++ b/command-reference.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Command Reference
-permalink: /command-reference
+url: /command-reference
 previous: /patterns
 next: /rubygems-org-api
 ---
diff --git a/contributing-to-rubygems.md b/contributing.md
similarity index 99%
rename from contributing-to-rubygems.md
rename to contributing.md
index 7359d31f..1097de2b 100644
--- a/contributing-to-rubygems.md
+++ b/contributing.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Contributing to RubyGems
-permalink: /contributing
+url: /contributing
 previous: /resources
 next: /faqs
 ---
diff --git a/faqs.md b/faqs.md
index 223ca524..cce17770 100644
--- a/faqs.md
+++ b/faqs.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Frequently Asked Questions
-permalink: /faqs
+url: /faqs
 previous: /contributing
 next: /plugins
 ---
diff --git a/gems-with-extensions.md b/gems-with-extensions.md
index 5f436f53..e9991b73 100644
--- a/gems-with-extensions.md
+++ b/gems-with-extensions.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Gems with Extensions
-permalink: /gems-with-extensions
+url: /gems-with-extensions
 previous: /make-your-own-gem
 next: /name-your-gem
 alias: /c-extensions
diff --git a/make-your-own-gem.md b/make-your-own-gem.md
index 58902363..b6082771 100644
--- a/make-your-own-gem.md
+++ b/make-your-own-gem.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Make your own gem
-permalink: /make-your-own-gem
+url: /make-your-own-gem
 previous: /what-is-a-gem
 next: /gems-with-extensions
 ---
diff --git a/name-your-gem.md b/name-your-gem.md
index 96621e01..ff7addeb 100644
--- a/name-your-gem.md
+++ b/name-your-gem.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Name your gem
-permalink: /name-your-gem
+url: /name-your-gem
 previous: /gems-with-extensions
 next: /publishing
 ---
diff --git a/patterns.md b/patterns.md
index 5f256cd3..cd15b454 100644
--- a/patterns.md
+++ b/patterns.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Patterns
-permalink: /patterns
+url: /patterns
 previous: /ssl-certificate-update
 next: /specification-reference
 ---
diff --git a/plugins.md b/plugins.md
index 38adfa85..dbff4286 100644
--- a/plugins.md
+++ b/plugins.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Plugins
-permalink: /plugins
+url: /plugins
 previous: /faqs
 next: /credits
 ---
diff --git a/publishing.md b/publishing.md
index 42597ef6..4450f687 100644
--- a/publishing.md
+++ b/publishing.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Publishing your gem
-permalink: /publishing
+url: /publishing
 previous: /name-your-gem
 next: /security
 ---
diff --git a/resources.md b/resources.md
index 2a9217a2..543c7639 100644
--- a/resources.md
+++ b/resources.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Resources
-permalink: /resources
+url: /resources
 previous: /run-your-own-gem-server
 next: /contributing
 ---
diff --git a/rubygems-basics.md b/rubygems-basics.md
index 4bf06862..6c18aa51 100644
--- a/rubygems-basics.md
+++ b/rubygems-basics.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: RubyGems Basics
-permalink: /rubygems-basics
+url: /rubygems-basics
 previous: /
 next: /what-is-a-gem
 ---
diff --git a/rubygems-org-api-v2.md b/rubygems-org-api-v2.md
index 55106111..477514e3 100644
--- a/rubygems-org-api-v2.md
+++ b/rubygems-org-api-v2.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: RubyGems.org API V2
-permalink: /rubygems-org-api-v2
+url: /rubygems-org-api-v2
 previous: /rubygems-org-api
 next: /run-your-own-gem-server
 ---
diff --git a/rubygems-org-api.md b/rubygems-org-api.md
index 72d64bad..9cf48afc 100644
--- a/rubygems-org-api.md
+++ b/rubygems-org-api.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: RubyGems.org API
-permalink: /rubygems-org-api
+url: /rubygems-org-api
 previous: /command-reference
 next: /rubygems-org-api-v2
 ---
diff --git a/run-your-own-gem-server.md b/run-your-own-gem-server.md
index 23c5e2d1..2433572b 100644
--- a/run-your-own-gem-server.md
+++ b/run-your-own-gem-server.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Run your own gem server
-permalink: /run-your-own-gem-server
+url: /run-your-own-gem-server
 previous: /rubygems-org-api-v2
 next: /resources
 ---
diff --git a/security.md b/security.md
index 9da4ca3a..3341f3e2 100644
--- a/security.md
+++ b/security.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Security
-permalink: /security
+url: /security
 previous: /publishing
 next: /ssl-certificate-update
 ---
diff --git a/specification-reference.md b/specification-reference.md
index 38f249bf..a090ef2b 100644
--- a/specification-reference.md
+++ b/specification-reference.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Specification Reference
-permalink: /specification-refence
+url: /specification-refence
 previous: /patterns
 next: /command-reference
 ---
diff --git a/ssl-certificate-update.md b/ssl-certificate-update.md
index 8dd88750..9f28e567 100644
--- a/ssl-certificate-update.md
+++ b/ssl-certificate-update.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: SSL Certificate Update
-permalink: /ssl-certificate-update
+url: /ssl-certificate-update
 previous: /security
 next: /patterns
 ---
diff --git a/what-is-a-gem.md b/what-is-a-gem.md
index bad8cce8..a487bfc6 100644
--- a/what-is-a-gem.md
+++ b/what-is-a-gem.md
@@ -1,7 +1,7 @@
 ---
 layout: default
 title: What is a gem?
-permalink: /what-is-a-gem
+url: /what-is-a-gem
 previous: /rubygems-basics
 next: /make-your-own-gem
 ---