Added URLEncoder section

README.md

@@ -94,3 +94,35 @@ java -jar lib/build/libs/urlencoder-*.jar "%#okékÉȢ"          # -> %25%23ok%C
 
 java -jar lib/build/libs/urlencoder-*.jar -d "a%20test%20%26" # -> a test &
 ```
+
+## Why not simply use `java.net.URLEncoder`?
+
+Apart for being quite inefficient, some URL components encoded with `URLEncoder.encode` might not be able to be properly decoded.
+
+For example, a simply search query such as:
+
+```kotlin
+var u = URLEncoder.encode("foo + bar", StandardCharsets.UTF_8);
+```
+
+would be encoded as:
+
+```
+foo+%28+bar
+```
+
+Trying to decode it with [Spring](https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/web/util/UriUtils.html#decode(java.lang.String,java.lang.String)), for example:
+
+```kotlin
+UriUtils.decode(u, StandardCharsets.UTF_8));
+```
+
+would return:
+
+```
+foo+++bar
+```
+
+Unfortunately, decoding with [Uri.decode](https://developer.android.com/reference/android/net/Uri#decode(java.lang.String)) on Android, [decodeURI](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURI) in Javascript, etc. would yield the exact same result.
+
+![URLEncoder](https://live.staticflickr.com/65535/52607534147_dee4a5a390_c.jpg)