diff --git a/docs/src/main/asciidoc/spring-cloud-connectors.adoc b/docs/src/main/asciidoc/spring-cloud-connectors.adoc
index 447b8a58..79e9d3a 100644
--- a/docs/src/main/asciidoc/spring-cloud-connectors.adoc
+++ b/docs/src/main/asciidoc/spring-cloud-connectors.adoc
@@ -395,36 +395,7 @@ See <<spring-cloud-cloud-foundry-connector.adoc#,Spring Cloud Cloud Foundry Conn
 
 == Spring Cloud Heroku Connector
 
-This connector will discover services that are bound to an application running in Heroku. It currently knows about:
-
-* PostgreSQL (Heroku)
-* MySQL (ClearDB)
-* Redis (Redis To Go, Redis Cloud, RedisGreen, openredis)
-* MongoDB (MongoLab, MongoHQ, MongoSoup)
-* RabbitMQ (CloudAMQP)
-
-=== Supporting Additional Providers for Existing Service Types
-
-To add support for a new provider of a service already listed above, add the provider's environment prefix to the list in `getEnvPrefixes()` on the `ServiceInfoCreator` class.
-
-=== Supporting New Service Types
-
-Extend `HerokuServiceInfoCreator` with a creator for <<_adding_service_discovery,your service's `ServiceInfo` class>>.
-
-Add the fully-qualified class name for your creator to `META-INF/service/org.springframework.cloud.heroku.HerokuServiceInfoCreator`.
-
-=== Limitations
-
-Unlike Cloud Foundry, Heroku exposes very little application information that is retrievable from within a running instance (for example, there is no good way to find the name of the application). If your application requires access to such information, you must make the information available through environment variables.
-
-To have a sensible application name available through `ApplicationInstanceInfo`, set the `SPRING_CLOUD_APP_NAME` environment variable.
-
-[source,term]
-----
-heroku config:add SPRING_CLOUD_APP_NAME=myappname --app myappname
-----
-
-If this environment variable is not set, the application name will be set to `<unknown>`.
+See <<spring-cloud-heroku-connector.adoc#,Spring Cloud Heroku Connector>>.
 
 == Spring Cloud local-configuration Connector
 
diff --git a/docs/src/main/asciidoc/spring-cloud-heroku-connector.adoc b/docs/src/main/asciidoc/spring-cloud-heroku-connector.adoc
new file mode 100644
index 0000000..0224664
--- /dev/null
+++ b/docs/src/main/asciidoc/spring-cloud-heroku-connector.adoc
@@ -0,0 +1,68 @@
+:github-tag: master
+:github-repo: spring-cloud/spring-cloud-connectors
+:github-raw: http://raw.github.com/{github-repo}/{github-tag}
+:github-code: http://github.com/{github-repo}/tree/{github-tag}
+:toc:
+:toclevels: 3
+
+= Spring Cloud Heroku Connector
+
+The Heroku Connector is part of the <<spring-cloud-connectors.adoc#,Spring Cloud Connectors>> project.
+
+This connector will discover services that are bound to an application running in Heroku.
+
+== Cloud Detection
+
+Coming soon... 
+
+== Service Detection
+
+Coming soon...
+
+=== Supported Services
+
+Coming soon...
+
+==== PostgreSQL (Heroku)
+
+Coming soon...
+
+==== MySQL (ClearDB)
+
+Coming soon...
+
+==== Redis (Redis To Go, Redis Cloud, RedisGreen, openredis)
+
+Coming soon...
+
+==== MongoDB (MongoLab, MongoHQ, MongoSoup)
+
+Coming soon...
+
+==== RabbitMQ (CloudAMQP)
+
+Coming soon...
+
+== Supporting Additional Providers for Existing Service Types
+
+To add support for a new provider of a service already listed above, add the provider's environment prefix to the list in `getEnvPrefixes()` on the `ServiceInfoCreator` class.
+
+== Supporting New Service Types
+
+Extend `HerokuServiceInfoCreator` with a creator for <<_adding_service_discovery,your service's `ServiceInfo` class>>.
+
+Add the fully-qualified class name for your creator to `META-INF/service/org.springframework.cloud.heroku.HerokuServiceInfoCreator`.
+
+== Limitations
+
+Unlike Cloud Foundry, Heroku exposes very little application information that is retrievable from within a running instance (for example, there is no good way to find the name of the application). If your application requires access to such information, you must make the information available through environment variables.
+
+To have a sensible application name available through `ApplicationInstanceInfo`, set the `SPRING_CLOUD_APP_NAME` environment variable.
+
+[source,term]
+----
+heroku config:add SPRING_CLOUD_APP_NAME=myappname --app myappname
+----
+
+If this environment variable is not set, the application name will be set to `<unknown>`.
+