xml or html for Ubuntu Guides

[Matthew East]

On Sun, 2005-12-04 at 13:14 +0530, Bhuvaneswaran wrote:
> > xml, or html. Those who run dapper can see that for the purposes of
> > answering this question, we've uploaded both formats in the latest
> > package.
> 
> IMO, we can strict to this option, uploading both formats. We use
> docbook xml format for development. Preparing xml/html out of it is a
> breeze or the effort is negligible. Most users use different clients
> to read the documentation. They may use a xml client (yelp, ..) or
> html client (web browser, ..). IMO, we must cater all these users.

Most users do not use different clients to read the documentation. Yelp
is the help client for Ubuntu, that is what opens when the user clicks
on "help", and that is the only place where the documents are actually
listed. Displaying both formats in the yelp menu is totally not an
option: it would be really confusing for the user who does not know
which to select.

We need to make a clean choice between the two, I think. We can of
course upload both formats, if there is an obvious need to do so, and
just hide one from the yelp menu. I don't really see the point of that
though.

Matt
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20051204/13d7b5ce/attachment.pgp>