[couchdb-documentation] branch master updated: POST /dbname should not return ETag response header (#139)

[wo...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wohali pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git


The following commit(s) were added to refs/heads/master by this push:
     new b772caa  POST /dbname should not return ETag response header (#139)
b772caa is described below

commit b772caad4f17cf9ac8e6164aae103fec7bab81c6
Author: Robert Newson <rn...@apache.org>
AuthorDate: Wed Jul 19 20:08:29 2017 +0100

    POST /dbname should not return ETag response header (#139)
    
    * POST /dbname should not return ETag response header
    
    as it relates to a different resource.
    
    Note: We used to send ETag for this in previous releases, so it's
    technically a regression even though we accidentally fix a spec
    violation.
    
    Closes #620
    
    * Document loss of ETag in POST as breaking change in 2.0
---
 src/api/database/common.rst |  2 --
 src/whatsnew/2.0.rst        | 12 ++++++++++++
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/api/database/common.rst b/src/api/database/common.rst
index 5178535..45a6e18 100644
--- a/src/api/database/common.rst
+++ b/src/api/database/common.rst
@@ -292,7 +292,6 @@
       <api/doc/batch-writes>` Possible values: ``ok``. *Optional*
     :>header Content-Type: - :mimetype:`application/json`
                            - :mimetype:`text/plain; charset=utf-8`
-    :>header ETag: Quoted new document's revision
     :>header Location: Document's URI
     :>json string id: Document ID
     :>json boolean ok: Operation status
@@ -328,7 +327,6 @@
         Content-Length: 95
         Content-Type: application/json
         Date: Tue, 13 Aug 2013 15:19:25 GMT
-        ETag: "1-9c65296036141e575d32ba9c034dd3ee"
         Location: http://localhost:5984/db/ab39fe0993049b84cfa81acd6ebad09d
         Server: CouchDB (Erlang/OTP)
 
diff --git a/src/whatsnew/2.0.rst b/src/whatsnew/2.0.rst
index c82ab8f..1f70841 100644
--- a/src/whatsnew/2.0.rst
+++ b/src/whatsnew/2.0.rst
@@ -137,3 +137,15 @@ in time for the 2.0.0 release:
 .. _known issues: https://s.apache.org/couchdb-2.0-known-issues
 .. _CouchDB JIRA instance: https://issues.apache.org/jira/browse/COUCHDB
 .. _CouchDB GitHub Issues: https://github.com/apache/couchdb/issues
+
+.. _release/2.0.x/breakingchanges:
+
+Breaking Changes
+================
+
+The following changes in 2.0 represent a significant deviation from
+CouchDB 1.x and may alter behaviour of systems designed to work with
+older versions of CouchDB:
+
+* :ghissue:`620`: ``POST /dbname`` no longer returns an ETag reponse header,
+  in compliance with RFC 7231, Section 7.2.

-- 
To stop receiving notification emails like this one, please contact
['"commits@couchdb.apache.org" <co...@couchdb.apache.org>'].