]> code.citadel.org Git - citadel.git/blob - citadel/techdoc/moderation.txt
* do_template() now parses a .wml file for WAP clients, and a .html file
[citadel.git] / citadel / techdoc / moderation.txt
1 (NOTE: the moderation system is not finished yet, and as such, as been
2 disabled in the current release.)
3
4  TECHNICAL DISCUSSION OF THE CITADEL/UX MODERATION SYSTEM
5  
6  Starting with version ?.??, the Citadel system supports moderation of
7 messages.  This is used for both internal processing and for the more
8 traditional filtering purposes.
9  
10  The central design thrust behind this design is to maximize the
11 "signal to noise ratio" while minimizing "censorship."  Users may choose to
12 filter at a very low threshold, reading everything, or at a higher threshold,
13 reading only selected messages.
14  
15  Each message now carries a moderation level in its supplementary message base
16 record (smi.smi_mod).  This is an 8-bit signed integer with values ranging from
17 -127 to 127.  The following standards apply:
18
19
20         LEVEL           PURPOSE
21
22         -127            "System overhead" message.  These should never be
23                         shown to users.  An overhead message might contain
24                         the room's network configuration or something to that
25                         effect.  (Not yet implemented, but we probably will
26                         do it this way.)
27
28         -100            Deleted message.  Aides might choose to browse deleted
29                         messages, un-deleting them if appropriate.
30
31         -63 to +63      Normal user-mode messages.  All messages start out at
32                         level 0 when first posted (or when no supplementary
33                         message base record exists).
34
35
36  On a typical hobbyist BBS with a small administrative staff, most messages
37 will remain at level 0, with perhaps the off-topic ones getting moderated
38 to -1 or -2, providing the less tolerant users with a way of avoiding reading
39 through drivel.
40  
41  On a very large system with many active moderators, there might be a high
42 level of activity involving moderating _up_ the messages that are the most
43 poignant or pertinent.  In this case, users might choose to filter at a level
44 higher than 0, seeing only the messages that someone decided were worth
45 reading.