From bef8bf3b4d42048f1e93eca8219b99b60321d0c4 Mon Sep 17 00:00:00 2001
From: Fabio Bonelli <fb@fabiobonelli.it>
Date: Tue, 10 Nov 2026 00:37:42 +0000
Subject: [PATCH] doc: document external validation checks

---
 README.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/README.md b/README.md
index b94a186..41f73c1 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,19 @@ curl -X QUERY "http://localhost:3000/v1/validate" \
 --data-binary $'publiccodeYmlVersion: "0.5"\ndevelopmentStatus: stable\n [...]\n'
 ```
 
+### Run external validation checks
+
+External URL reachability checks are disabled by default. Enable them when
+needed with the `external-checks` query parameter:
+
+```console
+curl -X POST "http://localhost:3000/v1/validate?external-checks=true" \
+--data-binary "@./publiccode.yml"
+```
+
+This mode makes network requests for the external checks, so it can take
+longer than the default validation.
+
 ### Example response (valid publiccode.yml)
 
 ```json