From 3ecea5b050a70d0c8846613ec14929918439166c Mon Sep 17 00:00:00 2001
From: Spencer Gibb <spencer@gibb.us>
Date: Wed, 2 Mar 2016 19:02:43 -0700
Subject: [PATCH] Document @Primary for plain RestTemplate beans.

fixes gh-60
---
 docs/src/main/asciidoc/spring-cloud-commons.adoc | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/docs/src/main/asciidoc/spring-cloud-commons.adoc b/docs/src/main/asciidoc/spring-cloud-commons.adoc
index a7395524..6c808cc7 100644
--- a/docs/src/main/asciidoc/spring-cloud-commons.adoc
+++ b/docs/src/main/asciidoc/spring-cloud-commons.adoc
@@ -315,11 +315,23 @@ for details of how the `RestTemplate` is set up.
 === Multiple RestTemplate objects
 
 If you want a `RestTemplate` that is not load balanced, create a `RestTemplate`
-bean  and inject it as normal.  To access the load balanced `RestTemplate use
-the provided `@LoadBalanced` `Qualifier`:
+bean and inject it as normal.  To access the load balanced `RestTemplate use
+the provided `@LoadBalanced` `Qualifier`.
+
+IMPORTANT: Notice the `@Primary` annotation on the plain `RestTemplate` declaration.
 
 [source,java,indent=0]
 ----
+@Configuration
+public class MyConfiguration {
+
+    @Primary
+    @Bean
+    RestTemplate restTemplate() {
+        return new RestTemplate();
+    }
+}
+
 public class MyClass {
     @Autowired
     private RestTemplate restTemplate;