9 Jan
2011
9 Jan
'11
4:43 a.m.
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/