RSS/Atom feed Twitter
Site is read-only, email is disabled
  1. Chat
  2. Useful links
  3. Polls

Featured content

Preferences documentation

This discussion is connected to the gimp-docs-list.gnome.org mailing list which is provided by the GIMP developers and not related to gimpusers.com.

This is a read-only list on gimpusers.com so this discussion thread is read-only, too.

7 of 7 messages available
Toggle history

Please log in to manage your subscriptions.
Preferences documentation Elle Stone 04 Apr 14:38
  Preferences documentation Elle Stone 04 Apr 14:57
   Preferences documentation Marco Ciampa via gimp-docs-list 04 Apr 15:05
  Preferences documentation Julien Hardelin 04 Apr 18:26
   Preferences documentation Elle Stone 04 Apr 19:05
    Preferences documentation Elle Stone 04 Apr 20:15
     Preferences documentation Elle Stone 05 Apr 13:21
Elle Stone
2017-04-04 14:38:49 UTC (over 7 years ago)

Preferences documentation

Hi All,

Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences.

The Preferences page is huge, too large for users to easily navigate.

What do you all think about reorganizing as follows?

* Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar.

* Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc).

Best, Elle

Elle Stone
2017-04-04 14:57:21 UTC (over 7 years ago)

Preferences documentation

On 04/04/2017 10:38 AM, Elle Stone wrote:

Hi All,

Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences.

The Preferences page is huge, too large for users to easily navigate.

What do you all think about reorganizing as follows?

* Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar.

* Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc).

I forgot to say, I can make these changes if the consensus is that it's a good thing to do.

Best,
Elle

Marco Ciampa via gimp-docs-list
2017-04-04 15:05:27 UTC (over 7 years ago)

Preferences documentation

Hello Elle!

On Tue, Apr 04, 2017 at 10:57:21AM -0400, Elle Stone wrote:

On 04/04/2017 10:38 AM, Elle Stone wrote:

Hi All,

Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences.

The Preferences page is huge, too large for users to easily navigate.

What do you all think about reorganizing as follows?

IMHO...

* Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences.

Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar.

like it

* Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc).

like this too

I forgot to say, I can make these changes if the consensus is that it's a good thing to do.

I think it is a good thing to do, thanks!

Regards,

Marco Ciampa

I know a joke about UDP, but you might not get it.

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

 GNU/Linux User #78271
 FSFE fellow #364

------------------------
Julien Hardelin
2017-04-04 18:26:33 UTC (over 7 years ago)

Preferences documentation

Good idea, I agree.

Regards,

Julien

Le 04/04/2017 16:38, Elle Stone a crit :

Hi All,

Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences.

The Preferences page is huge, too large for users to easily navigate.

What do you all think about reorganizing as follows?

* Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar.

* Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc).

Best,
Elle
_______________________________________________ gimp-docs-list mailing list
gimp-docs-list@gnome.org
https://mail.gnome.org/mailman/listinfo/gimp-docs-list

Elle Stone
2017-04-04 19:05:46 UTC (over 7 years ago)

Preferences documentation

On 04/04/2017 02:26 PM, Julien Hardelin wrote:

Good idea, I agree.

Regards,

Julien

Hmm, from looking in a browser at: https://docs.gimp.org/2.9/en/gimp-pimping.html#gimp-prefs-dialog I assumed that all the preferences options were in one single xml file. But in reality "src/preferences" is full of individual prefs-*.xml files.

"src/menu/edit/preferences.xml" starts with this line:

and has a bunch of "include" statements at the bottom. This is probably how all the Preferences submenu end up on one page in the resulting html file.

So it looks like what is needed is to:

* move the Preferences folder to under menu/edit * move src/using/preferences/preferences_introduction.xml to src/menus/edit/preferences_introduction.xml * remove the include statements from preferences_introduction.xml * anything else?

I'll try the above changes on my local install of gimp-help-2 and see what happens.

Best,
Elle

Le 04/04/2017 16:38, Elle Stone a crit :

Hi All,

Most of the documentation devoted to "Enrich my GIMP" is actually documentation for Preferences.

The Preferences page is huge, too large for users to easily navigate.

What do you all think about reorganizing as follows?

* Make Preferences a stand-alone section with the base URL https://docs.gimp.org/2.9/en/gimp-preferences. Or probably better, put Preferences under the Edit menu, to correspond to where Preferences is located on the Menu bar.

* Break the Preferences documentation into smaller chunks corresponding to the Preferences subsections (System Resources, Color Management, etc).

Best,
Elle

Elle Stone
2017-04-04 20:15:34 UTC (over 7 years ago)

Preferences documentation

On 04/04/2017 03:05 PM, Elle Stone wrote:

* remove the include statements from preferences_introduction.xml

Well, that's not right. I was thinking about php include for adding html from one file to another html file. Sigh.

Best, Elle

Elle Stone
2017-04-05 13:21:47 UTC (over 7 years ago)

Preferences documentation

On 04/04/2017 04:15 PM, Elle Stone wrote:

On 04/04/2017 03:05 PM, Elle Stone wrote:

* remove the include statements from preferences_introduction.xml

Well, that's not right. I was thinking about php include for adding html from one file to another html file. Sigh.

I opened a bug report and attached a patch that moves all of Preferences to the Edit menu:

https://bugzilla.gnome.org/show_bug.cgi?id=780927 I didn't want to push these changes without having someone review them first.

Best,
Elle