1 files changed, 19 insertions, 2 deletions

diff --git a/README.md b/README.md
index 8bee0b6..b6b7b58 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,20 @@
-# barb
+BARB
+====
+
+[Barb logo](doc/logo.png)
+
+Barb is a file-based API query tool written in Rust that works nicely with version control and fits into unix terminal usage.
+
+## Example usage
+
+(not working yet)
+
+```
+barb <file1> <file2>
+```
+
+## Credits
+
+- Code: [Guillaume Pasquet](https://gitlab.com/guillaume54/)
+- Logo: [Harpoon Chain Icon](https://game-icons.net/1x1/lorc/harpoon-chain.html) by Lorc under CC By 3.0
 
-Barb is a file-based API query tool written in Rust that works nicely with version control and fits into unix terminal usage.
\ No newline at end of file