[OASIS Issue Tracker] Commented: (CMIS-110) Clarify the use of theterm Parent and Parents throughout the rest section.

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/CMIS-110?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=10096#action_10096 ] 

Florent Guillaume commented on CMIS-110:
----------------------------------------

My understanding is that:

- a fileable object has a link rel="cmis-parents" to a Feed that's the set of parents (ex: $SERVER/atom/parents/${objectid})

- a Folder has a link rel="cmis-parent" to an Entry for the parent Folder. Note that in the examples this is called "cmis-parent" but in the spec seems to be called "cmis-folderparent" so this is inconsistent.


Note that the spec (p. 11) says "Folder (Entry)" but then goes on to say "this is exposed as a Feed" so I'm not sure if:
  1. a Folder is always exposed as a Feed (basically this is the same Feed as the one for cmis-children)
  2. a Folder is exposed as an Entry in some cases (cmis-parent would be one), and as a feed in others (cmis-children).

> Clarify the use of the term Parent and Parents throughout the rest section.
> ---------------------------------------------------------------------------
>
>                 Key: CMIS-110
>                 URL: http://tools.oasis-open.org/issues/browse/CMIS-110
>             Project: OASIS Content Management Interoperability Services TC
>          Issue Type: Bug
>          Components: REST/AtomPub Binding
>    Affects Versions: Draft 0.50
>            Reporter: Ryan McVeigh
>            Assignee: Al Brown
>
> In part II, if you search on the word parent throughout the doc, you'll get a confusing variety of results. 
>    1.  In the resource table p13, it's defined as a Feed w/ the following for GET: getDocument-Parents or getFolder-Parents with returnToRoot
>    2. In the link table p15, the description is consistent, but under folder it says "(Parent Folder) Link is not available on root folder's or objects that do not have parents"
>          1. "Parent Folder" is singular, should it be plural? or would this be an Entry?
>          2. "folder's", is that possesive, if so confused, or plural...
>          3. for Type (Type of P) see issue 101.
>    3. p26 defines the method "getFolderParent" - should this be plural, a Feed?
>          1. is it assumed that folders can only have one direct parent and documents can have multiple?
>    4. p27 defined getObjectParents
>          1. p40 has <link rel="cmis:getdocumentparents" <- shouldn't that be cmis-parents?

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira