[ubuntu] shipping html

Paul O'Malley ompaul at eircom.net
Sat Apr 22 15:40:32 UTC 2006


Matthew East wrote:

>Hi all,
>
>At the moment we are shipping XML with ubuntu-docs and also HTML
>versions of the documents as well. Now that I have added translations of
>the XML as well, the package is rather big, and I am fairly sure that
>there is not enough space to add translations as HTML too. So, the
>question arises: shall we just ditch HTML altogether, or leave in just
>the English version of the guides in HTML?
>
>So, does anyone else have any thoughts about this?
>  
>
Hi Matt,

When I think about it I suggest that we should not have a guide in 
Foo-technology in one language only, have it in all or none. In this 
case I am inclined to say none.

I do think that there is room for a "Welcome to the Welcome to Dapper 
Drake" default page with the "home page" that is default with the 
browser, perhaps under a link marked help. For this we could include 
something like MOTD to hand out to our user how to get good help from 
the off.

Perhaps it should look and feel like the wiki FAQ with some howtos 
linked in so that a user can install and read docs in both server and 
gui modes. The driver for this comes out of seeing the same request in 
IRC several times, and at an increasing rate, "please help with my 
network", and a couple of minutes later it becomes obvious that they are 
using the box headless.

Regards,

P.




More information about the ubuntu-doc mailing list