diff --git a/jsonschema-hyperschema.xml b/jsonschema-hyperschema.xml index a53f6626..e8f6d6ae 100644 --- a/jsonschema-hyperschema.xml +++ b/jsonschema-hyperschema.xml @@ -1378,8 +1378,10 @@ for varname in templateData: similarly structured headers wherever possible. - No distinction is made between headers that may appear in responses to - different methods, such as HEAD vs OPTIONS. + Headers for all possible HTTP method responses all share "headerSchema". + In particular, both headers that appear in a HEAD response and those + that appear in an OPTIONS response can appear. No distinction is made + within "headerSchema" as to which method response contains which header. It is RECOMMENDED that schema authors provide hints for the values of