Add specifying task to candle run
[candle] / README.md
index 0a43cf89dd4075acad4bd8bebf6215ad3a8905a1..14a6262d6eea6bfdf07a171029fc840c6620d101 100644 (file)
--- a/README.md
+++ b/README.md
@@ -8,6 +8,34 @@ as the machines on which the CI's are run.
 Each project with a candle file has a .candle file in the root of the project
 with tasks to be run.
 
+= Limitations =
+
+This documentation needs to be updated once more things are working, but this is an
+early version of everything.
+
+This only works in the following:
+
+ * SBCL
+ * Linux
+ * Git as source control
+ * AWS as remote code
+
+There is also no email, and everything else handled via the CLI.
+
+Only one can be running at a time.
+
 = Usage =
 
-Run bin/candle
+* Run bin/candle-server on a server somewhere, so that the candle client can connect to it
+* Add projects via `bin/candle project add`, see `--help` for more information
+* Remove projects via `bin/candle project delete`, see `--help` for more information
+* Run `bin/candle project show <name>` to show status of project
+  * Includes what branches are failing
+* Run `bin/candle project list` to show list all projects, and status
+* Run `bin/candle project refresh` to refresh a project
+* Run `bin/candle job log <project>:<sha>` to see log
+* Run `bin/candle job retry <project>:<sha>` to retry the job
+
+== Local ==
+
+* Run `bin/candle run` from a candle enabled project