create default readme

README.md

@@ -1,3 +1,39 @@
 # cliverage
 
-Command-line tool to highlight code coverage in the terminal.
+```yaml
+go_package: git.xdrm.io/go/cliverage
+author: xdrm-brackets
+```
+
+Command-line tool to highlight code coverage in the terminal.
+
+### Requirements
+
+You need a recent system with golang installed.
+> It has not been tested under go 1.12.4
+
+### Installation
+
+You need to fetch and install the package with :
+```bash
+go get git.xdrm.io/go/cliverage
+```
+
+It should create the executable `cliverage` into the folder `$GOPATH/bin` (or `$GOBIN` if set).
+
+### Usage
+
+In order for the `cliverage` tool to run successfully, you need :
+- a path to your code's repository
+- the coverage file path (_see this [documentation](https://godoc.org/golang.org/x/tools/cover)_)
+
+
+Command usage :
+```bash
+cliverage <path-to-code> <coverage-file> <file-path>
+```
+
+Arguments :
+- `<path-to-code>` - path to where your code lives
+- `coverage-file` - path to the coverage file
+- `<file-path>` - path to a single file. You can use go package wildcards : `./...` prints every file, `./a/b/...` prints every file located into `./a/b`.