On Thu, Sep 17, 2015 at 3:54 PM, vincent(a)massol.net <vincent(a)massol.net>
wrote:
On 17 Sep 2015 at 13:32:28, Eduard Moraru (enygma2002(a)gmail.com(mailto:
enygma2002(a)gmail.com)) 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.
Actually my intent was to minimise verbosity here as well. I was simply
thinking of "subspace", since it is completely equivalent (in any way) with
"Nested Space" and with the above mentioned verbose alternatives.
Thanks,
Eduard
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
_______________________________________________
devs mailing list
devs(a)xwiki.org
http://lists.xwiki.org/mailman/listinfo/devs