Discussion:
[xwiki-devs] Home Page - Use cases, proposals, what we have until now and what we want to achieve
Eduard Moraru
2014-10-08 13:48:31 UTC
Permalink
Hi devs,

We have already had some discussions recently on how we can improve XWiki's
homepage.

After talking to Vincent in private, we have decided to come up with a set
of use cases/goals[1] that we want to have/achieve with the improvement of
the homepage so that we make sure that we all speak the same language and
consider all use cases when proposing something.

On the same page as the use cases[1], you have a link below for the
existing proposals[2] and each proposal that was discussed until now (I
added one too) is listed and compared to the use cases it had to cover.

Please have a look and tell us what you think about the use cases and the
analysis of each proposal.

This is not yet a vote, but just an attempt to get everybody on the same
boat in terms of expectations.

Thanks,
Eduard

----------
[1] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageUseCases
[2] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageProposals
Denis Gervalle
2014-10-08 14:03:10 UTC
Permalink
Hi Edouard,

I have started reading those proposals, and I am puzzled since the
proposals does not seems fully in relation with the UC described. Proposals
talk about UC1 to UC6 while only UC1 to UC5 are described.
Regards,
Post by Eduard Moraru
Hi devs,
We have already had some discussions recently on how we can improve XWiki's
homepage.
After talking to Vincent in private, we have decided to come up with a set
of use cases/goals[1] that we want to have/achieve with the improvement of
the homepage so that we make sure that we all speak the same language and
consider all use cases when proposing something.
On the same page as the use cases[1], you have a link below for the
existing proposals[2] and each proposal that was discussed until now (I
added one too) is listed and compared to the use cases it had to cover.
Please have a look and tell us what you think about the use cases and the
analysis of each proposal.
This is not yet a vote, but just an attempt to get everybody on the same
boat in terms of expectations.
Thanks,
Eduard
----------
[1] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageUseCases
[2] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageProposals
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
--
Denis Gervalle
SOFTEC sa - CEO
Eduard Moraru
2014-10-08 14:12:04 UTC
Permalink
Hi Denis,

I had failed to add the 6th use case (about flavors and overriding the
homepage) when I moved the content to design.xwiki.org

Thanks for noticing it and taking the time to read everything,
Eduard
Post by Denis Gervalle
Hi Edouard,
I have started reading those proposals, and I am puzzled since the
proposals does not seems fully in relation with the UC described. Proposals
talk about UC1 to UC6 while only UC1 to UC5 are described.
Regards,
Post by Eduard Moraru
Hi devs,
We have already had some discussions recently on how we can improve
XWiki's
Post by Eduard Moraru
homepage.
After talking to Vincent in private, we have decided to come up with a
set
Post by Eduard Moraru
of use cases/goals[1] that we want to have/achieve with the improvement
of
Post by Eduard Moraru
the homepage so that we make sure that we all speak the same language and
consider all use cases when proposing something.
On the same page as the use cases[1], you have a link below for the
existing proposals[2] and each proposal that was discussed until now (I
added one too) is listed and compared to the use cases it had to cover.
Please have a look and tell us what you think about the use cases and the
analysis of each proposal.
This is not yet a vote, but just an attempt to get everybody on the same
boat in terms of expectations.
Thanks,
Eduard
----------
[1] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageUseCases
[2] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageProposals
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
--
Denis Gervalle
SOFTEC sa - CEO
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
Eduard Moraru
2014-10-13 08:48:49 UTC
Permalink
Bumping this thread so we strike while the iron is hot.

Any notes on the existing proposals? Anything to add, anything to remove?
Is that the best we can do?

If the answers are "no, no, yes" then is it the time to move to a vote with
the current proposals?

Thanks,
Eduard
Post by Eduard Moraru
Hi Denis,
I had failed to add the 6th use case (about flavors and overriding the
homepage) when I moved the content to design.xwiki.org
Thanks for noticing it and taking the time to read everything,
Eduard
Post by Denis Gervalle
Hi Edouard,
I have started reading those proposals, and I am puzzled since the
proposals does not seems fully in relation with the UC described. Proposals
talk about UC1 to UC6 while only UC1 to UC5 are described.
Regards,
Post by Eduard Moraru
Hi devs,
We have already had some discussions recently on how we can improve
XWiki's
Post by Eduard Moraru
homepage.
After talking to Vincent in private, we have decided to come up with a
set
Post by Eduard Moraru
of use cases/goals[1] that we want to have/achieve with the improvement
of
Post by Eduard Moraru
the homepage so that we make sure that we all speak the same language
and
Post by Eduard Moraru
consider all use cases when proposing something.
On the same page as the use cases[1], you have a link below for the
existing proposals[2] and each proposal that was discussed until now (I
added one too) is listed and compared to the use cases it had to cover.
Please have a look and tell us what you think about the use cases and
the
Post by Eduard Moraru
analysis of each proposal.
This is not yet a vote, but just an attempt to get everybody on the same
boat in terms of expectations.
Thanks,
Eduard
----------
[1] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageUseCases
[2] http://design.xwiki.org/xwiki/bin/view/Proposal/HomepageProposals
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
--
Denis Gervalle
SOFTEC sa - CEO
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
Guillaume "Louis-Marie" Delhumeau
2014-10-13 09:27:10 UTC
Permalink
Hi.

= Proposal 1 =
Still too technical IMO.
The first time you edit a page, you edit either the Sandbox or the Main
page. When you do it, you expect to learn once for all how to edit a page.

But what happens: you are not editing a page but using the Dashboard
application. Even worse: you are not using the dashboard macro, you are
including it via a macro and you cannot change it directly in the WYSWYG
editor.

Conclusion: too much concepts to learn and nothing feels "natural". We are
far far away from the "iPhone experience" where everything feels so
natural: start an application, scroll inside a window, resize an image...

I think the natural way to discover a wiki is (in this order):
1 - Learn to edit a page
2 - Then learn what is a space and a wiki
3 - Discover the other content (ie: navigation)
4 - Learn how to use the other applications
5 - Customize the home page

Moving from one step to the other should be easy. That is how I expect a
wiki to work, and this was basically the first things I have done when I
have started XWiki the first time (+ going to the administration to
discover all the options).

= Proposal 2 =

It is a bit like a workaround. Everything is complex but we offer an helper
to easily replace the content of the home page. It does not fix the problem
we have with the dashboard application or the wysiwyg editor, but it is a
bit less terrible that what we have today.

= Proposal 3 =

To me it is the best option. A very simple page (KISS) that explains what
the wiki is, and that the user is not afraid to edit (like the Sandbox)
even if we should encourage the user to use the sandbox to do her tests.

The user could still go to the dashboard application to enjoy all its
features, and it could make it more clear that the Dashboard is a special
application with a special editing : it is on its own space and we discover
it after having learnt how to do basic stuffs.

It does not fix all the use cases though.

= Proposal 4 =

Retro-compatibility issue but I like it + a button on every page "set me as
the main page" (like the "fork me on github" buttons).

But this proposal is not enough.

= Proposal 5 =

I like it. Even if I don't like the wizards in general, I think it is still
the best option regarding the complexity of XWiki.

= Conclusion =

To me the solution is a mix of P3, P4 and P5. Of course P1 should be fixed
too,
but it is not the priority to make XWiki easier to use.

Thanks,
Guillaume
Jeremie BOUSQUET
2014-10-13 14:16:52 UTC
Permalink
Hi all,

After having read all proposals, personally I prefer proposal #1.
To avoid issue with editing dashboard as it is included from another page,
I would clearly remove this inclusion and make Main.WebHome a real
(autonomous) dashboard with no link with Main.Dashboard. There is room for
2 dashboards (the wiki dashboard and the wiki home page dashboard :) ).
I prefer this proposal because it improves long-running "issues" (or
limitations) of the wysiwyg editor, which on another side is great.

I also prefer it because IMHO editing macros should feel natural in XWiki
because they are a great feature and there is / should be nothing technical
with a rendering macro.
For wysiwyg/inline, I'm not sure why, when you are not advanced user, you
can't choose between both. To me "edit" action should default to wysiwyg
(or wiki depending on configuration), and IF there is some content that can
be edited inline, you should have something else to click (button, link,
pencil icon ...) to edit it "inline" and it switches the whole page to
inline mode.
Also "Edit / Inline form" is weird name in some cases, when I edit inline
the dashboard, I don't feel I'm editing a form...

Proposal #2: to me a proper UI for the include macro configuration in
wysiwyg (so, proposal #1), could in the end be very similar to this
proposal (like, I click edit, it opens wysiwyg, I click edit on include
macro, and I can select a page from a list or table or a page suggest or
whatever).

Proposal #3: I like the part about explaining the concepts, but it could be
done without removing the dashboard, in fact it seems to be 2 different
things. Also it's nice to have those descriptions on home page, but when
first user has read them (wether he's the admin or not), when he customize
the page he will remove them and ... they'll be lost for all other users ?
I'd prefer to have a question-mark icon somewhere to click to get some
help, that would start with explaining xwiki concepts, and then provide
some links to go deeper.

By the way it's surprising, on a fresh XWiki install, to see that there is
no "help" entry nowhere in the UI, not any question-mark icon, or help menu
entry. You get some help only once you edit a page, and only on wiki syntax.
There is the "Getting started" link on the default home page, but it
contains mainly a screenshot of the default home page (that I could have
changed already, so for new comers of my site, this getting started would
be confusing) with some numbers, difficult to consult as I have to scroll
to see the numbers and their description.
To me xwiki is not just a site or just a wiki, it's a highly interactive
site, with many features from "basic" to "very advanced": it deserves a
better help system ;-)
(note: just discovered the help center proposal [1] below, see comments on
proposal #5 also)

Proposal #4: I don't see how it solves issue with editing home page, it
merely simplifies peeking any page as a home page.
Along with proposal #2, I would say that everyone seem to find that there
are too many concepts, too technical, etc, but those proposals continue to
add new concepts on top of existing ones, and are pretty much useless if
it's deadly simple to edit an include macro.
Also I find it buries navigation inside configuration, and destroys habit
of current users about "WebHome is a home page".
It also seems like a workaround, like: "if it's hard to edit a page, peek
another one".

Proposal #5: I really like the Help Center proposal [1] in fact :) But I
think it's // with other proposals in fact, having more help won't solve
home page editing issues, but it could greatly improve overall end-user
experience (in any case).

BR,
Jeremie

[1] - http://design.xwiki.org/xwiki/bin/view/Improvements/HelpCenter


2014-10-13 11:27 GMT+02:00 Guillaume "Louis-Marie" Delhumeau <
Post by Guillaume "Louis-Marie" Delhumeau
Hi.
= Proposal 1 =
Still too technical IMO.
The first time you edit a page, you edit either the Sandbox or the Main
page. When you do it, you expect to learn once for all how to edit a page.
But what happens: you are not editing a page but using the Dashboard
application. Even worse: you are not using the dashboard macro, you are
including it via a macro and you cannot change it directly in the WYSWYG
editor.
Conclusion: too much concepts to learn and nothing feels "natural". We are
far far away from the "iPhone experience" where everything feels so
natural: start an application, scroll inside a window, resize an image...
1 - Learn to edit a page
2 - Then learn what is a space and a wiki
3 - Discover the other content (ie: navigation)
4 - Learn how to use the other applications
5 - Customize the home page
Moving from one step to the other should be easy. That is how I expect a
wiki to work, and this was basically the first things I have done when I
have started XWiki the first time (+ going to the administration to
discover all the options).
= Proposal 2 =
It is a bit like a workaround. Everything is complex but we offer an helper
to easily replace the content of the home page. It does not fix the problem
we have with the dashboard application or the wysiwyg editor, but it is a
bit less terrible that what we have today.
= Proposal 3 =
To me it is the best option. A very simple page (KISS) that explains what
the wiki is, and that the user is not afraid to edit (like the Sandbox)
even if we should encourage the user to use the sandbox to do her tests.
The user could still go to the dashboard application to enjoy all its
features, and it could make it more clear that the Dashboard is a special
application with a special editing : it is on its own space and we discover
it after having learnt how to do basic stuffs.
It does not fix all the use cases though.
= Proposal 4 =
Retro-compatibility issue but I like it + a button on every page "set me as
the main page" (like the "fork me on github" buttons).
But this proposal is not enough.
= Proposal 5 =
I like it. Even if I don't like the wizards in general, I think it is still
the best option regarding the complexity of XWiki.
= Conclusion =
To me the solution is a mix of P3, P4 and P5. Of course P1 should be fixed
too,
but it is not the priority to make XWiki easier to use.
Thanks,
Guillaume
_______________________________________________
devs mailing list
http://lists.xwiki.org/mailman/listinfo/devs
Guillaume "Louis-Marie" Delhumeau
2014-10-14 09:40:34 UTC
Permalink
Hello.

I have again a new argument against using the dashboard and the include
macro in the main page.

When the user uses the "Inline" editor to change some gadgets, she can not
use the rollback action of the main page to cancel her changes. She has to
go to the Dashboard page first, and then rollback her changes from there.

Having an include macro in the default page is absolutely not intuitive,
even if you make it appears more clearly.

Thanks,
Guillaume

Loading...