= Discussions =

All Discussions objects are basically the same.  You get a set of
options which are inherited from the parent or provided.

== Roles and Permissions ==

A member can be in one of three states with respect to a resource:  

 * administrator: has all rights over a resource except as set by
   above resources;  Administrators of the root ('/') resource are
   site administrators and have all rights.

 * members:  has permissions of a resource as dictated by the
   administrator (view, post, etc).  [different types of members?
   groups?  probably not]

 * non-members: if an agent isn't a member of a resource, they
   generally have lowest level priveleges.

== Options ==

Options can be in one of three states:  unset, set, and locked (and
set + locked).  In
the case where the option is locked, all children inherit the setting
as well:

archive.lock = false

Locking an option prohibits any but a higher-level admin from
unlocking it.  The higher-level admin is free to change the setting:

archive.lock = false
archive = true

This locks the archive of subchildren into the false state, but sets
the archive for this discussion in the current discussion.

This prevents archiving on any sublist.  Messages to a list inherit
the list settings.

If an option is unset, it will use the settings of its parent, the
site defaults, or the application default, based on its type
(Forum or Discussion).


= Members =

== Preferences ==

Member preferences can also be set from the site level.

= Digest =

Different templates can be used to display different digest methods.
For instance, you could display a brief form of the message with just
the links:

{{{
Example of .ini configuration:

[digest:daily]
template = /path/to/templates/daily-digest.txt

}}}

This can be used to facilitate a moderated digest.  Roundup emails can
be sent about a discussion written and editted by the moderator.