Documentation with usage examples.

The examples are defined and described in an ERB template. Running ruby doc/update.rb uses a running server on localhost to generate the return values for the examples. The program can/should be moved to another repository (maybe as rake task). Another question is whether the examples should be part of the readme. At least the readme should link to the examples.