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 [email protected] http://www.thib-d.com Skype : thibaut.deveraux @ Bricks, design et accompagnement projet [email protected] 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 <[email protected]> > 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 > _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
