Skip to content

Create a debate configuration wizard #38

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Mateusz-Dobrzynski opened this issue May 1, 2024 · 6 comments
Open

Create a debate configuration wizard #38

Mateusz-Dobrzynski opened this issue May 1, 2024 · 6 comments
Labels
enhancement New feature or request

Comments

@Mateusz-Dobrzynski
Copy link
Member

Mateusz-Dobrzynski commented May 1, 2024

Proposed changes
When the Oxford Debate Conduction button is clicked, a step-by-step configuration process is started. The user can navigate the wizard back and forth, as well as skip to the final screen (i.e. current configuration view). Less obvious aspects of the configuration can be explained in their respective views (with flavor texts and a hint button perhaps?):

  1. Pick debate preset (create debate configuration presets #5)
  2. Speech time (with minutes strings changing from singular to plural or in some other way avoiding the bug described in Translate the "minutes" string in debate configuration #36)
  3. Protected time (beginning/end/both, duration)
  4. Visual indication of protected time (with a clock preview)
  5. Beeps
  6. Ad vocem (enabled/disabled, duration)
  7. Logos with a debate page preview (Submit custom logos #35)
    • Logo below the clock
    • Proposition logo
    • Opposition logo
  8. Teams position with a preview (Change position of the clock relative to the teams #27 and swap team names in debate setup page #31)
  9. Summary – given how many steps there are, the user should be able to edit the configuration in the final view. Going multiple steps back to fix something would be infuriating

Rationale
As the list shows, there are already quite a few configuration options with more to come. Such an abundance could cause a headache to new users, even more so to beginning debaters. A configuration wizard would make it easier to understand and navigate. We want to make debating approachable, after all ✨

@Mateusz-Dobrzynski Mateusz-Dobrzynski added the enhancement New feature or request label May 1, 2024
@jakubmanczak
Copy link
Member

Along with this, I feel like the menu would benefit from a little restructuring.

image

Currently, under the "Debate Tools" header, we have three buttons corresponding to each distinct debate "tool" – debate conduction (should probably be renamed to debate clock??),
the debate motion generator & the tournament planner. The sound preview only has to do with the first one, and occupies space. Maybe it should be moved to some option under the clock settings after this "wizard" view is complete?

~jm

@Mateusz-Dobrzynski
Copy link
Member Author

I'm all for all of the above. What about Tournament Planner? Do we want to keep it there?

@jakubmanczak
Copy link
Member

As a link I'd say yeah, why not?

@jakubmanczak
Copy link
Member

This being said, there might also be merit in a standalone bell tool? Maybe it should just be renamed instead od being removed. 🤔

@Mateusz-Dobrzynski
Copy link
Member Author

As the name suggests, its designed use case is sound demonstration at the beginning of the debate. Marshalls always demonstrate signals indicating the protected time and the end of the speech, be it ringing a physical bell or knocking on the table. There should be a way to demonstrate the sounds produced by the app and be easily accessible once the debate is configured. On a related note, configuring the debate, retracting from the debate clock to the main menu, opening the sound demo to present the signals, and then opening the clock again to conduct the debate surely is burdensome.

But the sound demonstration button doesn't have to be in the main menu. It can be anywhere else within the debate clock, as long as it makes sense. Maybe demonstration buttons would appear next to the clock (or instead of it) and vanish when the first speech starts? Just thinking out loud here.

@jakubmanczak
Copy link
Member

This would also be a good time to introduce some kind of settings validation – not letting a user start proceed to the clock if the time is set to 0, or if protected time is greater than speech time, can't fit twice if twice option is selected etc.

@jakubmanczak jakubmanczak pinned this issue Jun 7, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants