[apps-discuss] [Editorial Errata Reported] RFC6902 (4460)

RFC Errata System <rfc-editor@rfc-editor.org> Sat, 29 August 2015 09:42 UTC

To: pbryan@anode.ca, mnot@mnot.net, barryleiba@computer.org, superuser@gmail.com, alexey.melnikov@isode.com
From: RFC Errata System <rfc-editor@rfc-editor.org>
Message-Id: <20150829094148.9D27F180478@rfc-editor.org>
Date: Sat, 29 Aug 2015 02:41:48 -0700
Archived-At: <http://mailarchive.ietf.org/arch/msg/apps-discuss/E9dlgSIQP2E1nAtAPAcPnypR8S0>
Cc: hairmare@purplehaze.ch, apps-discuss@ietf.org, rfc-editor@rfc-editor.org
Subject: [apps-discuss] [Editorial Errata Reported] RFC6902 (4460)
Precedence: list

The following errata report has been submitted for RFC6902,
"JavaScript Object Notation (JSON) Patch".

--------------------------------------
You may review the report below and at:
http://www.rfc-editor.org/errata_search.php?rfc=6902&eid=4460

--------------------------------------
Type: Editorial
Reported by: Lucas Bickel <hairmare@purplehaze.ch>

Section: 4.1

Original Text
-------------
   However, the object itself or an array containing it does need to
   exist, and it remains an error for that not to be the case.  For
   example, an "add" with a target location of "/a/b" starting with this
   document:

   { "a": { "foo": 1 } }

   is not an error, because "a" exists, and "b" will be added to its
   value.  It is an error in this document:

   { "q": { "bar": 2 } }

   because "a" does not exist.

Corrected Text
--------------
   However, the object itself or an array containing it does need to
   exist, and it remains an error for that not to be the case.  For
   example, an "add" with a target location of "/a/b" starting with this
   document:

   { "a": { "foo": 1 } }

   is not an error, because "a" exists, and "b" will be added to its
   value.  It is an error in this document:

   { "q": { "bar": 2 } }

   because "a" does not exist. Considering a target location of "/a/1"
   it should be not be an error in this document:

    { "a": [ "foo" ] }

    while the same "add" into this document will be an error:

    { "a": [ ] }

    because "/a/0" does not exist.




Notes
-----
Adding to an object has such a nice example that explains the error cases. I think adding to a sequential array should have one as well.

To my understanding this is already pretty clear from RFC6901, I feel it will make the spec easier to implement if we have an example right here.

Instructions:
-------------
This erratum is currently posted as "Reported". If necessary, please
use "Reply All" to discuss whether it should be verified or
rejected. When a decision is reached, the verifying party (IESG)
can log in to change the status and edit the report, if necessary. 

--------------------------------------
RFC6902 (draft-ietf-appsawg-json-patch-10)
--------------------------------------
Title               : JavaScript Object Notation (JSON) Patch
Publication Date    : April 2013
Author(s)           : P. Bryan, Ed., M. Nottingham, Ed.
Category            : PROPOSED STANDARD
Source              : Applications Area Working Group APP
Area                : Applications
Stream              : IETF
Verifying Party     : IESG

[apps-discuss] [Editorial Errata Reported] RFC690… RFC Errata System
Re: [apps-discuss] [Editorial Errata Reported] RF… Barry Leiba
[apps-discuss] [Errata Rejected] RFC6902 (4460) RFC Errata System