Re: [Gimp-docs] Preferences documentation

[Elle Stone <ellestone ninedegreesbelow com>]

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:

<sect1 xmlns:xi="http://www.w3.org/2001/XInclude"; id="gimp-prefs-dialog">

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