Last modified by Vincent Massol on 2024/11/19 16:15

Show last authors
1 {{toc start="2"/}}
2
3 == Current Issues ==
4
5 (% class="row" %)
6 (((
7 (% class="col-xs-12 col-sm-6" %)
8 (((
9 * Users are pressing the "Never" button and don't know how to re-trigger the Distribution Wizard
10 * The position of the "Never" button is in the place that it's usually taken by the "Continue" action, so users that are not careful reading the labels, instinctually press the most convenient location
11 )))
12
13 (% class="col-xs-12 col-sm-6" %)
14 (((
15 {{gallery}}
16 image:dw.png
17 {{/gallery}}
18 )))
19 )))
20
21 == Solutions ==
22
23 === VAR 1: Location ===
24
25 (% class="row" %)
26 (((
27 (% class="col-xs-12 col-sm-6" %)
28 (((
29 {{box}}
30 {{jiraIssues}}
31 XWIKI-10769
32 {{/jiraIssues}}
33 {{/box}}
34
35 * We should change the location of the "Later" | "Never" buttons and separate them from the "Continue" step
36 * We could change the color of the "Never" button into a danger button, suggesting also with color its special state
37 )))
38
39 (% class="col-xs-12 col-sm-6" %)
40 (((
41 {{gallery}}
42 image:var1-1-color.png
43 {{/gallery}}
44 )))
45 )))
46
47 === VAR 2: Confirmation ===
48
49 (% class="row" %)
50 (((
51 (% class="col-xs-12 col-sm-6" %)
52 (((
53 * We could even add a confirmation step for the "Never" button in order to prevent the accidental presses
54 * The "Never" and "Later" steps could be more descriptive and less ambigous
55 * We could use the a generic "Skip" action to launch the confirmation step
56 * Technically, we need to make sure we have all the resources (skin, JS) to add modals in this step
57 )))
58
59 (% class="col-xs-12 col-sm-6" %)
60 (((
61 {{gallery}}
62 image:var2-skip.png
63 image:var2-modal3.png
64 image:var2-replay.png
65 {{/gallery}}
66 )))
67 )))
68
69 === VAR 3: Fallback ===
70
71 (% class="row" %)
72 (((
73 (% class="col-xs-12 col-sm-6" %)
74 (((
75 * In case the user pressed "Never", provide a manual relaunch button in Administration.
76 * This button will delete the [[##status.xml##>>xwiki:Documentation.UserGuide.Features.DistributionWizard||anchor="HThewizardfailstoappearatstartup"]] and this will make the DW appear on the next restart. Careful on [[consequences>>https://forum.xwiki.org/t/10-3-to-10-4-upgrade-no-update-to-ui-flavor-during-distribution-wizard/3140/8]].
77 * Might be problematic to implement this solution since it needs control of filesystem files from the UI.
78 * The button should be placed somewhere in 'Administration - Extensions - Updater', see related [[proposal>>attach:[email protected]]].
79 )))
80
81 (% class="col-xs-12 col-sm-6" %)
82 (((
83
84 )))
85 )))
86
87 === VAR 4: Count ===
88
89 (% class="row" %)
90 (((
91 (% class="col-xs-12 col-sm-6" %)
92 (((
93 * A solution would be to count the times an admin pressed on the "Later" button
94 * After the 3rd time, also show the "Never" button
95 * Since the purpose of "Never" is to not annoy the user displaying the DW on each restart
96 )))
97
98 (% class="col-xs-12 col-sm-6" %)
99 (((
100
101 )))
102 )))
103
104 === VAR 5: Remove ===
105
106 (% class="row" %)
107 (((
108 (% class="col-xs-12 col-sm-6" %)
109 (((
110 * An alternative would be to remove the "Never" button altogether
111 * Since we don't encourage the manual import of XAR and we don't want users to have empty wikis or non migrated content, we could consider that the "Never" use case it's an edge case
112 * **Var 5.1**: Button display configuration
113 ** We could have a configuration in ##xwiki.properties## if the "Never" button should be displayed or not
114 * **Var 5.2**: Force DW
115 ** On the other hand we could have a configuration that will launch the DW no matter what was pressed. This will control the presence of the DW from configurations and not UI.
116 )))
117
118 (% class="col-xs-12 col-sm-6" %)
119 (((
120
121 )))
122 )))

Get Connected