[
https://issues.apache.org/jira/browse/OAK-11?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13434021#comment-13434021
]
Mete Atamel commented on OAK-11:
--------------------------------
I also agree that JSOP or the "diff format" is not clear from MicroKernel API
and it should be clearly documented. Here are some examples:
-What's the difference between "^fuu/bar" : 42" and "+fuu/bar": 42?
-In "^fuu/bar: 42", if fuu or bar does not exist yet, what happens?
-In "+fuu/bar: 42", if fuu/bar already exists, what happens?
-In "-fuu", if fuu does not exist, what happens?
> Document and tighten contract of Microkernel API
> ------------------------------------------------
>
> Key: OAK-11
> URL: https://issues.apache.org/jira/browse/OAK-11
> Project: Jackrabbit Oak
> Issue Type: Improvement
> Components: mk
> Reporter: Michael Dürig
> Assignee: Julian Reschke
> Labels: documentation
>
> We should do a review of the Microkernel API with the goal to clarify,
> disambiguate and document its contract.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira