diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..31cf41da33aaee881e9083e7f16bd0b60c217e28
--- /dev/null
+++ b/README.md
@@ -0,0 +1,47 @@
+This repository groups a set of tools to easily use OAR.
+
+
+# Requirements
+
+Obviously, OAR needs to be installed on the system to be able to make use of these commands.
+
+Here are the requirements for each script:
+
+-   `oargen` requires python 2+ or 3+. It uses the `oarsub` command from OAR.
+-   `oarstats` requires python 2+ or 3+ and the *pyyaml* package. It uses the `oarstat` command from OAR.
+-   `batchoar` requires python 3+ and the *pyyaml* package. It uses the `oarsub` command from OAR.
+
+
+# Usage
+
+
+## OARGEN
+
+The basic usage of `oargen` is simply 'python oargen.py -r *command*' where *command* is the job
+to execute on the cluster.
+
+Several options can be used:
+
+-   **–run**: run the job on the cluster.
+-   **–time *TIME***: reservation walltime of your job. Accepted formats: *h*, *h:m* or *h:m:s*. Defaults to 10 hours.
+-   **&#x2013;core *NB<sub>CORES</sub>***: number of cores required by your job. Defaults to 1.
+-   **&#x2013;interative**: launch job in interative mode instead of passive.
+-   **&#x2013;gpu**: request GPUs.
+-   **&#x2013;host *host1* [/host2/&#x2026;/hostn/]**: name of the hosts allowed to be used on the cluster.
+-   **&#x2013;ignore-host *host1* [/host2/&#x2026;/hostn/]**: name of the hosts forbidden to be used on the cluster.
+-   **&#x2013;anterior *ANTERIOR<sub>ID</sub>***: job will only be launched once the job with the specified ID is finished.
+-   **&#x2013;checkpoint *delay***: enable the checkpoint signal with the given delay (in seconds).
+-   **&#x2013;name *name***: name of the job.
+-   **&#x2013;directory *directory***: directory in which will be stored the logs of the standard output and input.
+
+
+## OARSTATS
+
+The basic usage of `oarstats` is simply 'python oarstats.py'.
+It will print some information about the number of jobs, cores and gpus used by
+each user. It will also take into account the different queues.
+
+One option can be used:
+
+-   **&#x2013;show-hosts**: Adds an extra line for each user indicating which hosts are being used.
+
diff --git a/README.org b/README.org
index 8ada54b21f338265303471528107a997f9c7dfe4..9e4b0493457803a370f48f63f7b197464d9a3439 100644
--- a/README.org
+++ b/README.org
@@ -1,15 +1,21 @@
+#+options: toc:nil
+
 This repository groups a set of tools to easily use OAR.
 
 * Requirements
 
-+ *oargen* requires python 2+ or 3+.
-+ *batchoar* and *oarstats* require python 3+. The /pyyaml/ package is also required.
+Obviously, OAR needs to be installed on the system to be able to make use of these commands.
+
+Here are the requirements for each script:
++ ~oargen~ requires python 2+ or 3+. It uses the ~oarsub~ command from OAR.
++ ~oarstats~ requires python 2+ or 3+ and the /pyyaml/ package. It uses the ~oarstat~ command from OAR.
++ ~batchoar~ requires python 3+ and the /pyyaml/ package. It uses the ~oarsub~ command from OAR.
 
 * Usage
 
 ** OARGEN
 
-The basic usage of oargen is simply 'oargen.py -r /command/' where /command/ is the job
+The basic usage of ~oargen~ is simply 'python oargen.py -r /command/' where /command/ is the job
 to execute on the cluster.
 
 Several options can be used:
@@ -24,3 +30,12 @@ Several options can be used:
 + *--checkpoint /delay/*: enable the checkpoint signal with the given delay (in seconds).
 + *--name /name/*: name of the job.
 + *--directory /directory/*: directory in which will be stored the logs of the standard output and input.
+
+** OARSTATS
+
+The basic usage of ~oarstats~ is simply 'python oarstats.py'.
+It will print some information about the number of jobs, cores and gpus used by
+each user. It will also take into account the different queues.
+
+One option can be used:
++ *--show-hosts*: Adds an extra line for each user indicating which hosts are being used.