Description

Main problems found:
  

• Dated and non-standard UI elements
• Step count not sequential
• Intro text very long
• Bottom button bar have a non-standard sequence of buttons
• Some buttons disappear during interaction

Main Proposal

Cleaner layout, easier to adapt to different scenarios.

Improvements for Previous Issues

XWIKI-10769

Changed the order of the buttons. The main action will always be on the right, while all "Later" related option were moved to the left so they conflict with each other.

With the menu opened:

XWIKI-9818, XWIKI-9112

XWIKI-9818: Be able to manually trigger a canceled DW from UI

XWIKI-9112: Add a way to restart a skipped DW without restarting XWiki

For these issues, we could show a custom page designed only for this very specific scenario. In this page, we explain why the page is empty and invite the user to launch the DW again OR to leave it like that (permanently or not).

Problem: What are all the conditions for this page to appear? 

XWIKI-20688, XWIKI-14726

XWIKI-20688: "Distribution Wizard should suggest a long-term account for Administrator"

XWIKI-14726: "The DW should make more clear that it create an owner user"

Changed the intro text for Admin user a bit. The proposal here is to explicitly say the type of user that's being created.

XWIKI-20714, XWIKI-17600

XWIKI-20714: Upgrade: Dist Wizard should show that some steps are done

XWIKI-17600: Distribution Wizard shows 4 steps but then displays a fifth one for the report

The steps from DW are the actual, needed ones. For this, the navbar for the steps should be dynamic, based on the work that's needed to be done.

This should be further analyzed to find the best technical implementation.

XWIKI-22704

XWIKI-22704: "The distribution wizard header feels out of place with the current XWiki LnF"

New, simpler layout that doesn't use any special header.

XWIKI-17840

XWIKI-17840: Display a progress indicator in the distribution wizard step for the flavor pick

This Jira is being handled by this proposal.

XWIKI-17251

XWIKI-17251: Make it harder for users to pick an empty wiki when selecting the flavor

Further Improvements

Using during Onboarding

With the improvements mentioned above, the Distribution Wizard could also support the onboarding experience in XWiki by presenting a short, slide-based introduction for new or occasional users, highlighting key interaction patterns in the interface.
For this to work effectively, the DW should be able to open in a modal view, allowing users to quickly dismiss it if they prefer to skip the guided tour.

In this context, the layout would be adjusted and the default header removed, displaying only the title, description, inner content, and the toolbar.

Disable Continue button instead of hiding it

Currently, during the Distribution Wizard process, the Continue button is hidden and the "Register" button takes the priority. While understandable in terms of only having one primary button, this makes it "switch places" making it harder to be perceived as a continuation of the process.

Current behavior:

Proposal:

Both buttons are visible, but only one of them is active

After filling the form and submitting the register button disappears and users can continue the process: