Bits and pieces of documentation

[Fabian Fagerholm]

On Thu, 2008-10-09 at 09:07 +0200, Patrick Ben Koetter wrote:
> Finally I've found some time to begin writing on the documentation.
> 
> I'd like to check in what I have at the moment.
> 
> Do we use any repository to store versions? I only have access to alioth and
> this only as guest - at least that's what my username indicates to me.

We can get you set up with svn access and everything. Mail me your
alioth ID and I'll add you to the project.

But just to eliminate all obstacles, please dump whatever you want to
write on this wiki page:

http://wiki.debian.org/PkgCyrusSASL

Make sub-pages if needed. Go wild. The most important thing is to get
everything recorded. We can sort and improve later, and put the right
stuff into the doc package. But it won't make it into lenny anyway, so
it might as well be put into the wiki.

> Further do you know of any documentation guidelines (e.g. use DocBook, prepare
> it this or that way) I should follow?

Not really. After having written my share of DocBook and other SGML/XML
documents, I really prefer plain text, possibly using reStructuredText.
But once we get the actual words written, we can improve their structure
later.

Thanks,
-- 
Fabian Fagerholm <fabbe at paniq.net>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
Url : http://lists.alioth.debian.org/pipermail/pkg-cyrus-sasl2-debian-devel/attachments/20081009/f9ca804b/attachment.pgp