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.
I’m not sure about this. I think Children could be used generically to mean any
level of Children but would need to be checked.
>
> 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.
>
> WDYT?
I don’t like the “Sub" terminology because it’s incomplete. It’s not complete
because you still need words for Parents, Siblings, Root, etc.
I'd much prefer to use a standard Tree terminology:
https://en.wikipedia.org/wiki/Tree_(data_structure)#Terminologies_used_in_Trees
BTW Terminal Page could be replaced by Leaf Page if we wanted too but maybe
that’s too technical?
I’d be ok to replace subwiki by Child Wiki/Children Wikis to be consistent.
So overall I find Child/Children, Parent, and Siblings very easy to understand
by any simple user. I find that using Sub, Parent, Siblings is not better (and
it would certainly not replace Sibling).
WDYT?
Thanks
-Vincent
> 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
