Bug#7890: {PROPOSAL} #7890: Policy manual contradicts itself about including docs
Hi,
>>"Adam" == Adam P Harris <apharris@burrito.onshore.com> writes:
Adam> Manoj Srivastava <srivasta@datasync.com> writes:
>> I also further stated:
>> I was not really suggesting replacing the info documentation
>> (or the man pages, for that matter), I meant in addition to. The
>> policy *does* say that HTML is our preferred format, so it should
>> also be provided
Adam> Yes, I mostly agree.
Does that mean you second the proposal? I suggest we implement
this part of the proposal first, and leave the issue of the source of
the documentation to another ptoposal, since that is turning out to
be controversial.
This proposal has only one second at the moment. I would like
to see if there are others, and to move the non-controversial part of
the proposal out of the way.
Adam> The *source* of the documentation should also be
Adam> shipped if possible (i.e., SGML, TeX). This enables people to patch
Adam> documenatation and send in diffs; it also enables them to possibly
Adam> format the source into whatever media they like.
I personally tend to agree, but I think this is grist for
another proposal.
I shall retitle this bug and start the count down as soon as I
get another second (I am saying that since it seems to me that the
proposal I submitted is not controversial and can be handled quickly,
reducing the number of open issues on policy).
manoj
not responsible for his sig generator
--
You cannot see the wood for the trees. John Heywood
Manoj Srivastava <srivasta@acm.org> <http://www.datasync.com/%7Esrivasta/>
Key C7261095 fingerprint = CB D9 F4 12 68 07 E4 05 CC 2D 27 12 1D F5 E8 6E
Reply to: