diff --git a/README.md b/README.md
index 9438aec5c..0b2d630bc 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,5 @@
+<p align="center"><img src="src/docs/feign-logo.svg" alt="Feign logo" width="160"></p>
+
 # Feign simplifies the process of writing Java HTTP clients
 
 [![Join the chat at https://gitter.im/OpenFeign/feign](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/OpenFeign/feign?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
diff --git a/src/docs/feign-logo.svg b/src/docs/feign-logo.svg
new file mode 100644
index 000000000..30170e3b1
--- /dev/null
+++ b/src/docs/feign-logo.svg
@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+
+    Copyright © 2012 The Feign Authors (feign@commonhaus.dev)
+
+    Licensed under the Apache License, Version 2.0 (the "License");
+    you may not use this file except in compliance with the License.
+    You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing, software
+    distributed under the License is distributed on an "AS IS" BASIS,
+    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+    See the License for the specific language governing permissions and
+    limitations under the License.
+
+-->
+<svg xmlns="http://www.w3.org/2000/svg" width="323" height="271" viewBox="0 0 1292 1084">
+<defs>
+<linearGradient id="swirl" gradientUnits="userSpaceOnUse" x1="12920" y1="10840" x2="0" y2="0">
+<stop offset="0" stop-color="#5fd3f6"/>
+<stop offset="0.45" stop-color="#1f93e2"/>
+<stop offset="1" stop-color="#0848a6"/>
+</linearGradient>
+</defs>
+<g transform="translate(0.000000,1084.000000) scale(0.100000,-0.100000)"
+fill="url(#swirl)" stroke="none">
+<path d="M4925 10681 c-218 -5 -277 -9 -305 -22 -19 -9 -82 -22 -140 -29 -58
+-6 -159 -24 -225 -40 -66 -15 -140 -31 -165 -35 -25 -4 -61 -15 -80 -25 -52
+-26 -114 -41 -211 -50 -66 -6 -96 -14 -127 -34 -22 -14 -94 -43 -160 -65 -66
+-22 -142 -51 -169 -65 -26 -14 -122 -59 -211 -101 -90 -41 -178 -86 -195 -98
+-18 -13 -52 -31 -77 -41 -25 -9 -67 -30 -95 -46 -27 -16 -70 -39 -95 -50 -116
+-53 -176 -90 -265 -163 -16 -13 -68 -50 -115 -82 -47 -32 -98 -70 -115 -85
+-16 -15 -52 -39 -78 -54 -27 -15 -103 -82 -171 -149 -67 -67 -219 -218 -338
+-335 -119 -117 -228 -232 -244 -255 -16 -23 -51 -67 -79 -97 -29 -30 -64 -75
+-80 -100 -15 -25 -45 -65 -67 -89 -36 -41 -100 -140 -156 -241 -23 -42 -57
+-96 -122 -195 -34 -52 -115 -220 -146 -302 -13 -35 -34 -80 -47 -101 -30 -47
+-87 -170 -87 -186 0 -7 -18 -48 -40 -91 -22 -43 -40 -92 -40 -107 0 -16 -9
+-48 -19 -71 -41 -91 -51 -121 -66 -199 -8 -45 -26 -116 -39 -157 -72 -229
+-124 -541 -146 -867 -6 -97 -16 -166 -27 -195 -28 -73 -32 -566 -5 -657 11
+-37 23 -112 26 -167 22 -347 114 -768 190 -868 58 -77 100 -55 231 117 108
+142 218 269 352 407 168 172 171 181 154 440 -19 296 -15 762 9 850 11 41 20
+94 20 119 1 58 21 174 48 270 12 41 26 113 31 160 6 47 17 103 25 125 8 22 15
+48 16 57 0 10 18 58 40 107 22 50 40 104 40 124 0 21 14 63 36 104 20 37 45
+97 56 133 11 36 28 76 38 90 10 14 23 45 30 70 16 61 116 235 252 438 25 38
+56 89 68 113 12 24 39 64 59 89 20 25 48 61 61 80 13 19 40 53 61 75 21 22 53
+61 71 87 18 26 84 103 146 170 62 68 147 160 189 206 42 45 100 102 129 125
+29 23 88 70 131 104 145 116 158 125 213 153 30 15 86 51 124 79 38 28 73 51
+79 51 6 0 25 12 44 26 45 34 585 304 609 304 10 0 48 14 82 30 35 17 96 39
+135 49 40 10 104 31 142 45 41 16 108 30 161 36 50 5 138 23 195 41 113 34
+134 36 734 56 220 8 220 8 290 41 39 18 84 47 101 65 42 43 120 108 169 139
+22 15 72 58 110 98 82 84 192 170 291 228 39 22 77 49 85 58 7 9 30 27 49 39
+60 38 120 103 120 129 0 32 -36 60 -97 76 -26 7 -75 20 -108 30 -33 10 -102
+23 -153 29 -51 6 -114 20 -140 30 -56 22 -527 33 -997 22z"/>
+<path d="M12040 10473 c-8 -3 -32 -21 -53 -39 -20 -19 -42 -34 -47 -34 -23 0
+-98 -82 -155 -170 -34 -52 -99 -134 -143 -182 -45 -48 -91 -106 -103 -130 -12
+-24 -38 -62 -59 -85 -88 -100 -80 -260 17 -355 131 -126 221 -117 382 42 50
+49 101 107 115 128 13 21 39 54 56 73 17 19 40 50 50 69 10 19 61 81 113 136
+187 200 206 389 50 506 -54 41 -60 43 -132 45 -42 1 -83 0 -91 -4z"/>
+<path d="M7770 10460 c-19 -4 -60 -14 -90 -23 -30 -9 -100 -21 -155 -27 -107
+-11 -292 -67 -435 -133 -41 -19 -97 -40 -125 -46 -67 -16 -250 -89 -278 -111
+-24 -19 -218 -110 -234 -110 -5 0 -36 -16 -69 -36 -32 -20 -75 -45 -94 -56
+-19 -11 -44 -28 -55 -38 -11 -10 -35 -25 -53 -34 -17 -9 -51 -34 -75 -55 -23
+-22 -87 -69 -142 -106 -101 -67 -129 -91 -288 -252 -148 -148 -173 -176 -208
+-228 -18 -27 -69 -89 -113 -136 -91 -95 -155 -176 -204 -252 -17 -29 -65 -88
+-104 -131 -40 -44 -86 -101 -103 -127 -16 -26 -43 -64 -58 -85 -41 -56 -177
+-276 -177 -287 0 -4 -13 -27 -29 -50 -15 -23 -34 -60 -41 -82 -7 -22 -25 -62
+-40 -90 -16 -27 -33 -70 -40 -95 -6 -25 -31 -76 -55 -115 -24 -38 -63 -112
+-88 -162 -25 -51 -55 -106 -66 -121 -11 -16 -26 -55 -33 -88 -8 -33 -28 -78
+-46 -103 -18 -24 -32 -50 -32 -56 0 -7 -18 -56 -40 -109 -22 -53 -40 -103 -40
+-112 0 -8 -8 -36 -19 -62 -10 -26 -38 -96 -61 -157 -23 -60 -50 -131 -61 -157
+-10 -26 -19 -66 -19 -90 0 -24 -12 -82 -26 -131 -30 -98 -27 -122 23 -154 52
+-34 298 -9 507 53 35 10 102 14 227 14 155 0 191 3 281 25 57 14 130 25 163
+25 33 0 91 7 130 15 38 8 90 15 115 15 113 0 173 42 183 129 3 29 15 67 26 84
+29 46 41 71 118 262 13 33 39 92 57 130 18 39 37 83 40 99 4 17 16 42 27 58
+11 16 53 92 93 171 141 276 219 422 243 455 14 18 29 49 35 68 5 19 22 49 37
+67 16 17 38 51 49 74 12 22 40 62 62 88 22 26 50 65 62 88 24 47 96 133 182
+215 32 32 67 75 79 97 31 61 226 262 312 321 28 19 95 70 150 113 180 143 356
+254 430 272 28 7 77 22 110 34 33 12 94 29 135 38 186 41 272 57 281 51 6 -3
+52 -10 102 -15 229 -22 338 -69 468 -199 99 -98 144 -164 191 -277 33 -78 33
+-78 32 -363 -1 -375 -22 -476 -164 -765 -132 -268 -146 -309 -115 -335 13 -11
+27 -11 73 0 94 20 181 74 512 317 89 65 379 341 420 399 16 23 63 76 104 119
+78 81 86 97 116 230 14 59 14 318 1 390 -5 28 -14 84 -21 125 -29 182 -84 382
+-127 465 -11 22 -26 58 -33 80 -6 22 -28 64 -48 92 -99 140 -169 233 -211 278
+-26 28 -66 76 -90 107 -23 31 -65 72 -93 89 -28 18 -68 48 -90 66 -22 18 -57
+37 -79 43 -21 6 -60 24 -86 40 -27 17 -79 41 -118 54 -38 13 -101 35 -140 49
+-38 13 -92 35 -120 49 -61 30 -208 65 -331 77 -50 5 -108 17 -129 25 -40 17
+-313 21 -385 6z"/>
+<path d="M10475 10461 c-32 -13 -133 -126 -141 -156 -13 -53 5 -208 36 -304
+17 -50 30 -102 30 -113 0 -57 79 -167 143 -199 105 -54 253 -5 307 101 31 62
+33 96 11 196 -12 52 -31 138 -42 192 -36 162 -51 187 -153 253 -61 40 -137 52
+-191 30z"/>
+<path d="M10861 9389 c-212 -36 -395 -146 -457 -277 -15 -31 -35 -68 -45 -82
+-9 -14 -27 -65 -39 -113 -21 -86 -21 -90 -5 -189 11 -66 16 -137 13 -207 -5
+-148 -26 -183 -255 -428 -45 -49 -95 -107 -112 -130 -16 -22 -35 -44 -41 -48
+-6 -4 -29 -30 -52 -58 -165 -210 -420 -455 -510 -489 -50 -19 -95 -49 -201
+-135 -29 -23 -110 -77 -181 -120 -70 -43 -148 -95 -173 -115 -24 -21 -50 -38
+-58 -38 -7 0 -40 -20 -73 -45 -75 -56 -256 -144 -382 -185 -52 -17 -112 -42
+-132 -55 -20 -13 -63 -29 -96 -34 -33 -5 -78 -19 -100 -30 -22 -11 -78 -32
+-124 -45 -46 -13 -112 -38 -148 -55 -36 -17 -78 -31 -93 -31 -15 0 -71 -18
+-124 -41 -67 -28 -119 -43 -172 -49 -42 -4 -96 -17 -121 -28 -25 -11 -74 -25
+-110 -32 -36 -6 -101 -22 -145 -35 -50 -15 -154 -33 -275 -46 -107 -12 -208
+-26 -225 -31 -16 -5 -77 -13 -135 -19 -58 -5 -141 -16 -185 -24 -44 -7 -118
+-16 -165 -20 -47 -3 -113 -13 -148 -21 -35 -8 -80 -14 -100 -14 -20 0 -71 -4
+-112 -10 -41 -5 -138 -17 -215 -25 -77 -9 -170 -23 -207 -31 -37 -8 -86 -14
+-110 -14 -24 -1 -61 -8 -83 -17 -27 -10 -94 -18 -200 -22 -120 -6 -178 -13
+-230 -29 -38 -12 -101 -26 -140 -31 -38 -5 -106 -19 -150 -31 -44 -12 -120
+-28 -170 -35 -194 -30 -313 -55 -385 -80 -41 -14 -107 -30 -146 -34 -46 -6
+-99 -21 -151 -45 -44 -20 -91 -36 -104 -36 -13 0 -42 -9 -64 -19 -22 -10 -71
+-25 -110 -35 -38 -9 -92 -30 -120 -46 -74 -43 -102 -56 -185 -83 -110 -37
+-179 -68 -234 -105 -27 -17 -55 -32 -62 -32 -22 0 -267 -128 -354 -185 -46
+-30 -90 -55 -96 -55 -6 0 -29 -13 -51 -29 -23 -16 -63 -41 -89 -54 -27 -14
+-75 -48 -107 -76 -33 -29 -80 -62 -105 -76 -26 -13 -82 -55 -125 -94 -43 -39
+-82 -71 -87 -71 -12 0 -265 -252 -301 -300 -15 -19 -69 -80 -120 -135 -52 -55
+-107 -121 -121 -146 -15 -26 -34 -49 -42 -52 -7 -3 -42 -48 -76 -99 -34 -51
+-71 -102 -80 -113 -10 -11 -34 -54 -53 -95 -18 -41 -52 -101 -75 -134 -23 -32
+-51 -84 -62 -115 -12 -31 -35 -70 -51 -87 -18 -19 -32 -46 -36 -70 -3 -21 -20
+-68 -39 -104 -51 -102 -141 -389 -161 -515 -2 -16 -13 -70 -23 -120 -42 -208
+-44 -226 -43 -550 0 -331 8 -430 45 -580 51 -206 111 -362 169 -435 15 -20 38
+-61 52 -91 13 -30 39 -72 57 -92 18 -21 44 -53 59 -71 14 -19 46 -61 71 -93
+25 -32 53 -64 62 -71 10 -7 57 -47 105 -89 54 -47 112 -87 153 -105 36 -16 97
+-45 135 -64 92 -45 189 -80 245 -89 25 -4 88 -17 142 -30 135 -33 443 -20 588
+25 19 6 78 17 131 24 100 15 164 38 312 115 43 23 92 41 109 41 22 0 39 10 62
+34 17 18 51 43 76 55 25 11 79 45 120 75 41 30 102 72 135 94 99 66 188 144
+338 300 7 7 32 32 57 57 25 24 61 60 80 80 19 19 44 44 55 54 35 32 161 195
+180 231 9 19 32 51 50 70 17 19 44 58 60 85 15 28 48 77 73 110 28 37 50 80
+59 115 9 32 26 67 43 85 16 17 38 51 49 77 11 25 35 69 55 97 19 28 38 66 41
+83 9 38 61 145 104 213 16 25 35 70 41 98 7 29 24 72 38 96 27 48 84 200 109
+290 8 30 27 80 42 110 16 31 38 98 50 150 12 52 32 120 45 150 14 31 27 83 30
+115 3 39 15 80 35 116 35 69 66 165 76 240 4 30 22 100 41 156 90 267 4 341
+-296 254 -19 -5 -57 -10 -85 -10 -27 0 -92 -9 -144 -20 -52 -11 -120 -20 -152
+-20 -35 0 -79 -8 -109 -20 -28 -11 -68 -20 -90 -20 -22 0 -68 -11 -102 -24
+-35 -13 -110 -33 -168 -46 -105 -23 -270 -79 -347 -118 -51 -27 -74 -56 -102
+-129 -12 -32 -32 -80 -43 -108 -12 -27 -32 -84 -46 -125 -13 -41 -35 -100 -48
+-131 -13 -31 -24 -67 -24 -79 0 -13 -16 -56 -35 -96 -19 -40 -38 -88 -41 -106
+-13 -68 -54 -198 -77 -245 -13 -26 -30 -66 -37 -88 -25 -84 -63 -171 -87 -203
+-14 -18 -36 -60 -49 -93 -14 -33 -43 -87 -66 -120 -22 -33 -49 -88 -59 -122
+-11 -34 -28 -73 -38 -87 -10 -15 -30 -48 -44 -76 -14 -27 -43 -71 -65 -98 -22
+-27 -43 -60 -47 -74 -11 -46 -340 -392 -373 -392 -9 0 -43 -18 -75 -40 -188
+-127 -405 -101 -576 71 -39 39 -119 185 -144 264 -46 148 -16 530 56 706 76
+186 106 250 130 279 14 16 29 40 32 52 4 13 17 37 30 53 12 17 32 50 44 73 12
+24 39 63 60 85 21 23 48 60 61 82 13 22 45 63 72 92 26 28 48 57 48 63 0 21
+105 122 151 145 25 13 80 61 123 106 43 46 99 96 124 112 26 16 61 42 79 58
+18 15 52 37 75 48 24 11 64 35 90 53 117 83 201 131 249 143 29 8 64 25 78 39
+25 24 125 76 146 76 6 0 63 23 125 51 63 28 135 58 160 66 25 8 86 29 135 47
+120 44 212 73 258 81 20 3 69 20 109 37 52 22 97 32 163 38 49 5 107 15 127
+24 21 9 50 16 65 16 15 0 57 7 93 15 36 8 128 23 205 34 78 11 152 22 165 25
+33 8 257 34 395 47 61 5 160 18 220 29 104 18 174 25 480 50 72 6 172 18 222
+26 51 8 128 14 170 14 48 0 105 8 148 20 48 14 100 20 166 20 67 0 116 6 160
+19 35 11 87 23 114 26 49 7 231 51 246 61 4 2 42 9 85 14 81 10 136 24 274 71
+47 15 114 34 150 40 36 6 106 29 157 50 51 22 107 39 126 39 19 0 67 15 108
+34 41 18 107 41 148 50 41 9 102 32 136 50 33 19 84 44 112 55 98 39 318 144
+350 168 18 13 63 36 101 51 37 16 88 42 113 60 26 17 73 43 105 57 140 62 460
+289 599 424 61 59 157 149 215 199 152 131 358 339 420 422 70 95 95 126 135
+165 22 22 56 67 74 100 19 33 51 80 71 105 21 25 63 86 93 135 31 50 75 115
+99 146 58 76 172 265 198 329 7 19 37 73 66 121 30 48 68 129 87 187 72 212
+102 238 297 267 36 5 98 40 199 112 94 66 147 125 192 214 43 84 43 84 47 219
+7 234 -46 387 -176 516 -150 149 -308 198 -521 163z"/>
+<path d="M12285 9089 c-22 -4 -71 -8 -110 -9 -154 -2 -218 -41 -263 -163 -44
+-118 -24 -188 79 -274 100 -83 95 -82 335 -83 269 0 264 -1 345 79 61 60 68
+72 79 125 31 152 -42 277 -186 321 -53 16 -211 19 -279 4z"/>
+<path d="M10168 6312 c-9 -4 -43 -32 -75 -64 -124 -120 -179 -176 -213 -214
+-33 -37 -226 -218 -315 -296 -22 -19 -57 -45 -77 -57 -21 -12 -38 -26 -38 -31
+0 -4 -19 -36 -42 -71 -43 -64 -43 -64 -49 -299 -3 -129 -10 -249 -16 -265 -6
+-17 -14 -84 -18 -150 -4 -65 -13 -136 -21 -158 -8 -22 -14 -54 -14 -71 0 -41
+-24 -133 -56 -212 -14 -35 -36 -126 -48 -201 -25 -145 -63 -274 -115 -383 -17
+-36 -31 -72 -31 -80 0 -33 -165 -368 -244 -495 -27 -44 -69 -116 -93 -160 -24
+-43 -51 -88 -61 -100 -10 -11 -40 -54 -66 -95 -53 -86 -104 -158 -144 -205
+-15 -18 -38 -52 -52 -75 -14 -23 -43 -55 -66 -71 -22 -16 -67 -62 -100 -101
+-32 -40 -72 -83 -89 -97 -16 -14 -68 -65 -115 -112 -119 -122 -255 -244 -322
+-290 -31 -22 -69 -55 -83 -74 -15 -18 -42 -39 -60 -45 -19 -6 -51 -25 -72 -42
+-21 -16 -67 -45 -103 -63 -36 -18 -74 -42 -84 -54 -23 -25 -117 -81 -137 -81
+-8 0 -40 -18 -73 -40 -32 -22 -66 -40 -75 -40 -9 0 -64 -24 -121 -54 -58 -29
+-123 -59 -145 -66 -22 -7 -87 -35 -145 -62 -61 -28 -129 -53 -165 -58 -33 -5
+-98 -25 -145 -44 -48 -20 -102 -36 -125 -36 -22 0 -71 -11 -110 -25 -38 -13
+-85 -25 -103 -25 -18 0 -63 -7 -100 -15 -126 -28 -275 -35 -713 -35 -411 0
+-441 1 -488 19 -27 11 -105 26 -174 34 -68 8 -134 20 -146 26 -58 31 -249 50
+-288 28 -34 -19 -131 -116 -164 -163 -16 -23 -57 -62 -91 -86 -50 -34 -69 -55
+-90 -98 -16 -33 -43 -68 -67 -87 -46 -35 -114 -113 -138 -157 -13 -26 -13 -33
+2 -73 16 -41 80 -103 107 -103 5 0 37 -11 71 -24 99 -38 229 -75 320 -91 46
+-8 109 -26 140 -40 30 -14 80 -30 109 -35 30 -4 76 -15 104 -24 27 -8 119 -20
+204 -25 85 -6 178 -15 205 -20 88 -17 805 -14 855 4 29 10 81 15 161 15 95 0
+128 4 169 20 28 11 72 20 98 20 55 1 183 29 264 59 32 11 79 21 105 21 33 0
+69 10 113 31 35 16 95 37 133 45 37 8 76 18 85 23 9 5 67 25 127 45 61 20 135
+50 166 66 31 17 68 30 82 30 36 0 75 16 109 45 16 14 37 25 45 25 20 0 222 92
+281 129 24 14 72 45 106 67 35 23 84 51 110 62 26 12 58 30 72 41 14 11 42 25
+62 32 20 6 62 35 93 64 30 29 78 64 107 79 28 14 59 38 68 52 16 23 40 41 163
+123 20 13 56 42 81 66 25 23 61 52 80 65 19 13 87 73 150 134 64 61 147 141
+185 177 114 108 271 290 341 396 36 54 90 123 120 153 29 30 64 80 78 110 14
+30 53 87 86 125 33 39 85 112 116 163 31 52 69 109 85 127 18 20 33 52 38 79
+5 26 23 70 41 99 18 28 34 66 37 85 3 18 19 45 35 60 17 16 35 49 45 82 8 30
+35 94 59 141 23 47 59 128 78 180 20 52 43 108 53 124 46 83 53 103 53 146 0
+29 11 76 29 121 16 40 33 91 36 113 4 22 18 78 31 124 13 46 24 95 24 110 0
+14 8 67 19 116 11 50 27 133 37 185 9 52 26 124 38 160 34 105 33 1416 -2
+1501 -31 78 -76 111 -124 91z"/>
+</g>
+</svg>