From ab8f063e591642b7cb2e74654d7b37b54aa86844 Mon Sep 17 00:00:00 2001
From: Antoine Augusti <antoine@drivy.com>
Date: Thu, 20 Jul 2017 14:52:17 +0200
Subject: [PATCH] README: definition, cron process, web UI

---
 README.md | 46 +++++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 43 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 9f3595c..ac549c4 100644
--- a/README.md
+++ b/README.md
@@ -15,6 +15,9 @@ gem 'zhong'
 
 ## Usage
 
+### Zhong schedule
+Create a definition file, let's call it `zhong.rb`:
+
 ```ruby
 Zhong.redis = Redis.new(url: ENV["ZHONG_REDIS_URL"])
 
@@ -76,18 +79,55 @@ Zhong.schedule do
 end
 ```
 
+This file only describes what should be the schedule. Nothing will be executed
+until we actually run
+```ruby
+Zhong.start
+```
+after describing the Zhong schedule.
+
+### Zhong cron process
+
+You can run the cron process that will execute your code from the definitions
+in the `zhong.rb` file by running:
+```sh
+zhong zhong.rb
+```
+
 ## Web UI
 
 Zhong comes with a web application that can display jobs, their last run and
 enable/disable them.
 
-### Rails
+This is a Sinatra application that requires at least `v2.0.0`. You can add to your Gemfile
+```ruby
+gem 'sinatra', "~>2.0"
+```
+
+It can be protected by HTTP basic authentication by
+setting the following environment variables:
+- `ZHONG_WEB_USERNAME`: the username
+- `ZHONG_WEB_PASSWORD`: the password
 
-Add the following to your config/routes.rb:
+You'll need to load the Zhong schedule to be able to see jobs in the web UI, typically
+by requiring your `zhong.rb` definition file.
 
+### Rails
+Load the Zhong schedule by creating an initializer at `config/initializers/zhong.rb`,
+with the following content:
+```ruby
+require "#{Rails.root}/zhong.rb"
+```
+
+Add the following to your `config/routes.rb`:
 ```ruby
 require 'zhong/web'
-mount Zhong::Web, at: "zhong"
+
+Rails.application.routes.draw do
+  # Other routes here...
+
+  mount Zhong::Web, at: "/zhong"
+end
 ```
 
 ## History