Add documentation for "no_default_http_client" (#1068)
diff --git a/pkgs/http/README.md b/pkgs/http/README.md
index 689e8fb..8ce106d 100644
--- a/pkgs/http/README.md
+++ b/pkgs/http/README.md
@@ -255,7 +255,17 @@
If you depend on code that uses top-level functions (e.g. `http.post`) or
calls the [`Client()`][clientconstructor] constructor, then you can use
[`runWithClient`](runwithclient) to ensure that the correct
-[`Client`][client] is used.
+`Client` is used.
+
+You can ensure that only the `Client` that you have explicitly configured is
+used by defining `no_default_http_client=true` in the environment. This will
+also allow the default `Client` implementation to be removed, resulting in
+a reduced application size.
+
+```terminal
+$ flutter build appbundle --dart-define=no_default_http_client=true ...
+$ dart compile exe --define=no_default_http_client=true ...
+```
> [!TIP]
> [The Flutter HTTP example application][flutterhttpexample] demonstrates
