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: