From e74f2966ca4f9246b096c08d7ab9076e839eb859 Mon Sep 17 00:00:00 2001
From: Uriel <u@berlinblue.org>
Date: Tue, 3 Mar 2009 12:32:39 +0000
Subject: [PATCH] Documentation updates.

---
 sites/werc.cat-v.org/apps/blagh/index.md      | 32 +++++++++++++++++++
 sites/werc.cat-v.org/apps/bridge/index.md     |  8 +++++
 .../docs/web_server_setup/nhttpd.md           |  6 ++--
 3 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/sites/werc.cat-v.org/apps/blagh/index.md b/sites/werc.cat-v.org/apps/blagh/index.md
index 5330024..c9829dd 100644
--- a/sites/werc.cat-v.org/apps/blagh/index.md
+++ b/sites/werc.cat-v.org/apps/blagh/index.md
@@ -14,3 +14,35 @@ Some features include:
 
 Possible alternative names: Blag, Blah, Bragg.
 
+Posting
+-------
+
+New pots can be created in at least two different ways: using the web interface (if you have logged in and your user or groups are in `$conf_blog_editors`) or from the command line using the script at bin/aux/bpst.rc, as you can see from the source of that very simple script, it is trivial to create new posts by simply using mkdir and echo.
+
+Configuration options
+---------------------
+
+This are options you can set in your _werc/config 
+
+### `conf_enable_blog` *[blog dirs]*
+
+Setup a blog in this dir. By default the blog contents will only include posts stored in this dir, if you pass any arguments the posts in the various dirs will be aggregated in this feed.
+
+Examples:
+
+    # This will setup a blog in this dir that includes only posts in this dir.
+    conf_enable_blog 
+
+    # This will create a blog that aggregates all the posts in all blog dirs in any users/ sub dir.
+    conf_enable_blog users/*/blog 
+
+### `conf_blog_editors`=(*groups or users that will be allowed to make new blog posts*)
+
+This is optional and by default set to the 'blog-editors' group.
+
+See also:
+
+* To edit blog posts you can use the functionality provided by [the dirdir app](../dirdir/).
+* Commenting can be handled by [the bridge app](../bridge/).
+
+
diff --git a/sites/werc.cat-v.org/apps/bridge/index.md b/sites/werc.cat-v.org/apps/bridge/index.md
index d148987..8c381b2 100644
--- a/sites/werc.cat-v.org/apps/bridge/index.md
+++ b/sites/werc.cat-v.org/apps/bridge/index.md
@@ -3,3 +3,11 @@ Bridge
 
 Bridge is a comments/forum application for werc, which lets people post comments related to any existing document/element.
 
+
+Configuration options
+---------------------
+
+### `conf_enable_comments` [-n] [*users and groups allowed to comment*]
+
+This will enable comments in this directory and all sub-directories. `-n` enables commenting by unregistered users (their posts will be set aside for review and approval by administrators).
+
diff --git a/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md b/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md
index d97ea5a..3dc4927 100644
--- a/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md
+++ b/sites/werc.cat-v.org/docs/web_server_setup/nhttpd.md
@@ -1,5 +1,5 @@
-Nhttpd config for werc
-======================
+Nhttpd/Nostromo  Web Server Configuration for Werc
+==================================================
 
 Contributed by nsz, thanks!
 
@@ -54,3 +54,5 @@ To solve this problem just add a
     SERVER_NAME=$HTTP_HOST
 
 line somewhere at the top of `werc.rc`.
+
+