diff --git a/docs/_docs/continuous-integration.md b/docs/_docs/continuous-integration.md
deleted file mode 100644
index 79477645..00000000
--- a/docs/_docs/continuous-integration.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-title: Continuous Integration
----
-
-Continuous Integration (CI) enables you to publish your Jekyll generated website with confidence by automating the quality assurance and deployment processes. You can quickly get started using CI with one of the providers below:
-
-
diff --git a/docs/_docs/continuous-integration/circleci.md b/docs/_docs/continuous-integration/circleci.md
index ccd2d933..fede484a 100644
--- a/docs/_docs/continuous-integration/circleci.md
+++ b/docs/_docs/continuous-integration/circleci.md
@@ -8,7 +8,7 @@ Building, testing, and deploying your Jekyll-generated website can quickly be do
[1]: https://github.com/
[2]: https://bitbucket.org/
-## Follow Your Project on CircleCI
+## 1. Follow Your Project on CircleCI
To start building your project on CircleCI, all you need to do is 'follow' your project from CircleCI's website:
@@ -19,7 +19,7 @@ To start building your project on CircleCI, all you need to do is 'follow' your
[3]: https://circleci.com/docs/configuration/
-## Dependencies
+## 2. Dependencies
The easiest way to manage dependencies for a Jekyll project (with or without CircleCI) is via a [Gemfile][4]. You'd want to have Jekyll, any Jekyll plugins, [HTML Proofer](#html-proofer), and any other gems that you are using in the `Gemfile`. Don't forget to version `Gemfile.lock` as well. Here's an example `Gemfile`:
@@ -36,7 +36,7 @@ gem 'html-proofer'
CircleCI detects when `Gemfile` is present is will automatically run `bundle install` for you in the `dependencies` phase.
-## Testing
+## 3. Testing
The most basic test that can be run is simply seeing if `jekyll build` actually works. This is a blocker, a dependency if you will, for other tests you might run on the generate site. So we'll run Jekyll, via Bundler, in the `dependencies` phase.
diff --git a/docs/_docs/continuous-integration/index.md b/docs/_docs/continuous-integration/index.md
new file mode 100644
index 00000000..14c5c749
--- /dev/null
+++ b/docs/_docs/continuous-integration/index.md
@@ -0,0 +1,9 @@
+---
+title: Continuous Integration
+permalink: /docs/continuous-integration/
+---
+
+Continuous Integration (CI) enables you to publish your Jekyll generated website with confidence by automating the quality assurance and deployment processes. You can quickly get started using CI with one of the providers below:
+
+* [Travis CI](travis-ci)
+* [CircleCI](circleci)
diff --git a/docs/_docs/continuous-integration/travis-ci.md b/docs/_docs/continuous-integration/travis-ci.md
index caff2f64..e76e1a60 100644
--- a/docs/_docs/continuous-integration/travis-ci.md
+++ b/docs/_docs/continuous-integration/travis-ci.md
@@ -4,10 +4,10 @@ title: "Travis CI"
You can easily test your website build against one or more versions of Ruby.
The following guide will show you how to set up a free build environment on
-[Travis][0], with [GitHub][1] integration for pull requests.
+[Travis][travis], with [GitHub][github] integration for pull requests.
-[0]: https://travis-ci.org/
-[1]: https://github.com/
+[travis]: https://travis-ci.org/
+[github]: https://github.com/
## 1. Enabling Travis and GitHub
@@ -26,7 +26,7 @@ The simplest test script simply runs `jekyll build` and ensures that Jekyll
doesn't fail to build the site. It doesn't check the resulting site, but it
does ensure things are built properly.
-When testing Jekyll output, there is no better tool than [html-proofer][2].
+When testing Jekyll output, there is no better tool than [html-proofer][html-proofer].
This tool checks your resulting site to ensure all links and images exist.
Utilize it either with the convenient `htmlproofer` command-line executable,
or write a Ruby script which utilizes the gem.
@@ -68,7 +68,7 @@ Options are given as a second argument to `.new`, and are encoded in a
symbol-keyed Ruby Hash. For more information about the configuration options,
check out `html-proofer`'s README file.
-[2]: https://github.com/gjtorikian/html-proofer
+[html-proofer]: https://github.com/gjtorikian/html-proofer
## 3. Configuring Your Travis Builds
@@ -91,7 +91,7 @@ Your `.travis.yml` file should look like this:
```yaml
language: ruby
rvm:
-- 2.2.5
+- 2.3.3
before_script:
- chmod +x ./script/cibuild # or do this locally and commit
@@ -124,7 +124,7 @@ access to Bundler, RubyGems, and a Ruby runtime.
```yaml
rvm:
-- 2.2.5
+- 2.3.3
```
RVM is a popular Ruby Version Manager (like rbenv, chruby, etc). This
diff --git a/docs/img/circleci-badge.svg b/docs/img/circleci-badge.svg
deleted file mode 100644
index 38658380..00000000
--- a/docs/img/circleci-badge.svg
+++ /dev/null
@@ -1,14 +0,0 @@
-
-
-
diff --git a/docs/img/travis-ci-badge.png b/docs/img/travis-ci-badge.png
deleted file mode 100644
index 94f255ec..00000000
Binary files a/docs/img/travis-ci-badge.png and /dev/null differ
- 
-