[jwt-dev] AW: Comments about the tutorial

["Florian Lautenbacher" <florian.lautenbacher@xxxxxxxxxxxxxxxxxxxxxxxxxx>]

Hi Mickael,

thanks for your feedback concerning the tutorial. Yes, you are right. The
section about guards is really not very clear, so I will create some
screenshots similar to yours (maybe with other colors ;-) and try to
describe it with a sequence and a small paragraph of clear words.
Yes, any feedback concerning the user interface is welcome. We can either
start discussing it on the mailing list (which probably makes it difficult
to capture the results of the discussion for each topic) or discuss it on
the mailing list however notifying the others each time the page has changed
and feedback is welcome. I would prefer the second alternative. The results
of the discussion can then be included into Bugzilla for the developers.

I'm looking forward to an interesting discussion!

Best regards,

Florian

-----Ursprüngliche Nachricht-----
Von: Mickael Istria [mailto:mickael.istria@xxxxxxxxxxx] 
Gesendet: 22 February 2008 11:46
An: florian.lautenbacher@xxxxxxxxxxxxxxxxxxxxxxxxxx; Java Workflow Toolbox
Betreff: Comments about the tutorial

Hello,

As I said before, there are not a lot of things to criticize about your
tutorial...

Most of remarks I had were due to the fact that when I started to follow the
tutorial, I pressed Enter on the New Workflow wizard, so that it finished
the wizard instead of continuing it as if I clicked on Next. 
Then, there is no problem of "unmatching" windows between program and
tutorial.

About the tutorial, the only remark I can do is that the page that explains
how to make a guard is less clear than the rest of the tutorial. It gives
the impression that guards are complicated (whereas it is not). I attached a
screenshot that, in my opinion, would be more an easier HOWTO (I choosed the
colors according to my today mood, thus you should focus on the
understandability rather than the beauty ;).
I think that such a picture with
  1. A general sentence to textually explicit the steps
  2. A paragraph to explain the syntax of conditionals would be better than
a page of text.


I have a dozens of suggestions about the MMI. For instance, suggestions
about the toolbar layout to make the interface more natural and easy for
users. Do you think I should list them on a JWT wiki page, so that everyone
concerned with the project could give his opinion about specific
suggestions?


Mickaël