From 622321625fdc71fc412d91578a87bdd5f32f3434 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Roman=20Smr=C5=BE?= <roman.smrz@seznam.cz>
Date: Tue, 30 Jul 2024 17:56:15 +0200
Subject: Add README file

---
 README.md | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..abd0500
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+MiniCI
+======
+
+MiniCI runs jobs defined in the `minici.yaml` file in the root of the project
+(on the same level as the `.git` directory). With that, `minici` invocation can
+execute the jobs for local commits that are not yet in upstream (remote) branch
+or for any manually given commit range.
+
+
+Job definition
+--------------
+
+The top-level elements of the YAML file are `job <name>` defining steps to
+perform the job and potentially listing artefacts produced or required.
+
+Example:
+
+```
+job build:
+  shell:
+    - make
+  artifact bin:
+    path: build/example
+
+job test:
+  uses:
+    - build.bin
+  shell:
+    - ./build/example test
+```
+
+Each job is a map with the following attributes:
+
+`shell`
+: List of shell commands to perform the job
+
+`artifact <name>` (optional)
+: Defines artifact `<name>` produced by this job. Is itself defined as a dictionary.
+
+`artifact <name>.path`
+: Path to the produced artifact file, relative to the root of the project.
+
+`uses` (optional)
+: List of artifact required for this job, in the form `<job>.<artifact>`.
+
+
+Usage
+-----
+
+To run jobs for a git commit range:
+```
+minici run <commit>..<commit>
+```
+
+To run jobs for commits that are in local `<branch>`, but not yet in its upstream:
+```
+minici run <branch>
+```
+
+For currently branch, the name can be omitted:
+```
+minici run
+```
-- 
cgit v1.2.3