After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 694571 - new topic: favourites
new topic: favourites
Status: RESOLVED FIXED
Product: gnome-user-docs
Classification: Core
Component: sysadmin-guide
3.7.x
Other Linux
: Normal normal
: ---
Assigned To: Maintainers of Gnome user documentation
Maintainers of Gnome user documentation
Depends on:
Blocks:
 
 
Reported: 2013-02-24 09:24 UTC by Matthias Clasen
Modified: 2013-06-24 16:35 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Added a new topic page to explain how to change the default favourites. (4.42 KB, patch)
2013-03-24 09:17 UTC, Aruna Sankaranarayanan
none Details | Review
Modified Mallard tags in previous patch (1.69 KB, patch)
2013-03-24 15:32 UTC, Aruna Sankaranarayanan
needs-work Details | Review
New topic - shell-default-favorites (4.46 KB, patch)
2013-04-06 10:49 UTC, Aruna Sankaranarayanan
reviewed Details | Review
default-favorites.page (2.85 KB, patch)
2013-04-25 16:42 UTC, Aruna Sankaranarayanan
none Details | Review
New topic dconf-default-favorites.page (2.89 KB, patch)
2013-04-25 17:39 UTC, Aruna Sankaranarayanan
none Details | Review
New topic dconf-default-favorites (2.97 KB, patch)
2013-04-26 14:22 UTC, Aruna Sankaranarayanan
none Details | Review
dconf-default-favorites.page (2.97 KB, patch)
2013-04-26 14:45 UTC, Aruna Sankaranarayanan
needs-work Details | Review
dconf-davorite-applications.page (6.53 KB, patch)
2013-04-28 17:54 UTC, Aruna Sankaranarayanan
none Details | Review
Changes (6.52 KB, patch)
2013-06-24 12:15 UTC, Aruna Sankaranarayanan
committed Details | Review

Description Matthias Clasen 2013-02-24 09:24:09 UTC
We should have a topic that explains how to change the default favourites that are displayed in the gnome-shell dash
Comment 1 Aruna Sankaranarayanan 2013-03-24 09:17:59 UTC
Created attachment 239667 [details] [review]
Added a new topic page to explain how to change the default favourites.

I've tried to explain the process using dconf-editor.

However, it'd also be okay to do the same by removing all existing dash applications from favorites(By right-clicking and remove from favorites) and then adding a new set of favorite applications.

I am not sure if my page is explaining how to change the 'default' favourites, because that can be done even using add/remove application. 

Can someone please clarify? :)

Thanks!
Comment 2 Aruna Sankaranarayanan 2013-03-24 15:32:55 UTC
Created attachment 239682 [details] [review]
Modified Mallard tags in previous patch

Added <file> tags to a path instead of <em> tags
Added <sys> tags to dconf-tools package
Comment 3 Kat 2013-04-01 09:38:42 UTC
Comment on attachment 239682 [details] [review]
Modified Mallard tags in previous patch

You should squash this patch into your previous one. You can use 'git rebase -i' to do this.
Comment 4 Aruna Sankaranarayanan 2013-04-06 10:49:29 UTC
Created attachment 240830 [details] [review]
New topic - shell-default-favorites

Changes according to Kat's comment!

Squashed the commits.
Comment 5 Matthias Clasen 2013-04-08 02:06:59 UTC
Review of attachment 240830 [details] [review]:

::: gnome-help/C/shell-apps-default-favorites.page
@@ +32,3 @@
+  <note style="info">
+    <p>The <sys>dconf-tools</sys> package must be installed in your system
+    before you can run <app>dconf-editor</app>.</p>

This note is distro specific. In Fedora, the package is called dconf-editor.
Comment 6 Matthias Clasen 2013-04-08 02:16:31 UTC
Since this is meant as an addition to the sysadmin guide, it should explain how to change the default favourites list for all users, now how to change the favourites inside a single users' session. 

This topic should talk about overrides for the setting, using dconf profiles or gsettings overrides.
Comment 7 Aruna Sankaranarayanan 2013-04-10 16:51:59 UTC
Sorry about the sys-admin goof up again. :) Will work on this soon. Thanks for clarifying.
Comment 8 Aruna Sankaranarayanan 2013-04-25 16:42:49 UTC
Created attachment 242439 [details] [review]
default-favorites.page

Added a page to set default favorites using dconf profiles.

Please review. :)

Thanks!
Comment 9 Aruna Sankaranarayanan 2013-04-25 17:39:50 UTC
Created attachment 242446 [details] [review]
New topic dconf-default-favorites.page

Renamed the page because it uses dconf, so that it's compliant with existing names.

Please review. :)

Thanks!
Comment 10 Aruna Sankaranarayanan 2013-04-26 14:22:42 UTC
Created attachment 242570 [details] [review]
New topic dconf-default-favorites

Updated page with Mallard tags for dconf and marked parts of page that are not translatable.
Comment 11 Aruna Sankaranarayanan 2013-04-26 14:45:58 UTC
Created attachment 242573 [details] [review]
dconf-default-favorites.page

Updated page id, changed xref to href, changed the occurence of firefox on the page.
Comment 12 Kat 2013-04-26 18:44:08 UTC
Review of attachment 242573 [details] [review]:

Good start. How does one set the global default applications for all users rather than doing it on a user-by-user basis?

I think it would make more sense to mention applications in the file name, for example dconf-favourite-applications.page

::: system-admin-guide/C/dconf-default-favorites.page
@@ +24,3 @@
+  <p>Favorite applications are those visible on the
+  <link href="help:gnome-help/shell-terminology">dash</link>. If you have an
+  <app>Administrator</app> account, you can set the default favorite

This help is for administrators, it is safe to assume that they will have an account with the right privileges.

@@ +27,3 @@
+  applications for different users by modifying their user database file found
+  in <file its:translate="no">~/.config/dconf/user</file>. The following
+  example snippet uses dconf to set <app>gedit</app>, <app>Terminal</app> and

dconf is missing markup.

@@ +31,3 @@
+  users to modify the list later, if they wish to do so.</p>
+
+  <code its:translate="no">

While you do not want the code to be translatable, you need to allow your comments that explain what each line means to be translatable.

@@ +37,3 @@
+  #Set gedit, terminal and nautilus as default favorites
+  [org/gnome/shell]
+  favorite-apps = ['gedit.desktop', 'gnome-terminal.desktop', 'nautilus.desktop']

It would be nice to markup "gedit.desktop" and the other desktop files as <input> because these are the bits that the sysadmin is expected to change.

@@ +41,3 @@
+
+  <note style="tip">
+    <p>As an <app>Administrator</app>, you can also

Again, administrator privileges are assumed for the sysadmin guide.
Comment 13 Aruna Sankaranarayanan 2013-04-28 17:54:04 UTC
Created attachment 242739 [details] [review]
dconf-davorite-applications.page

Made all changes according to review.

I've divided the page into two sections, one that explains how to add different default applications for different users and another that modifies system databases.

Please review. :)
Comment 14 Petr Kovar 2013-06-04 16:44:34 UTC
The patch currently doesn't apply due to a conflict in system-admin-guide/Makefile.am.

Aruna, could you please update the patch? TIA

I would change the title of the page from

<title>Setting default favorite applications</title>

to

<title>Set default favorite applications</title>

Also:
re read -> reread 
organisation -> organization

Otherẃise, the patch looks good to me. Good job!
Comment 15 Aruna Sankaranarayanan 2013-06-24 12:15:07 UTC
Created attachment 247629 [details] [review]
Changes

Thank you for the review Petr.

This patch applies after i did a pull --rebase on master. :)

Can you please check if it's okay?
Comment 16 Petr Kovar 2013-06-24 13:11:51 UTC
Review of attachment 247629 [details] [review]:

Looks good, please commit to master. Thanks.
Comment 17 Aruna Sankaranarayanan 2013-06-24 16:28:08 UTC
Review of attachment 247629 [details] [review]:

Patch has been pushed to master with 
commit ID 55f1509bdc7a7669a5cbaacaeec8959e3b979b35
Comment 18 Sindhu S 2013-06-24 16:35:50 UTC
Thanks for the patch, closing bug with RESOLVED and FIXED now :)