On 17 Sep 2015 at 13:32:28, Eduard Moraru ([email protected](mailto:[email protected])) wrote:
> With the introduction of Nested Spaces / Nested Documents, we find > ourselves having to expand our terminology to accommodate the tree-like > structure of spaces/documents that we are managing. > > IMO, we have started going in the wrong direction with using standard tree > terminology directly in XWiki's UI, introducing new terms that simple users > could be easily confused by or overwhelmed (this adding to the already > existing ones). > > The specific issue I have in mind is how do we refer child entities for > each concept (wiki, space, page) and how does this scale when the hierarchy > increases. > > What I propose is that we Keep It SSimple (*™*) :) and just use the "sub" > prefix for the concept at hand. > > Examples: > * wiki -> subwiki (here we can continue using "wiki", as discussed > previously [1], since we don`t actually support nested wikis yet, but if > "subwiki" is used in a conversation it still makes perfect sense) > * space -> subspace [2] > * page -> subpage [3] > > The problem with the term "child", as pointed out by Marius in an offline > chat, has indeed the issue that it can only be applied correctly for first > level descendants, after which it becomes inaccurate, since starting with > the second level the term "descendant" is more appropriate. > > All of this becomes unnecessarily complicated and, IMO, we should avoid > dealing with it by using the "sub" prefix which is much easier to grasp and > accept. > > On a similar note, I also find the term "nested" to be a bit unnecessarily > complicated, specially for non-technical and non-english native users. On this point, I find it nice to be able to say “Nested Spaces” and understand what it means. What’s your recommendation? Saying “A Space contained inside of other Spaces” is bit too verbose when talking about the feature. Similary saying “A space with subspaces” or “A Space inside a Space” are too verbose too. Hierarchical Spaces would be another valid term but I find Nested Spaces easier to pronounce and we’ve started using it across the board and I don’t feel the cost of changing everywhere would justify the move to Hierarchical Spaces :) In addition this is not a term used in the UI so it’s mostly an issue for documentation (which doesn’t mean it’s not important). Thanks -Vincent > WDYT? > > Thanks, > Eduard > > ---------- > [1] http://markmail.org/message/cehvpds5qmljq5f7 > [2] https://en.wikipedia.org/wiki/Subspace > [3] https://en.wikipedia.org/wiki/Subpage _______________________________________________ devs mailing list [email protected] http://lists.xwiki.org/mailman/listinfo/devs
