[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Documentation Policy



Christian Schwarz writes:
> Hi folks!

re

> So I suggest the following policy. Note, that this is just a summary, not
> the actual text.
> 
> 
>      The unification of Debian documentation is being carried out via
>      HTML. However, we'll still provide GNU info documentation, where 
>      available.
> 
>      Thus, every package that contains documentation in a convertable
>      format has to provide HTML documentation. 
> 
>      The documentation will be distributed via several packages:
> 
>            foo-doc-html      for HTML docs
>            foo-doc-info      for GNU info docs (where available)
>            foo-doc-xxx       for other formats (only where appropriate)
> 
>      (An example for the last case would be "DVI" documentation for TeX
>      related packages.)
> 
>      If the documentation files in all available formats do not require
>      more than 100k of disk space _together_, they may be included in the
>      "main" package. Otherwise, the will have to be distributed in
>      seperate packages, one for each format.
> 
> Any comments?

I don't like the idea of splitting packages that much.  It increses
the confusion for users.   For new users it is incredible difficult
to install Debian because of >1000 packages.

And for my feeling the documentation belongs to the package itself.
I don't want to install another package just because I need some
documention.

OTOH I do understand your way.

Regards

	Joey

-- 
  / Martin Schulze  *  joey@infodrom.north.de  *  26129 Oldenburg /
 /                             The good thing about standards is /
/ that there are so many to choose from. -- Andrew S. Tanenbaum /


--
TO UNSUBSCRIBE FROM THIS MAILING LIST: e-mail the word "unsubscribe" to
debian-devel-request@lists.debian.org . 
Trouble?  e-mail to templin@bucknell.edu .


Reply to: