[Packaging-handbook-project] Cooperation between Miriam's course on Debian packages and the Debian Packaging Handbook project

[Kumar Appaiah]

On Thu, Aug 30, 2007 at 01:52:09PM +0200, martin f krafft wrote:
> > I can't think of any ideal choice here, but I think we might start
> > with defining some of the feature this format should provide. Here are
> > a few ideas:
> > * text-based (for the VCS)
> > * easily produce web pages (for the final document to be viewed online)
> > * easily produce some kind of "static" document format (like pdf, for
> > the final document to be easily downloaded and viewed locally on the
> > user's system)
> 
> Sounds like asciidoc to me.

I want to give a +1 to AsciiDoc for the simple reason that anyone can
comprehend the "source" (plain text) very easily. Of course, someone
may also point out DocBook, the type Debian use for their docs, but
I'd definitely prefer AsciiDoc, since (I think) is can write out to
DocBook as well.

Kumar
-- 
Kumar Appaiah,
458, Jamuna Hostel,
Indian Institute of Technology Madras,
Chennai - 600 036
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/packaging-handbook-project/attachments/20070830/ff229858/attachment.pgp