Nov 30, 2007

Eclipse Demo Camp, Bangalore


Eclipse Demo Camp is coming to Bangalore on 10th Dec. Looking at other Demo Camps, Bangalore might be the one with highest number of registration (around 50) - and its still growing. In case you wish to attend, do register here.

Yup, I'm working on a presentation on GEF. Meet you all there.

Nov 5, 2007

JFace Wizard Guidelines

During Eclipse Plugin Developement training, I always end JFace Wizards session with these guidelines:

  1. Wizards should be aimed for minimal user interaction
  2. Wizard pages can be filled with meaningful defaults
  3. When a Wizard is shown it should not contain any errors. They should appear only after a user interaction
  4. Present Errors/Warnings in the tab order of the fields
  5. When a task is split into steps, a wizard page can model a step and shouldn't be doing more things
  6. Don't create pages that needs scrolling. In general if a wizard's height is greater than its width, probably it needs a review
  7. Total number of Wizard pages should be ~ 5
Once when I finished explaining them, one smart guy said: "Have you ever looked at the New Java Project Wizard?". True. The first page of that wizard doesn't comply with the Guideline #6. These points are not official standards, mere guidelines by me, but still I think they are good. So what is the problem with the New Java Project Wizard and how can it be better?

The options in the first page falls into three categories:
  1. Resource: Project name, location & working sets
  2. Compiler: Source folders
  3. Runtime: JRE & Execution env.

Ideally the first page should just give the resource related options and the others can be pushed to second page/elsewhere. Since the second page allows the user to configure the JRE, source & binary folder, I guess we are not loosing any functionality if we get rid of those options. If the first page is cleaned up to have only resource related options, this is how it would look like:




in contrast to the current: