shithub: werc

Download patch

ref: b28035b1b6cc9220c2449d1066fd25606571a69d
parent: 0ff9d7d6ecc1675ef97fbd81d1736f5a3018e2a9
author: uriel <uriel@vm41.cat-v.org>
date: Sat Aug 15 23:26:57 EDT 2009

Commit documentation changes from the live site.

--- a/sites/werc.cat-v.org/development/todo.md
+++ b/sites/werc.cat-v.org/development/todo.md
@@ -5,7 +5,7 @@
 * Canonize and redirect all requests, we already do this for things like missing or trailing /, should do the same for /. and /./, etc. Deleting trailing . and , should make pasted urls in emails work as links (**Mostly done in RC1**)
 * Blog:
 	* Comment threading.
-	* Some form of pagination (taking advantage of history browsing.)
+	* Some form of pagination (taking advantage of history browsing.) (**Partially done**)
 * Sitemaps:
 	* Index pages should be used for description of directories.
 	* Cache web sitemap generation. (**Done in RC0**)
--- a/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md
+++ b/sites/werc.cat-v.org/docs/web_server_setup/plan_9_httpd.md
@@ -40,6 +40,13 @@
 found for this, you will have to keep your site in a sub-directory of the web
 server root.
 
+In your /lib/namespace.httpd you probably will want to add something along the
+following lines to bind the werc directory into the httpd's namespace:
+
+    bind -b /usr/glenda/src/werc/ /usr/web/
+    bind /usr/glenda/src/werc/bin/ /usr/web/magic/
+
+
 **Notes**: This is experimental and work in progress, there are a couple of issues
 with the werc code itself that might need fixing, in particular you will need
 to replace the '%($"extraHeaders%)' in lib/headers.tpl with '% echo
--- a/sites/werc.cat-v.org/index.md
+++ b/sites/werc.cat-v.org/index.md
@@ -1,14 +1,16 @@
-werc - A sane web framework
-=============================
-
-Werc is a minimalist web framework built on the Unix and Plan 9 *tool philosophy* of software design.
+werc - A sane web anti-framework
+================================
 
-Werc avoids the pain of managing collections of websites and developing web applications.
+Werc is a minimalist web anti-framework built following the Unix and Plan 9
+*tool philosophy* of software design.
 
+Werc avoids the pain of managing collections of websites and developing web
+applications.
+
 * Database free, uses files and directories instead.
-* Written using the rc shell, leveraging the standard Unix/Plan 9 command toolkit.
+* Written using [the rc shell](http://rc.cat-v.org), leveraging the standard Unix/Plan 9 command toolkit.
 * Minimize tedious work: eg., no need to ever write HTML, use markdown (or any other format) instead.
-* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular apps.
+* Very minimalist yet extensible codebase: highly functional core is 150 lines, with extra functionality in modular [apps](/apps/).
 
 
 Features
@@ -16,9 +18,9 @@
 
 Here are some of the features provided by werc:
 
-* Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the site.
-* You can use your favorite tools (text editor, file manager, etc) to edit and manage data stored in werc.
-* Designed to manage any number of 'virtual' domains that share a common style, layout, etc from a single werc installation.
+* Good integration with pre-existing content, you can add HTML or plain text files and they will be seamlessly integrated with the rest of the site.
+* You can use your favorite tools (text editor, shell, file manager, etc) to edit, manipulate and manage data stored in werc.
+* Designed to manage any number of 'virtual' domains that share a common style and layout from a single werc installation.
 * Configuration and customization can be at at any level: global, per-domain-group, domain-wide, directory sub-tree, and single file.
 * Can trivially run multiple (customized) versions of werc side by side.
 * Very simple and flexible user management and permissions system.
@@ -38,24 +40,28 @@
 Werc can use any HTTP server that can handle CGI, and has been tested with at
 least Apache, Lighttpd, Cherokee, nhttpd, Hiawatha, and others.
 
-Werc uses markdown by default (and the standard Perl markdown is included with the distribution), to format documents, but any other formatting
-system can be used.
+Werc uses markdown by default (and the standard Perl markdown is included with
+the distribution), to format documents, but any other formatting system can be
+used.
 
 
-Latest Source
--------------
+Source
+------
 
-To get a copy of the latest development code using mercurial, do:
+To get a copy of the latest stable code using mercurial, do:
 
 	hg clone http://gsoc.cat-v.org/hg/werc/
 
 You can also [browse the online repository](http://gsoc.cat-v.org/hg/werc/).
 
+The latest development branch is located at http://gsoc.cat-v.org/hg/werc-dev/
 
+
 Contact
 -------
 
-For questions, suggestions, bugrepports and contributing patches you can join the [werc9 mailinglist](http://groups.google.com/group/werc9).
+For questions, suggestions, bugrepports and contributing patches you can join
+the [werc9 mailinglist](http://groups.google.com/group/werc9).
 
 On irc, join [#werc](irc://irc.freenode.org/werc) on irc.freenode.org
 
@@ -69,7 +75,10 @@
 License
 -------
 
-Public domain (by default includes markdown.pl which has a different license, but this can be replaced).
+Public domain, [because so called 'intellectual property' is an oxymoron](http://harmful.cat-v.org/economics/intellectual_property/).
+
+(By default includes markdown.pl which has a different license, but this can be
+replaced).
 
 Credits
 -------