From bd41fa761f3d8be247503f9f5dacfb98c10e7489 Mon Sep 17 00:00:00 2001
From: Farshid Tavakolizadeh <email@farshid.ws>
Date: Mon, 30 Aug 2021 11:41:25 +0200
Subject: [PATCH] HTTP HEAD method for directory

---
 index.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/index.html b/index.html
index 46cf0f31..6a6d5b39 100644
--- a/index.html
+++ b/index.html
@@ -873,6 +873,16 @@ <h3>Directory Service API</h3>
                     should be set to HTTP status text.
                 </p>
                 
+                <p>
+                    <span class="rfc2119-assertion" id="tdd-http-head"> 
+                        For each HTTP endpoint that responds to the `GET` method, the server SHOULD accept `HEAD` 
+                        requests and return only the headers.
+                    </span>
+                    This allows clients to retrieve headers such as the `Content-Length` without receiving the body
+                    and decide on a suitable strategy to query the information. For example, a constrained client can
+                    request only the necessary parts of an object (using an apprpriate search query) or 
+                    retrieve a list of items in small subsets.
+                </p>
 
                 <section id="exploration-directory-api-registration" class="normative">
                     <h4>Registration</h4>