For documentation contributions, suggestions, improvements and translations

Jerry McBride | 1 May 2004 20:04

Re: Doc suggestion.

Jason Stubbs wrote:

> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> On Monday 26 April 2004 21:45, Sven Vermeulen wrote:
>> On Sun, Apr 25, 2004 at 11:32:11PM -0400, Jerry McBride wrote:
>> > Why not make it an option that would allow all documents to be
>> > converted/genrated in html and served up to the user via apache?
>>
>> Am I missing something or is it just too hot in here to think straight?
>> Our documents are converted to HTML and served up to the user through
>> Apache...
> 
> My understanding is that he meant man pages, info pages, files in
> /usr/doc, etc. Would take a fair bit of work though...
> 

Yup, that's what I was thinking of... I was a bit excited when I wrote the
original message...

As far as complexity goes.. would it be any more than running the docs
through an html converter and generating an index for the doc and then
adding a link to a master index?

--

-- 

******************************************************************************
                     Registered Linux User Number 185956
          http://groups.google.com/groups?hl=en&safe=off&group=linux

(Continue reading)

headers

Sven Vermeulen | 3 May 2004 10:29

Re: Re: Doc suggestion.

On Sat, May 01, 2004 at 02:04:37PM -0400, Jerry McBride wrote:
> As far as complexity goes.. would it be any more than running the docs
> through an html converter and generating an index for the doc and then
> adding a link to a master index?

Well, providing all documentation without any coupling to the packages
themselves isn't possible (imagine how many resources would have to be put
in installing packages, separating documentation and integrating all
documentation).

Wkr,
      Sven Vermeulen

--

-- 
 ^__^   And Larry saw that it was Good.
 (oo)                                      Sven Vermeulen
 (__)   http://www.gentoo.org              Documentation & PR