From 0a6b061d3dd025cb460e18bc35935c6a1d334571 Mon Sep 17 00:00:00 2001
From: Nils Goroll <nils.goroll@uplex.de>
Date: Wed, 9 Sep 2020 11:32:49 +0200
Subject: [PATCH] clarify Content-Type / Content-Encoding / Content-Language
 handling

closes #158
---
 protocol.md | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/protocol.md b/protocol.md
index d74a8a0..c09b668 100644
--- a/protocol.md
+++ b/protocol.md
@@ -45,6 +45,7 @@ Kleidl](https://twitter.com/Acconut_)<br>
 [J. Ryan Stinnett](https://convolv.es),
 [Ifedapo Olarewaju](https://github.com/ifedapoolarewaju)
 [Robert Nagy](https://github.com/ronag)
+[Nils Goroll](https://github.com/nigoroll)
 
 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
 "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be
@@ -299,7 +300,7 @@ Host: tus.example.org
 Content-Length: 0
 Upload-Length: 100
 Tus-Resumable: 1.0.0
-Upload-Metadata: filename d29ybGRfZG9taW5hdGlvbl9wbGFuLnBkZg==,is_confidential
+Upload-Metadata: filename d29ybGRfZG9taW5hdGlvbl9wbGFuLnBkZg==,filetype YXBwbGljYXRpb24vcGRm,is_confidential
 ```
 
 **Response:**
@@ -330,6 +331,34 @@ ASCII encoded and the value MUST be Base64 encoded. All keys MUST be unique.
 The value MAY be empty. In these cases, the space, which would normally separate
 the key and the value, MAY be left out.
 
+Clients and servers SHOULD implement the metadata key ``filetype``
+with the value containing the actual ``Content-Type`` of the Upload
+(because the ``Content-Type`` header is formally required to be set to
+``application/offset+octet-stream`` for [Creation with
+Upload](#creation-with-upload)).
+
+Clients and servers MAY support additional well known metadata keys:
+
+* ``filename`` for a common file name
+
+The specific metadata keys documented herein are reserved for the
+respective use and MUST NOT be used for other purposes.
+
+##### [Content-Encoding](https://httpwg.org/specs/rfc7231.html#header.content-encoding)
+
+Clients MUST set the ``Content-Encoding`` header correctly IFF a
+content encoding is used.
+
+As per RFC7231, Servers MUST respond with status 415 if they can not
+accept the ``Content-Encoding`` chosen by the client.
+
+Servers MUST either store the ``Content-Encoding`` and deliver it with
+subsequent requests, or properly decode the content before storing it.
+
+[Content-Language](https://httpwg.org/specs/rfc7231.html#header.content-language)
+
+Clients and Servers SHOULD support the ``Content-Language`` header.
+
 #### Requests
 
 ##### POST