So it is a question about the dev documentation only ? Is it ok to say this : - end user will always see "page", - devs will see "page" for user interface and "document" for data ? As long as the end user does not have to deal with complicated concepts it is ok for me. Thx Thibaut DEVERAUX Tel : 06 75 51 20 80 thibaut.deveraux@gmail.com http://www.thib-d.com Skype : thibaut.deveraux @ Bricks, design et accompagnement projet t.deveraux@bricks-studio.com Découvrir Bricks : bricks-studio.com L'actualité du studio sur notre blog : bricks-it.com Se renseigner sur le design : design-keys.org 2011/1/9 Sergiu Dumitriu <sergiu@xwiki.com>
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 devs@xwiki.org http://lists.xwiki.org/mailman/listinfo/devs