[Scilab-Dev] Scilab 5.4.1 Help Browser

[Samuel Gougeon]

Hello John,

Le 30/09/2013 11:41, E John Downing a écrit :
>
> Would you consider the possibility to provide a means of alphabetical 
> ordering of the Help Browser content folders, subfolders and 
> respective item bullets.
>
> Would you let me know you thoughts on the matter, and if you need the 
> completed SEP form.
>

In practical, IMO, alphabetical ordering of folders and subfolders is 
not necessarily
the most handy, because it would prevent in a list to "gather" 
subfolders that deal
around a same topic, without having to gather them in a subsubfolder.
Nesting too deeply subfolders with only few items is not more handy.

By the way, technically, the en_US release of the help tree imposes the 
ordering
of folders. If the ordering was according to their en_US names, it would be
relevant only for the en_US release, and mostly unrelevant in other 
languages.

For item bullets: The order is already quasi-alphabetical. "quasi" 
because actually,
for non en_US versions, there are 2 sublists:
  * the first sublist lists items for which a page translated in the 
locale exists.
   * them the second sublist restarts from "a" items, for en_US versions of
      pages for untranslated items.
I agree with you that it would be preferable to get a single mixed list
fully sorted in alphabetical order. Some work has been started to fix 
this issue
posted has bug http://bugzilla.scilab.org/11692 , but is not yet 
completed, due
to some complications regarding the building of cross-references.

Finally, another problem is that items are by far too numerous at the 
top level
of the help. This has motivated several reports like this one
http://bugzilla.scilab.org/show_bug.cgi?id=12872
AFAIK, presently, this kind of changes are intricated with the structure 
of/in modules.

Best regards
Samuel Gougeon

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.scilab.org/pipermail/dev/attachments/20131001/c9adfa85/attachment.htm>