README.md in hana-1.3.1

- old
+ new

@@ -1,12 +1,13 @@
 JSON Patch Tests
 ================
 
-These are test cases for implementations of the [IETF JSON Patch
-draft](http://tools.ietf.org/html/draft-ietf-appsawg-json-patch).
+These are test cases for implementations of [IETF JSON Patch (RFC6902)](http://tools.ietf.org/html/rfc6902).
 
+Some implementations can be found at [jsonpatch.com](http://jsonpatch.com).
 
+
 Test Format
 -----------
 
 Each test file is a JSON document that contains an array of test records. A
 test record is an object with the following members:
@@ -19,13 +20,36 @@
 - disabled: True if the test should be skipped
 
 All fields except 'doc' and 'patch' are optional. Test records consisting only
 of a comment are also OK.
 
-These tests are not complete, or even correct - help welcome!
 
+Files
+-----
 
+- tests.json: the main test file
+- spec_tests.json: tests from the RFC6902 spec
+
+
+Writing Tests
+-------------
+
+All tests should have a descriptive comment.  Tests should be as
+simple as possible - just what's required to test a specific piece of
+behavior.  If you want to test interacting behaviors, create tests for
+each behavior as well as the interaction.
+
+If an 'error' member is specified, the error text should describe the
+error the implementation should raise - *not* what's being tested.
+Implementation error strings will vary, but the suggested error should
+be easily matched to the implementation error string.  Try to avoid
+creating error tests that might pass because an incorrect error was
+reported.
+
+Please feel free to contribute!
+
+
 Credits
 -------
 
 The seed test set was adapted from Byron Ruth's
 [jsonpatch-js](https://github.com/bruth/jsonpatch-js/blob/master/test.js) and
@@ -33,11 +57,11 @@
 
 
 License
 -------
 
-   Copyright 2012 The Authors
+   Copyright 2014 The Authors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at
 
@@ -45,6 +69,7 @@
 
    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
-   limitations under the License.
\ No newline at end of file
+   limitations under the License.
+