KAssistantDialog proposal

[Jaroslaw Staniek]

Matthias,
Thank you for your work.

I'd like to start with these issues:

1. Why the copyright for Olivier Goffart <ogoffart at kde.org> is removed?

2. Use "@return true if a given page is valid"
not "Returns if a given page is valid"

3. What is the idea behind subpage? Have you got any evidence this is used in 
real world? Is this usablility-safe at all? The problem I see is that the 
pages in fact form a graph, not a tree. The entire graph is usually hidden and 
one path is exposed to the user. More work is needed to support this case. 
Maybe a "path" should be a model here. I guess you assumed the graphics on top 
will be always linear.

4. Regarding the image on the left: almost for sure all pages of all assistant 
dialogs should contain the image OR none should containt that. OTOH: The 
dialog has not too much work space when we use both the fancy large top bar 
and left-hand image. Good news is that wit hthe top bar the dialog will be 
wide anyway due to width of the "step names" text.

5. Do you plan to deliver a desting code for real world case with real step 
names, for example "Select Source Database Type". We'd like to see how the 
layout works in practice. Sometimes there will be even 30 letters or more - 
after translation to some languages - I expressed that on IRC :)

6. If the steps in the top bar are clickable, it should be obvious they are 
when I hover my mouse pointer over the area. Maybe make them hyperlinks.

7. Final question: have you tried to set the steps list vertical? This could 
remove the problem with dialog's width. I've seen such implementations 
somewhere. Obviously, eventuallt we'll need ONE type of the assistant steps, 
so it's not a proposal for an option.

-- 
regards / pozdrawiam, Jaroslaw Staniek
  Sponsored by OpenOffice Polska (http://www.openoffice.com.pl/en) to work on
  Kexi & KOffice: http://www.kexi-project.org, http://www.koffice.org
  KDE3 & KDE4 Libraries for MS Windows: http://kdelibs.com, http://www.kde.org