Status code 422 in http-core uses the term `entity`. Should we use `representation` ?

Roberto Polli <roberto@teamdigitale.governo.it> Tue, 14 May 2019 15:41 UTC

Return-Path: <ietf-http-wg-request+bounce-httpbisa-archive-bis2juki=lists.ie@listhub.w3.org>
X-Original-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Delivered-To: ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5C2BC120146 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Tue, 14 May 2019 08:41:11 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.999
X-Spam-Level:
X-Spam-Status: No, score=-2.999 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.001, MAILING_LIST_MULTI=-1, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=teamdigitale.governo.it
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Xq2-pXChKsg8 for <ietfarch-httpbisa-archive-bis2Juki@ietfa.amsl.com>; Tue, 14 May 2019 08:41:09 -0700 (PDT)
Received: from frink.w3.org (frink.w3.org [IPv6:2603:400a:ffff:804:801e:34:0:38]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A4F91120105 for <httpbisa-archive-bis2Juki@lists.ietf.org>; Tue, 14 May 2019 08:41:09 -0700 (PDT)
Received: from lists by frink.w3.org with local (Exim 4.89) (envelope-from <ietf-http-wg-request@listhub.w3.org>) id 1hQZWg-0005Oq-1i for ietf-http-wg-dist@listhub.w3.org; Tue, 14 May 2019 15:39:34 +0000
Resent-Date: Tue, 14 May 2019 15:39:34 +0000
Resent-Message-Id: <E1hQZWg-0005Oq-1i@frink.w3.org>
Received: from titan.w3.org ([2603:400a:ffff:804:801e:34:0:4c]) by frink.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from <roberto@teamdigitale.governo.it>) id 1hQZWc-0005O5-Vu for ietf-http-wg@listhub.w3.org; Tue, 14 May 2019 15:39:31 +0000
Received: from mail-ed1-x536.google.com ([2a00:1450:4864:20::536]) by titan.w3.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from <roberto@teamdigitale.governo.it>) id 1hQZWY-0006pA-5K for ietf-http-wg@w3.org; Tue, 14 May 2019 15:39:30 +0000
Received: by mail-ed1-x536.google.com with SMTP id m4so23486531edd.8 for <ietf-http-wg@w3.org>; Tue, 14 May 2019 08:39:05 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=teamdigitale.governo.it; s=google; h=mime-version:from:date:message-id:subject:to :content-transfer-encoding; bh=Nx5Z2OtP8rjg7RiRLmIpzepO9F16n9PaO4LFh/JPzo8=; b=l+EGGkWZ5kt/3F4JkwErlB/1It0LsBXoVmV9CwNLBsI1Ws9XGgSDccLFZXHyYrjTz2 O5jsf8mVazRJK3OVU4QTyBrJaTfVqoYIVjaH6NhCnPXkZfiBoU4B79EepGzJ41C6BfN+ aCYarK93Xq38A/0z/G8iTX/xVzcGSKo0Sh3NtilBgsAFQNoR31GVP97PvhlRHpMjSi3R rn+s0524chINXDkulcpV+dh7by2W4cFGEQO8RssdhCn+a1lH6WcV36ZQH83ZAZg1fv5v wy7Vrsf9xiVS/ObCsUO2bU4XDVeUpFX5OdWc9eeJjswzKiSYoSUZfJ94r/Cb71jjJtuK UFHg==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to :content-transfer-encoding; bh=Nx5Z2OtP8rjg7RiRLmIpzepO9F16n9PaO4LFh/JPzo8=; b=Yhy/DB49rgrcPXTBSbPzPX1fFcgxdLnqb4sNuCjrfcuXOef2qwtxNb6iiTrM/C24TA qDPAVUjr2gbpWuikEWMzJc2HNbuWxB9+lF0ZZY2BbwTJXTzfLk9dbZObeGnblfQa8gVU 0iakK6z+oRMWS04jUCkikimMKzCaWNII4siRW2VsQM6kZB9oUARB2K0Pv91lHzxLGRnV ipW4RwxJpi8IccoxyxBTEueTZIU2Dgxs82fUiMKmlcH9tp3sE2iFAj1BC4wq/oxFhUBn ycCDgJmgFqRIdNdcU7RYYaWNWoffB2NqgqC3iDw/QKp2K+2IzY/PIXxDStW1LG3Zu8hG Zb7Q==
X-Gm-Message-State: APjAAAWTkMXLZUEjsfhnAvIAO4sVZ0RedeL1XYqflh+vih4yfTmpjSSS OuNYa9ErbaPz6BF+U0KgxVp0RLeqWE81veZp/05CRlnxmWfFRQ==
X-Google-Smtp-Source: APXvYqwZJWi6Hn6ofLgvVajd8QJ2FqqUOhqyqWbRB4rj0T7bZcysJhAZPsOX2TqP8G17SA0HMDiZMd7CWosVEQERbYQ=
X-Received: by 2002:a17:906:f19a:: with SMTP id gs26mr21393007ejb.78.1557848343599; Tue, 14 May 2019 08:39:03 -0700 (PDT)
MIME-Version: 1.0
From: Roberto Polli <roberto@teamdigitale.governo.it>
Date: Tue, 14 May 2019 17:38:52 +0200
Message-ID: <CAMRHeuyKsYvHYz-x=WqO_iJ6hCehnvkeO6XeEtda7msCvC30Fw@mail.gmail.com>
To: HTTP Working Group <ietf-http-wg@w3.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Received-SPF: pass client-ip=2a00:1450:4864:20::536; envelope-from=roberto@teamdigitale.governo.it; helo=mail-ed1-x536.google.com
X-W3C-Hub-Spam-Status: No, score=-1.3
X-W3C-Hub-Spam-Report: AWL=-0.009, BAYES_50=0.8, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, W3C_AA=-1, W3C_WL=-1
X-W3C-Scan-Sig: titan.w3.org 1hQZWY-0006pA-5K 47eeb561e4888ee674395eed2477088a
X-Original-To: ietf-http-wg@w3.org
Subject: Status code 422 in http-core uses the term `entity`. Should we use `representation` ?
Archived-At: <https://www.w3.org/mid/CAMRHeuyKsYvHYz-x=WqO_iJ6hCehnvkeO6XeEtda7msCvC30Fw@mail.gmail.com>
Resent-From: ietf-http-wg@w3.org
X-Mailing-List: <ietf-http-wg@w3.org> archive/latest/36636
X-Loop: ietf-http-wg@w3.org
Resent-Sender: ietf-http-wg-request@w3.org
Precedence: list
List-Id: <ietf-http-wg.w3.org>
List-Help: <https://www.w3.org/Mail/>
List-Post: <mailto:ietf-http-wg@w3.org>
List-Unsubscribe: <mailto:ietf-http-wg-request@w3.org?subject=unsubscribe>

Hi @all,

while reading httpbis-semantics I noted that:

- Status code 422 uses the term `entity`

I filed an issue:

- https://github.com/httpwg/http-core/issues/224

My proposals:

- it should use the term `representation`
- the definition should expand the original statements which are tied to webdav
  so that it could be more generic
- we could add one or two examples with the correct 422 usage

How would you manage it?

Regards,
R.
-- 
Roberto Polli
Full Stack Developer
M. +39 3406522736
·D
TEAM PER LA
TRASFORMAZIONE
DIGITALE
Presidenza del Consiglio dei Ministri
teamdigitale.governo.it

Il Team per la Trasformazione Digitale, salvo eccezioni, comunica con
le altre Amministrazioni via posta elettronica ordinaria e non posta
elettronica certificata, in conformità a quanto previsto dall’art.47
del Codice dell’Amministrazione Digitale.