[ 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