GNOME Bugzilla – Bug 678112
Need user visible documentation
Last modified: 2013-03-05 10:09:45 UTC
The current gui for online-accounts is rather spartan, and just shows the various ON/OFF options for different things like Mail, Calendar, Contacts, Chat, and Documents. Its not at all clear what it would mean for something to be on or off. Does GOA control (a) what events appear in the calendar dropdown? (b) what popups appear for mail? (c) preferred accounts from which mail will automatically be sent from? [in which case "Chat" doesn't make sense] (d) is it just a single signon tool? I honestly have no idea what this is supposed to do.
There are some pages written in the Gnome User Guide about gnome-online-accounts which answer some of the above questions: http://library.gnome.org/users/gnome-help/stable/accounts.html.en Perhaps a "help" button linked to the system installed files would be beneficial?
Clicking the "help" button in the application menu, while in the Online Accounts panel already shows the guide.
(In reply to comment #1) > There are some pages written in the Gnome User Guide about > gnome-online-accounts which answer some of the above questions: > > http://library.gnome.org/users/gnome-help/stable/accounts.html.en Looked at that documentation. The most useful page is: http://library.gnome.org/users/gnome-help/stable/accounts-which-application.html.en I would suggest that maybe instead of having these abstract toggles "Chat" "Calendar" "Documents" etc... there should be toggles for applications "Empathy (Chat)" "Evolution (Mail and Calendar)" etc... Then when an application registers as being capable of working with the online accounts interface the application can describe exactly what it intends to do with the online registration. The way things currently are it is just unclear. Why do I have the online accounts dialog if empathy has its own dialog for creating and setting up accounts? What advantage is the one over the other? Does Evolution consider only the Mail toggle or the Mail and Calendar toggle? Does flipping the toggle in any way affect what account is the primary default account for new mail/new events? Do all my documents get backed up to an account that has "Documents" set to ON? If all this does is Single Sign On, then that is a fairly well understood and easily explained concept, so describe it as that. It can say "joe.user@gmail.com Enable Single Sign On for the following categories." Right now, I just can't tell from what I'm seeing and reading if its supposed to be doing anything more than SSO.
(In reply to comment #2) > Clicking the "help" button in the application menu, while in the Online > Accounts panel already shows the guide. What help button?
(In reply to comment #2) Not in Fedora 17: Contacts 3.4.1.
(In reply to comment #3) David, Thank-you for your detailed feedback. We will improve on these pages, most likely during the docs hackfest next month, and bring them up-to-date.
Glad its helpful. If I knew what the thing was doing I would be happy to help write some documentation.
If you figure it out, we'll gladly accept your contributions :-)
(In reply to comment #4) > (In reply to comment #2) >> Clicking the "help" button in the application menu, while in the Online >> Accounts panel already shows the guide. > > What help button? It is possible that this was a recent addition. I am running GNOME 3.5.3 here, which is not in any stable distribution. So, in the worst case, you will get it when GNOME 3.6 comes out in September this year.
(In reply to comment #3) > The way things currently are it is just unclear. Why do I have the online > accounts dialog if empathy has its own dialog for creating and setting up > accounts? What advantage is the one over the other? This is something that we plan to address for GNOME 3.8 -- merging empathy-accounts into the online accounts panel.
ping - Just curious what is going on here. Are we happy with the state of the user help? Do we want to improve it? Or were we just waiting for GNOME 3.6 to be released so that the help is available to the users?
ping -Can I assume that everything is fine and close this as INVALID?
Its hard for me to say, I'm downstream from you so I only see what I have. Certainly not any better on Debian Unstable online-accounts-3.4.2-2, but if this work is in 3.8 I won't have seen it yet. With Ubuntu 12.10 there is online-accounts-3.6.0-0ubuntu1 and there are in fact two "Online Accounts" listed in Control Center. I'm not sure which is which, and why I have two. I've attached screenshots of the "Good" and "Bad" variants. Where I consider the "Good" version good because it tells exactly what each application will do with the login.
Created attachment 238077 [details] The "Bad" Online Accounts This is Online-Accounts 3.4.2 and I consider it "bad" and unclear.
Created attachment 238078 [details] The "Good" Online Accounts I'm not sure which version of Online Accounts this is, but it appears as an entry in control center for Ubuntu 12.10
(In reply to comment #13) > Where I consider the "Good" version good because it tells exactly what each > application will do with the login. Just so we are clear about this. There is no way to do this reliably. The only thing you can do is hope that each application that will be using your account tells you the truth about what it will be doing. There is no way for you to know if an application is saying something but doing something else unless you read through the sources, and if you have a proprietary blob on your system, then only $DEITY can help you. :-) Having said that, currently, in GNOME Online Accounts, the on|off switches are named after the core GNOME applications that are going to be using your data. The documentation also has a "Which applications take advantage of online accounts" entry. But as I said before, all this assumes that the applications are truthful and hence not reliable.
(In reply to comment #15) > Created an attachment (id=238078) [details] > The "Good" Online Accounts > > I'm not sure which version of Online Accounts this is, but it appears as an > entry in control center for Ubuntu 12.10 That is Ubuntu's own sign-on framework and has nothing to do with GNOME Online Accounts. Even then, all that I said earlier still holds. There is no reliable way for you to know that the applications that are listed there are the only ones using your data and they are using it in the way they claim to be. We won't invest too much time in listing out applications any more than we do now, unless we work out a mechanism to sandbox applications to make this work reliably and securely.
Closing this as FIXED because the documentation mentions the names of applications using online accounts since versions 3.5.x/3.6.x.