Update documentation

README.md

@@ -4,13 +4,38 @@
 
 A promise library & concurrency toolkit for Clojure and ClojureScript.
 
-This library exposes a bunch of usefull syntactic abstractions that
-will considerably simplify to work with promises (in a very similar
-way as you will do it in JS with async/await).
+This library exposes a bunch of usefull syntactic abstractions that will considerably simplify to
+work with promises (in a very similar way as you will do it in JS with async/await) and many helpers
+from executors to concurrency patterns (bulkhead & CSP).
 
-Here you have the [User Guide][0] and the [API documentation][1].
+Here you can look a detailed [documentation][1].
 
 
+## Getting Started
+
+deps.edn:
+
+```clojure
+funcool/promesa {:mvn/version "9.1.536"}
+```
+
+Leiningen:
+
+```clojure
+[funcool/promesa "9.1.536"]
+```
+
+## On the REPL
+
+```clojure
+(require '[promesa.core :as p])
+
+(->> (p/promise 1)
+     (p/map inc)
+     (deref)
+;; => 2
+```
+
 ## Contributing
 
 If you miss something, feel free to open an issue for a discussion. If
@@ -32,5 +57,4 @@ npm install
 npm test
 ```
 
-[0]: https://funcool.github.io/promesa/latest/user-guide.html
 [1]: https://funcool.github.io/promesa/latest/

doc.clj

@@ -8,8 +8,7 @@
   :source-paths ["src"]
   :namespaces [#"^promesa\."]
   :doc-files
-  ["doc/intro.md"
-   "doc/promises.md"
+  ["doc/promises.md"
    "doc/executors.md"
    "doc/channels.md"
    "doc/bulkhead.md"