docs: CVS, wiki or what?
On Wed, Aug 17, 2005 at 09:35:16PM -0000, Dada Mail (Justin Simoni) wrote:
The other option is to Wiki the documentation - which wouldn't be the
worst idea - I'm just not really interested in admin'ing it against
bad advice/spam If we can hook up the Wiki to the Help links, we'd
be in a pretty good spot, as Dada Mail users could help themselves to
documentation
I think a wiki is the best idea I've seen it work really well for http://wiki darcs net/ and http://www cgi-app org/ both of which I've contributed many pages to Most wiki systems have the possibility to integrate some spam-defense system, often in real time
I can personally recommend MoinMoin (python), MediaWiki (php) and Kwiki (Perl) as all being pleasant to use
Far fewer people will bother with CVS, especially now that it as stigma of being old and crufty
Kwiki has some neat possibilities for Perl documentation It allows to you to use POD for the wiki syntax, so you can collaborate on the documentation on the wiki, and then ship the result as perl documentation
The native format of Kwiki is "kwid", which also happens to be the POD replacement for Perl 6 (It's no accident-- the same person is responsible for both Kwiki and Kwid)
Mark
--
Mark Stosberg Principal Developer
mark@summersault
com Summersault, LLC
765-939-9301 ext 202 database driven websites
http://www
summersault
com/
- This mailing list is a public mailing list - anyone may join or leave, at any time.
- This mailing list is a group discussion list (unmoderated)
-
Start a new thread, email: dadadev@dadamailproject.com
This is the developer discussion mailing list for Dada Mail.
If you are just looking for support Dada Mail, consult the message boards at:
https://forum.dadamailproject.com
Documentation for Dada Mail:
Specifically, see the Error FAQ:
https://dadamailproject.com/d/FAQ-errors.pod.html
To post to this list, send a message to:
mailto:dadadev@dadamailproject.com
All subscribers of this list may post to the list itself.
Topics that are welcome:
- Constructive critiques on the program (I like, "x", but, "y" needs some work - here's an idea on how to make this better...)
- Bug/Error reports
- Bug fixes
- Request For Comments on any changes to the program
- Help customizing Dada Mail for your own needs
- Patches
- Language Translations
- Support Documentation/Doc editing, FAQ's, etc.
- Discussion of any changes that you would like to be committed to the next version of Dada Mail -
Dada Mail is on Github:
https://github.com/justingit/dada-mail/
If you would like to fork, branch, send over PRs, open up issues, etc.
Privacy Policy:
This Privacy Policy is for this mailing list, and this mailing list only.
Email addresses collection through this mailing list are used explicitly to work within this email discussion list.
We only collect email addresses through our Closed-Loop Opt-In system.
We don't use your email address for any other purpose.
We won't be sharing your email address with any other entity.
Unsubscription can be done at any time. Please contact us at: justin@dadamailproject.com for any help regarding your subscription, including removal from the mailing list.
All mailing list messages sent from us will include a subscription removal link, which will allow you to remove yourself from this mailing list automatically, and permanently.
All consent to use your email address for any other purpose stated at the time of the mailing list subscription will also be revoked upon mailing list removal.