OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

cmis message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


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



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

David Caruana commented on CMIS-110:
------------------------------------

The parents mapping has been the cause of much confusion for our community.

Is it possible to simplify it to the notion of just 'parent'? The difficulty is in supporting multi-filing, but that can be made the exception.

Ideally, we'd end up with a single rel-type too. Perhaps there's already one for 'parent', as this seems like a broad use case. In fact, I thought I heard at one of the CMIS meetings/calls there was work on defining hierarchy support in ATOM. Perhaps we should utilize that work. Where can we find out about that work?


> 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

        


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]