possible documentation viewer?

[Sean Wheller]

On Friday 03 June 2005 16:25, Jeff Waugh wrote:
> > I have put in place a solution that works without making compounding
> > problems for anyone else.
>
> It creates compounding problems for the distribution, and our ability to
> work with upstream. Instead of solving the help problem, it compounds it by
> taking Ubuntu off in a different direction to everyone else.

Please check /usr/share/doc for *.html You will find many documents in HTML 
format. Why is it so wrong for ubuntu-docs to do the same if it is common  
for projects to package HTML.

example: 
* Dive into python
* Debian FAQ
* Debian doc-base Manual
* libgnomevfs2

BTW. In Hoary we release Ubuntu Quick Guide as XML and HTML

Yelp is a *GNOME* help viewer for *GNOME Documents* on *GNOME Apps*.

Not all projects supply gnome compliant XML and so they package HTML. There is 
nothing wrong with that. What matters is that the users can get to help.
Ubuntu docs are not GNOME per se. They also cover debian stuff and things 
about some non GNOME apps.



> This is not a 
> solution to the problem *or* a desireable strategy for us, or for any of
> our upstreams.

If a document is a gnome document, like the Ubuntu Device Database I have 
created it as a gnome doc using gnome standards. This app and its doc are 
already in GNOME CVS, without problem I believe. So yes we are working with 
upstream when it is feasible to do so.

-- 
Sean Wheller
Technical Author
sean at inwords.co.za
084-854-9408
http://www.inwords.co.za
Registered Linux User #375355
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20050603/e035f213/attachment.pgp>