[xwiki-devs] [Proposal] Resource vs Item vs ItemResource vs Model & Name vs Path vs Reference

Hi devs, We need to decide if we want to keep the current: ResourceName, DocumentName, SpaceName, WikiName, AttachmentName or instead use a variation. There are 2 things to decide: - The prefix for the base object (Resource, Item, Model, etc) - The suffix (Name, Path, Reference, etc) Proposal ======= I'd like to propose ModelReference for the base object and then DocumentReference, SpaceReference, WikiReference, AttachmentReference. Note: This is different from Identity which is unique (a UUID). References do not point to unique objects. Reference makes sense to me since it means what it means... :) For example the API: Document getDocument(DocumentReference) is pretty clear IMO. Path is too physical to me. In JCR it's called getPath() but it returns a string with a path, for ex "/wiki/space1/space2/document". This is not our case. IMO our Reference would transform into a path when serialized only. Name isn't too bad, it would be my second choice. But it doesn't show the fact that it's a ... reference... ;) WDYT? Thanks -Vincent