Re: scrollkeeper categories will put new users off the documentation

[Don Scorgie <DonScorgie Blueyonder co uk>]

Hi,

On Mon, 2006-01-23 at 17:56 +0000, Matthew East wrote:
> Dear doc-lists,
> 
> I just noticed a new category has come into Yelp: GNU Info files.
> 
> While I applaud the fact that more information is available from Yelp,
> it now means that there are two categories on the front page of our
> GNOME help browser which new users will not understand in any way, shape
> or form: Man pages, and GNU Info files.

Its Manual Pages, but thats just a minor point.

> 
> This will cause users simply to close the help browser, I'm afraid.
> 
> Where did discussion take place about this change? I'm subscribed to
> both these lists but didn't see it. If this isn't the correct forum,
> where can I direct a brief tirade?

We seem to have developed a strange complicated system for communication
between us, involving, in equal parts, these mailing lists, bugzilla
comments, IRC, mental telepathy and guessing.

The initial patch for this was posted to:
http://bugzilla.gnome.org/show_bug.cgi?id=316833
in a bug report about not finding info pages in the index of yelp...

Subsequent discussion occured on IRC.

The reason they are on the front page (I actually like them there, but
thats just me) is that I was reusing a lot of the Man page code for
generating the TOC and since man pages are on the front page, thats
where info pages ended up.

Just to point out that scrollkeeper doesn't know anything about the info
or man pages.  They're table-of-content entries are generated
independantly from the other categories.

Don