Bug 12526 - "Help" and "More Help" options need to be added to setup screens
: "Help" and "More Help" options need to be added to setup screens
Status: RESOLVED FIXED
Product: SB Radio
Classification: Unclassified
Component: Setup
: Include FW version in comment
: PC Other
: -- normal (vote)
: MP
Assigned To: Wadzinski Tom
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2009-06-24 20:06 UTC by Weldon Matt
Modified: 2009-09-08 09:19 UTC (History)
2 users (show)

See Also:
Category: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Weldon Matt 2009-06-24 20:06:39 UTC
(also applies to controller, and "remote" mode on fab4).

This bug is really just to clarify the navigation strategy for "help" screens in setup (on fab4 touch, of course, there is a dedicated "help" button that isn't available on baby/controller/fab4 IR.)

Generally, "help" should simply be the bottom option on the screen (on screens with a "help" option).

The help screens themselves should have a "more" option at the bottom of the screen, which links to the more help screen.

If there are cases where this implementation isn't possible, or seems wrong, please chime in and/or reassign the bug back to me... kthxbye
Comment 1 Wadzinski Tom 2009-06-25 12:36:38 UTC
I'm proceeding with this. One note: The code supports the idea of a textinput with a upper right help button, though I'm not sure that we have example uses.  Since we don't have a menu in those cases, do you have something else in mind?
Comment 2 Wadzinski Tom 2009-06-25 13:09:50 UTC
There are a few places in setup where the help button appears on a text input.
Comment 3 Weldon Matt 2009-06-25 13:13:42 UTC
Foiled again!

Hmm... I will take a look.  That's a tricky one...
Comment 4 Weldon Matt 2009-06-29 11:38:09 UTC
Based on the setup wizard spec (http://embargo.wiki.slimdevices.com/index.php/New_Setup_Wizard), this applies to 3 screens total.  Case-by-case recommendations below.

---------------------

SSID Help (screen 7d: http://embargo.wiki.slimdevices.com/index.php/New_Setup_Wizard#SCREEN_7D_-_HELP_-_SSID_Help)

Currently, all this screen says is "At this stage, you need to enter in the unique name of your network (sometimes called an SSID)."

This same copy is on the previous help screen, so I think we're ok leaving this one out.

---------------------

Wireless Password Help (screen 9a: http://embargo.wiki.slimdevices.com/index.php/New_Setup_Wizard#SCREEN_9A_-_HELP_-_Wireless_Password_Help)

This help screen contains almost the exact same text as the help screen for the previous step, with the exception of the bit about ASCII-formatted WEP passwords.  I'd propose adding this text to the previous help screen, and pushing both "NOTES" to the bottom of that screen (which happens to be "screen 7A" in the flow).

"Screen 7a" ("Wireless Network Help") would thus have the following copy.  Overall text is a bit wordy, but this is an important help screen:

"At this stage, we need to get your Squeezebox connected to your wireless network. To do this, you'll need to know your network name and password (if you have an open network, you won't need a password).

If you don't know your network name or password, and you have a wireless network, try one or more of the following:

1. Check to see if you have them written down somewhere.
2. Ask someone else in your home if they know them.
3. Contact the person who set up your home network.
4. Check your router manual.
5. Contact your router manufacturer for assistance.

If your network does not appear on the list of wireless networks, try one or more of the following:

1. Make sure the Squeezebox is within range of your wireless network.
2. Go to your computer to make sure your network is working.
3. If your router is configured to not broadcast your network name (SSID), select "I don't see my network" at the bottom of the list of networks, and enter yours.
4. Unplug your router, wait 30 seconds, and plug it back in.
5. Refer to your router documentation or contact the manufacturer for assistance. 

NOTE: A network name is sometimes referred to as an SSID, and a password is sometimes referred to as a wireless key, or security key.

NOTE: Squeezebox does not support ASCII-formatted WEP passwords. You can still connect your Squeezebox to your network, but you will need to convert the ASCII password to Hexadecimal format. You can likely find a converter tool somewhere online. Or visit www.mysqueezebox.com/support for more information."

---------------------

Manual DHCP help (http://embargo.wiki.slimdevices.com/index.php/New_Setup_Wizard#SCREEN_10H_-_HELP_-_Manual_DHCP_Help)

In this case, the help text is pretty important, since it explains what's needed for the 4 consecutive text entry screens you have to go through.  Getting to this screen is also an edge case, so having a little more copy to wade through isn't the end of the world.

I recommend that we put the help screen before the first text entry screen here, and use the same copy we currently use for help.

NEW SCREEN: goes between screens 10c and 10e.

Title: Connect Manually

Copy:

"To connect manually, we'll need the following pieces of information:

1. IP address - the IP address you want to use for this Squeezebox.
2. Subnet mask - the subnet mask of your network.
3. Gateway IP address - typically the IP address of your router.
4. DNS - the IP address of the DNS server you are using.

Please contact your network administrator for further assistance, or visit www.mysqueezebox.com/support."

For this last screen, might as well make the switch on all interfaces (including touch).
Comment 5 Wadzinski Tom 2009-07-01 09:19:02 UTC
fixed in r6303
Comment 6 Wadzinski Tom 2009-07-10 12:02:51 UTC
This last part got missed.  Since there is no translation, Matt and I have discussed but not sure on the decision:

STATIC_ADDRESS
	CS	Zadejte IP informace manuálně
	DA	Angiv IP-adressen manuelt
	DE	IP-Informationen manuell eingeben
	EN	Enter IP information manually
	ES	Introducir información de IP manualmente
	FI	Kirjoita IP-tiedot manuaalisesti
	FR	Entrer les informations concernant l'IP manuellement
	IT	Immettere i dati IP manualmente
	NL	IP-gegevens handmatig invoeren
	NO	Angi ip-informasjon manuelt
	PL	Wprowadź ręcznie informacje o adresie IP
	RU	Ввести информацию IP вручную
	SV	Ange IP-uppgifterna manuellt

STATIC_ADDRESS_CONNECT_MANUALLY
	EN	Connect Manually

"Connect Manually", the requested string, was not translated in time. The alternative above, STATIC_ADDRESS, is possibly too long to be the title of a window.  Use it anyway as the title of the help window, Matt, or something else that is translated already? The possibly desired "Manual DHCP" is not translated anywhere in SC or SP.
Comment 7 Weldon Matt 2009-07-10 12:21:33 UTC
Let's use Static Address.
Comment 8 Wadzinski Tom 2009-07-10 12:43:08 UTC
After campfire discussion, back in your court, Matt.
Comment 9 Weldon Matt 2009-07-10 14:12:55 UTC
So I just had James replcate this case for me on fab4 so I could look at the actual existing help screen (the one you see if you press "help" in one of the text entry screens during manual DHCP setup).

This screen is in the wiki.  it was originally titled "Manual DCHP Help," but for whatever reason (a bug?) it got implemented as "IP Address Help."  (I just looked at it moments ago on a fab4, and that was the copy on the screen).

http://embargo.wiki.slimdevices.com/index.php/New_Setup_Wizard#SCREEN_10H_-_HELP_-_Manual_DHCP_Help

So, this got translated right?  This is a holdover from fab4 MP, so surely SLT has dealt with the screen at this point.

I'm proposing we use "IP Address Help" as the name of the screen in question.
Comment 10 Wadzinski Tom 2009-07-10 16:44:39 UTC
fixed in 6515 - "IP Address Help" with translations