--- a/mod_http_upload/README.markdown	Sun Apr 05 23:37:17 2020 +0200
+++ b/mod_http_upload/README.markdown	Sun Apr 05 23:39:08 2020 +0200
@@ -24,6 +24,19 @@
 
 It should **not** be added to modules_enabled.
 
+## Discoverability
+
+Prosody makes subdomains of your VirtualHosts easily discoverable by
+clients. To make the component discoverable by other hosts, use
+[`disco_items`][doc:modules:mod_disco#configuration].
+
+``` {.lua}
+VirtualHost "foo.example.org"
+disco_items = {
+    { "upload.example.com" },
+}
+```
+
 Limits
 ------
 
@@ -54,7 +67,7 @@
 A command exists to invoke expiry:
 
 ```
-prosodyctl mod_http_upload expire [optional list of users]
+prosodyctl mod_http_upload expire [list of users or hosts]
 ```
 
 ### User quota