@@ -281,7 +281,10 @@ with the following alterations:
 ---
 ### Customization
 
-Feign has several aspects that can be customized.  For simple cases, you can use `Feign.builder()` to construct an API interface with your custom components.  For example:
+Feign has several aspects that can be customized.  
+For simple cases, you can use `Feign.builder()` to construct an API interface with your custom components.<br>
+For request setting, you can use `options(Request.Options options)` on `target()` to set connectTimeout, connectTimeoutUnit, readTimeout, readTimeoutUnit, followRedirects.<br>
+For example:
 
 ```java
 interface Bank {
@@ -291,8 +294,9 @@ interface Bank {
 
 public class BankService {
   public static void main(String[] args) {
-    Bank bank = Feign.builder().decoder(
-        new AccountDecoder())
+    Bank bank = Feign.builder()
+        .decoder(new AccountDecoder())
+        .options(new Request.Options(10, TimeUnit.SECONDS, 60, TimeUnit.SECONDS, true))
         .target(Bank.class, "https://api.examplebank.com");
   }
 }
 
@@ -15,6 +15,7 @@
 
 import java.io.IOException;
 import java.util.List;
+import java.util.concurrent.TimeUnit;
 import java.util.stream.Collectors;
 import feign.*;
 import feign.codec.Decoder;
@@ -85,6 +86,7 @@ static GitHub connect() {
                 "Authorization",
                 "token 383f1c1b474d8f05a21e7964976ab0d403fee071");
           })
+          .options(new Request.Options(10, TimeUnit.SECONDS, 60, TimeUnit.SECONDS, true))
           .target(GitHub.class, "https://api.github.com");
     }
   }
 
@@ -20,10 +20,8 @@
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.Iterator;
-import feign.Feign;
-import feign.Logger;
-import feign.Param;
-import feign.RequestLine;
+import java.util.concurrent.TimeUnit;
+import feign.*;
 import feign.gson.GsonDecoder;
 
 public class WikipediaExample {
@@ -61,6 +59,7 @@ public static void main(String... args) throws InterruptedException {
         .decoder(new GsonDecoder(gson))
         .logger(new Logger.ErrorLogger())
         .logLevel(Logger.Level.BASIC)
+        .options(new Request.Options(10, TimeUnit.SECONDS, 60, TimeUnit.SECONDS, true))
         .target(Wikipedia.class, "https://en.wikipedia.org");
 
     System.out.println("Let's search for PTAL!");
Original file line number	Diff line number	Diff line change
`@@ -15,6 +15,7 @@`
`15`	`15`
`16`	`16`	`import java.io.IOException;`
`17`	`17`	`import java.util.List;`
	`18`	`+import java.util.concurrent.TimeUnit;`
`18`	`19`	`import java.util.stream.Collectors;`
`19`	`20`	`import feign.*;`
`20`	`21`	`import feign.codec.Decoder;`
`@@ -85,6 +86,7 @@ static GitHub connect() {`
`85`	`86`	`"Authorization",`
`86`	`87`	`"token 383f1c1b474d8f05a21e7964976ab0d403fee071");`
`87`	`88`	`})`
	`89`	`+ .options(new Request.Options(10, TimeUnit.SECONDS, 60, TimeUnit.SECONDS, true))`
`88`	`90`	`.target(GitHub.class, "https://api.github.com");`
`89`	`91`	`}`
`90`	`92`	`}`