Re: [Scrollkeeper-devel] Simple URI's

[Dan M. <d-...@uc...>]

On Mon, 4 Dec 2000, Laszlo Kovacs wrote:

> > Let the users use bookmarks.  On a network with multiple architectures,
> > does "modem-HOWTO" refer to the Linux, FreeBSD, or Solaris document?

Bookmarks won't help here.  Bookmarks do not provide a mechanism for one
document to cross-reference another, nor do they help a user find a
document they've never seen before.  Bookmarks are great, but they serve a
different purpose.

> > If an individual user wants to create their own aliases for
> > documentation, they should probably be able to do so.  The user can then
> > have the burden of deciding which short name maps to which document, and
> > is in a much better position to know that they want "modem-HOWTO" to
> > point to the Solaris document.
> > 
> 
> Or the sysadmin decides where these URI's point to depending on machine
> type.

We need to have a reasonable "default" document chosen.  For any given
document (ie a set of documents with different versions, languages, and
formats but usually the same author and title) we will need to default to
a reasonable choice.  (We probably also want a way to return them all to
choose from.)  This was in the original post.

The sysadmin will indirectly be determining where these URI's point to by
specifying the default COVERAGE.OS in /etc/sk.conf.  So sk will know to
return documents that apply to that OS (and in the right language, and for
the right distribution, ...).  That is why we have all this great metadata
- so the sys admin and user don't have the burden of doing everything by
hand.

Dan