Closed tmtmtmtm closed 7 years ago
Maybe we go all-out with the "wizard" concept, and literally show a sequence of setup steps?
Start with something like:
It’s great that you want to compare Wikidata with a CSV. To get started, you need to complete the following 3 steps:
And then have the instructions we’ve already got, except under numbered headings, and with the CSV step first. And the final step would be a nice big blue "Refresh this prompt" button.
I wonder whether, for each step, we could link to an example from another, already working prompt? So when we say "add a CSV URL" (which is just a link to create a blank template), we could also give a "see an example" link that links to an existing /csv_url
file somewhere else? Because how else are people going to know what to put in /csv_url
and /sparql
?
Ok @tmtmtmtm we’ve "wizardized" the setup steps, making it much more obvious what to do when you first set up the comparison.
The final button is disabled until you’ve completed steps 1 and 2.
Once you’ve generated the comparison the first time, the comparison table appears at the top of the page, and the "information" message disappears…
And the setup steps shuffle down to the end of the page, and are joined by a few handy admin links for further customisation…
Currently, when I set up a new prompt, the page I get looks like:
There are a few ways this could be improved:
Reverse the order of the CSV and SPARQL input.
Add some introductory text.
{{Compare Wikidata with CSV}}
. This is generally going to be quite unexpected, as this "Wizard"-based approach is quite unusual. So it would good if we could be even more explicit about what this tool is/does, as well as what we're expecting people to fill in. Some of that might be a link out to the help page(s), but we can undoubtedly do more to smooth the initial process here.Defer the 'refresh' links until appropriate.