Re: [Manoj Srivastava] [PATCH 2/4] [bug545548-srivasta]: Make upgradng-checklist a real HTML file
On Mon, Oct 05 2009, Bill Allombert wrote:
> On Mon, Oct 05, 2009 at 03:05:42PM -0500, Manoj Srivastava wrote:
>> On Mon, Oct 05 2009, Bill Allombert wrote:
>>
>> > On Mon, Oct 05, 2009 at 12:36:44AM -0500, Manoj Srivastava wrote:
>> >> Hi,
>> >>
>> >> I have now updated the README docs with a slightly cleaner
>> >> work-flow. I would like to get a show of hands from the policy team
>> >> about this; and if people are OK with this approach (using org-mode,
>> >> with perhaps me committing to maintaining these documents in the
>> >> team), or abandoning this approach and going to plain old
>> >> HTML/docbook.
>> >>
>> >> Personally, I think that the .org files are easier to edit, even for
>> >> people who are unfamiliar with org-mode, and are mroe readable than
>> >> SGML based documents, and thus would have higher utility, but I'll
>> >> abide with what the rest of the team thinks.
>> >
>> > How the synchronisation with the wiki will be handled ? Or is the wiki
>> > page deprecated ?
>>
>> The latter, I think. But if people want to update the wiki pages
>> I will not stand in the way.
>
> In that case, I think it would be preferable to keep a single markup language
> for the whole policy package.
Then feel free to pick up the work, taking the language I have
put in there. I'll keep the branch around, and perhaps even keep it
updated. I am not interested in writing this up in debian-doc.
But someone really should be writing this up, since the bug
report was, in my opinion, on point: this stuff needs to be written up,
and I think that the wiki stuff is already not as good as the README is
when it comes to git process (far too many needless merges in that
process). If someone is willing to write this up and maintain it in
debiandoc, great. Or else perhaps one could reconsider my offer to
maintain it in the current form.
manoj
--
Auction: A gyp off the old block.
Manoj Srivastava <srivasta@debian.org> <http://www.debian.org/~srivasta/>
1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C
Reply to: