summaryrefslogtreecommitdiff
path: root/src/SW/Sietima/document.en.rest.txt
diff options
context:
space:
mode:
Diffstat (limited to 'src/SW/Sietima/document.en.rest.txt')
-rw-r--r--src/SW/Sietima/document.en.rest.txt40
1 files changed, 36 insertions, 4 deletions
diff --git a/src/SW/Sietima/document.en.rest.txt b/src/SW/Sietima/document.en.rest.txt
index 27f0a65..846c504 100644
--- a/src/SW/Sietima/document.en.rest.txt
+++ b/src/SW/Sietima/document.en.rest.txt
@@ -11,8 +11,7 @@ What is it
Sietima is a mailing list manager construction toolkit, written in
Perl 5. It's an exercise in modularity, a showcase of the latest
-features of Perl 5, and should eventually include an actually usable
-mailing list manager.
+features of Perl 5, and an actually usable mailing list manager.
History
=======
@@ -35,7 +34,38 @@ Construction toolkit?
Sietima provides a bunch of modules you can plug together to make your
ideal mlm. Writing new plugins to add features should be as easy as
-possible. It is currently not a "just works" application, though.
+possible. It is currently not a "just works" application, although the
+repository includes an `example application`_ that works.
+
+Is it production-ready?
+=======================
+
+Yes! I'm using Sietima to run three mailing lists on this
+domain. Since I use ``qmail``, I have the following configuration:
+
+- ``/var/qmail/users/assign`` contains lines like::
+
+ +the-list:mailinglists:1016:1004:/var/qmail/mailinglists/:-:the-list:
+
+ so messages sent to ``the-list@thenautilus.net`` (and all addresses
+ of the form ``the-list-*@thenautilus.net``) are routed to the
+ ``mailinglists`` user
+
+- ``/var/qmail/mailinglists/.qmail-the-list`` is::
+
+ |/usr/local/sietima/bin/sietima-the-list send
+
+ so messages sent to the list go through the list-specific program
+
+- ``/var/qmail/mailinglists/.qmail-the-list-bounce`` is::
+
+ &dakkar@thenautilus.net
+
+ so bounces go to me (I haven't written VERP or bounce handler
+ plugins)
+
+- ``/usr/local/sietima/bin/sietima-the-list`` looks very much like the
+ `example application`_
Contributing
============
@@ -49,7 +79,9 @@ me about it`_. Or `ask me to give you write access to the repository`_.
.. _`YAPC::EU 2003`: http://conferences.mongueurs.net/ye2003/talk/355
.. _`the full history as written by Simon`: http://www.thegestalt.org/simon/siesta-article.pod
-.. _`the source code`: https://www.thenautilus.net/cgit/Sietima/
+.. _`example application`: /cgit/Sietima/tree/example/sietima
+
+.. _`the source code`: /cgit/Sietima/
.. _`email me about it`: mailto:dakkar@thenautilus.net?subject=Code%20for%20Sietima
.. _`ask me to give you write access to the repository`: mailto:dakkar@thenautilus.net?subject=Please%20allow%20me%20to%20push%20to%20Sietima