From 68c67df67d56144044560face23e21aa8cbf82e2 Mon Sep 17 00:00:00 2001
From: Spencer Gibb <spencer@gibb.us>
Date: Tue, 8 Mar 2016 15:48:12 -0700
Subject: [PATCH] Update `RestTemplate` creation documentation.

---
 docs/src/main/asciidoc/spring-cloud-commons.adoc | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/docs/src/main/asciidoc/spring-cloud-commons.adoc b/docs/src/main/asciidoc/spring-cloud-commons.adoc
index 4265b7ee..61f20602 100644
--- a/docs/src/main/asciidoc/spring-cloud-commons.adoc
+++ b/docs/src/main/asciidoc/spring-cloud-commons.adoc
@@ -293,11 +293,22 @@ Patterns such as service discovery, load balancing and circuit breakers lend the
 
 === Spring RestTemplate as a Load Balancer Client
 
-You can use Ribbon indirectly via an autoconfigured `RestTemplate`
-when RestTemplate is on the classpath and a `LoadBalancerClient` bean is defined):
+`RestTemplate` can be automatically configured to use ribbon. To create a load balanced `RestTemplate` create a `RestTemplate` `@Bean` and use the `@LoadBalanced` qualifier.
+
+WARNING: A `RestTemplate` bean is no longer created via auto configuration. It must be created by individual applications.
 
 [source,java,indent=0]
 ----
+@Configuration
+public class MyConfiguration {
+
+    @LoadBalanced
+    @Bean
+    RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+}
+
 public class MyClass {
     @Autowired
     private RestTemplate restTemplate;