GNOME Bugzilla – Bug 694110
Update panel descriptions
Last modified: 2013-02-19 09:43:03 UTC
Very few of the panel comments provide information that is very useful.
Created attachment 236637 [details] [review] patch
*** Bug 694104 has been marked as a duplicate of this bug. ***
*** Bug 694105 has been marked as a duplicate of this bug. ***
*** Bug 694103 has been marked as a duplicate of this bug. ***
Created attachment 236641 [details] [review] updated patch Reduce the length of some of the descriptions and remove any remaining technical jargon.
Review of attachment 236641 [details] [review]: A couple of comments. I can commit after another round if you're happy with the results. ::: panels/network/gnome-network-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Network +_Comment=Select Wi-Fi networks, configure connections and setup VPN Not sure about this one. VPN probably is jargon, "connections" is also a bit hazy. "Select how to connect to the Internet"? ::: panels/region/gnome-region-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Region & Language +_Comment=Select your display language, formats, keyboard layouts and input sources I wouldn't do the dichotomy between keyboard layouts and input sources. "and how to type text"? ::: panels/sound/data/gnome-sound-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Sound +_Comment=Change sound levels, inputs, outputs, and effects not effects, we call them alert sounds iirc. ::: panels/universal-access/gnome-universal-access-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Universal Access +_Comment=Make it easy to see, hear, type, point and click easier? ::: panels/user-accounts/data/gnome-user-accounts-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Users +_Comment=Add or remove users and change your password and login options login options? ::: panels/wacom/gnome-wacom-panel.desktop.in.in @@ +1,3 @@ [Desktop Entry] _Name=Wacom Tablet +_Comment=Calibrate Wacom graphics tablets, set sensitivity and button mappings Calibrating really isn't a top task. Set button mappings for Wacom graphics tablets, and set sensitivity of styluses (or styli)
(In reply to comment #6) > Review of attachment 236641 [details] [review]: > > A couple of comments. I can commit after another round if you're happy with the > results. > > ::: panels/network/gnome-network-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Network > +_Comment=Select Wi-Fi networks, configure connections and setup VPN > > Not sure about this one. VPN probably is jargon, "connections" is also a bit > hazy. > > "Select how to connect to the Internet"? "Control how you connect to the Internet" > ::: panels/region/gnome-region-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Region & Language > +_Comment=Select your display language, formats, keyboard layouts and input > sources > > I wouldn't do the dichotomy between keyboard layouts and input sources. > "and how to type text"? I think some people think in terms of keyboard layouts and are unfamiliar with "input sources" as a term - that's why the panel itself refers to keyboard layouts. (Windows does this too, if I remember correctly.) > ::: panels/sound/data/gnome-sound-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Sound > +_Comment=Change sound levels, inputs, outputs, and effects > > not effects, we call them alert sounds iirc. Updated. > ::: panels/universal-access/gnome-universal-access-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Universal Access > +_Comment=Make it easy to see, hear, type, point and click > > easier? Yep. > ::: panels/user-accounts/data/gnome-user-accounts-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Users > +_Comment=Add or remove users and change your password and login options > > login options? Yeah, too vague - I removed it. > ::: panels/wacom/gnome-wacom-panel.desktop.in.in > @@ +1,3 @@ > [Desktop Entry] > _Name=Wacom Tablet > +_Comment=Calibrate Wacom graphics tablets, set sensitivity and button mappings > > Calibrating really isn't a top task. > Set button mappings for Wacom graphics tablets, and set sensitivity of styluses > (or styli) "Set button mappings and adjust stylus sensitivity for graphics tablets"
Created attachment 236650 [details] [review] updated patch
Committed as split files.