Re: [Manoj Srivastava] [PATCH 2/4] [bug545548-srivasta]: Make upgradng-checklist a real HTML file
On Sun, Oct 11 2009, Russ Allbery wrote:
> Manoj Srivastava <srivasta@debian.org> writes:
>
>> 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.
>
> I'm fine to maintain it in org-mode. I haven't played with it yet,
> but I'm sure it can't be that hard, and it's not like the details
> change all that much.
Right. Given that we do have a bug asking for this
documentation, and that this is already written, and no one else has
stepped up to re-write it in another format, I think I shall merge this
branch in, at least as an interim measure. Given that this is not
really policy, but packaging, we can always decide to change our mind.
> I think we're likely to move to Docbook in the long run, and when we
> do that, we can look at rewriting it, but until then, I'm happy to use
> whatever format whoever did the original work thinks is easiest to
> maintain. I probably would have used POD. :)
Well, org-mode has a docbook output filter, so we can have a
head start once we do convert. But I contend that org-mode markup is
waaay easier to write than docbook xml (involves less typing), and is
far more readable in raw format than XML is. I did think about pod,
but org-mode is far more powerful than pod is, and supports all kinds
of things (built-in plain text spreadsheet, footnote support, various
modes of URL, image support, etc -- all supported for various output
formats). Also, I confess I am really really into org-mode, what with
sing it in Ikiwiki and for my GTD agendas.
manoj
--
Dare to be naive. Buckminster Fuller
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: