From dev-return-49340-archive-asf-public=cust-asf.ponee.io@couchdb.apache.org Wed May 6 14:53:15 2020 Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [207.244.88.153]) by mx-eu-01.ponee.io (Postfix) with SMTP id 70DAA18064F for ; Wed, 6 May 2020 16:53:15 +0200 (CEST) Received: (qmail 71952 invoked by uid 500); 6 May 2020 14:53:14 -0000 Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@couchdb.apache.org Delivered-To: mailing list dev@couchdb.apache.org Received: (qmail 71939 invoked by uid 99); 6 May 2020 14:53:14 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 06 May 2020 14:53:14 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id D250CC11EE for ; Wed, 6 May 2020 14:53:13 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -0.2 X-Spam-Level: X-Spam-Status: No, score=-0.2 tagged_above=-999 required=6.31 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=disabled Authentication-Results: spamd1-us-west.apache.org (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com Received: from mx1-ec2-va.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id tbGFmtAGJtPr for ; Wed, 6 May 2020 14:53:09 +0000 (UTC) Received-SPF: Pass (mailfrom) identity=mailfrom; client-ip=209.85.219.45; helo=mail-qv1-f45.google.com; envelope-from=vatamane@gmail.com; receiver= Received: from mail-qv1-f45.google.com (mail-qv1-f45.google.com [209.85.219.45]) by mx1-ec2-va.apache.org (ASF Mail Server at mx1-ec2-va.apache.org) with ESMTPS id 49A9FBB905 for ; Wed, 6 May 2020 14:53:09 +0000 (UTC) Received: by mail-qv1-f45.google.com with SMTP id fb4so838942qvb.7 for ; Wed, 06 May 2020 07:53:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=content-transfer-encoding:from:mime-version:subject:date:message-id :references:in-reply-to:to; bh=aVp4LZXUbyNh6O39IlMNpL3bkyuOOUJTN/87f8PRkxM=; b=GQ4VC75Bderg9PJKx9MYaJIp9pSVPX1xHW5Jx6uNVxHiDgaaJ0kwJIu2w2Y4A+MD45 bcrWtx/hSTdEGmznghMaBXcJpLq/TUsbdXsQyzojQMvRtRD0tpVd7YI0CH+aVckDBZ6p VEC/bbjFGcy1RLbVpg3S5Mple6JW4bm5iS4NYVLJYkT7EKtxYPmrGiUiTy8mQQLdiKz3 +J4YScrLAckFkTN7bA/N1QfqsWj0q3vi9ochv/yQmSqRB4W+64+X2RHzy8uQToL5Ju6S dTOOFg/Mk7pYA9bLUhHue03ew6EoTg5AcWlg9wqtUCtg3u4Y/HwOZTPhXkPTICU5+lFx uakA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:content-transfer-encoding:from:mime-version :subject:date:message-id:references:in-reply-to:to; bh=aVp4LZXUbyNh6O39IlMNpL3bkyuOOUJTN/87f8PRkxM=; b=BIShRF2aeHaS8603fH/ly74/vt3tHj8GCkbrji5dpzckVo6Ujn3bbbWKGXjaRpH9zX raMKs8sDtK8y7MA9C+g+ABCf0wcgT5MqO6YgGEbCwdN5OXhfCr+V0tYq1QAHcsezBhCf YMpazU8tIzCRfEKuQA7abJskw0XgLRv3XYahxKk8cTp6GYbkTh1Am2z/ZYry5m9pMXKr aFTTtHOITiRWYQVAT5mtkT6YD8kxcS5g8htDM9jMH3DGvvD9Cjbv9uQupurlxnyxELbI AowZ/55WV6/G7WpXbov8lkTP4y0NtqOsWiEYfdNoFzYljSqu6deLVbbwSlYLtCobeTBy Zegw== X-Gm-Message-State: AGi0PuZ2ZNXzS1iqh8L7R3vMe8HDn2AVy8eVnTuofsyr3VMa+44LBmuZ ELn4HJgkeMyIe/2fmiX0Od/4adIG X-Google-Smtp-Source: APiQypJ6LpndCSsaLVtlhKBHlp9eaGCW5X4sWsFOYviIcxozIOFzNzeFbo/o4tIItBdR2hhuZbdx5g== X-Received: by 2002:a0c:ffa3:: with SMTP id d3mr8200507qvv.12.1588776783321; Wed, 06 May 2020 07:53:03 -0700 (PDT) Received: from ?IPv6:2600:8806:4000:259:18a5:b227:6d84:c630? ([2600:8806:4000:259:18a5:b227:6d84:c630]) by smtp.gmail.com with ESMTPSA id t12sm1812565qkt.77.2020.05.06.07.53.02 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 06 May 2020 07:53:02 -0700 (PDT) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable From: Nick V Mime-Version: 1.0 (1.0) Subject: Re: [VOTE]: Deprecate _update Endpoint Date: Wed, 6 May 2020 10:53:02 -0400 Message-Id: <51511205-D347-4868-A108-9CC28B4743F3@gmail.com> References: <5b59227d-b386-b9a4-37d7-b61419dc415d@flimzy.com> In-Reply-To: <5b59227d-b386-b9a4-37d7-b61419dc415d@flimzy.com> To: dev@couchdb.apache.org X-Mailer: iPhone Mail (17E262) +1 > On May 6, 2020, at 08:04, Jonathan Hall wrote: >=20 > =EF=BB=BF+1 >=20 >> On 5/6/20 1:57 PM, Jan Lehnardt wrote: >> Hey all, >>=20 >> it appears we missed an item in our 3.0 deprecations list and we should >> clear this up. >>=20 >> We have as of yet failed to capture consensus here about the >> deprecation of the _update endpoint. I think we *have* consensus here, >> but we didn=E2=80=99t make it stick in writing. >>=20 >> To recap: the _update endpoint was added to allow arbitrary data to be >> POSTed to CouchDB and for developers to take whatever and turn that >> into a JSON document that then gets stored into CouchDB. Initially, >> this was added so we can process HTML Form submits. With the advent of >> XHR/fetch in browsers, this is no longer necessary. Another aim at the >> time was allowing legacy data systems that e.g. send XML via HTTP to >> configurable URLs to directly integrate with CouchDB. This is still a >> valid use-case, but easily enough worked around. >>=20 >> There is also a constant level of confusion with the similarly named >> validate_doc_update feature, which enforces access control and schema >> conformity on all document writes. There is no proposal to deprecate >> this feature at this point and the _update endpoint and functionality >> are fully distinct from validate_doc_update. >>=20 >> _update is the logical reverse of a _show and we already have >> deprecated that. It follows that we also deprecate _update for the same >> reasons (which I=E2=80=99m not going to rehash here for the 400th time). >>=20 >> Since this is an API deprecation as per our bylaws[1], please cast your >> votes (or abstain to agree, as per lazy-consensus). >>=20 >> Best >> Jan =E2=80=9CXML, in this economy?=E2=80=9D Lehnardt >> =E2=80=94 >> [1]: https://couchdb.apache.org/bylaws.html#api >>=20