On 01/07/2011 04:53 PM, Ecaterina Moraru (Valica) wrote: > Hi, > > We are using mixed naming when referring to a document/page, not only on > different pages, but also in the same context (Rename step for example). > There is also an issue referring to this problem > XWIKI-5401<http://jira.xwiki.org/jira/browse/XWIKI-5401>and we need to > find an answer in order to move forward consistency. > > So the question is which version we prefer: "Page" or "Document" ? > > I'm voting +1 for "Page". > > "Page" is more used IMO, especially in the "Space"/"Page" context. > "Page" is more general than "Document" and better fitted for a platform that > encapsulates all kind of content (not just documents).
Internally it will always be Document. Page is Visual. Document is Data. Sure, Page sounds simpler and more familiar to users, but using the wrong term models one's way of thinking. Q: What is bin/login/XWiki/XWikiLogin ? Semantically, it's an action. Internally, there's no document there. Visually, I'd say it's a page, but there's no Document to manipulate, there's no copy, rename, delete, edit. Q: What is bin/Search?text=gold ? Semantically, it's still an action. Internally, there is a document. Visually, it's again a page, but you can reach the document behind it. Q: What is bin/Search?text=love ? It's a different page, but it's the same document. A document can appear as many pages, but when you act on it (edit/copy/delete), you act on the document, not on the page. Q: What is bin/get/XWiki/LiveTableResults?some=params ? Semantically, it's a service. Internally, there's a document. Visually, it doesn't appear at all, since it's used behind the scenes, but you can "see" it as a plain document when using the /view/ action. Q: What is bin/Blog/BlogIntroduction ? Semantically, it's data stored inside a document. Internally, it's data stored in a document. Visually, you can see it either as a page or a document, and the term that is used throughout the wiki will move the balance one way or the other. Page and Document are not the same thing. It may seem that they are initially, but the more you understand the difference, the better you can understand how XWiki works, and you better understand the XWiki way of working. When you browse XWiki *web pages*, you navigate through XWiki documents. +1 for Document. -- Sergiu Dumitriu http://purl.org/net/sergiu/ _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
