diff --git a/README.md b/README.md
index db1a13c..a28dd4e 100755
--- a/README.md
+++ b/README.md
@@ -23,3 +23,8 @@ julia>]     # Type ] to enter Pkg
 
 pkg> add https://github.com/edwinb-ai/Newtman.jl.git
 ```
+
+## Usage
+
+There used to be a _Demo_ section to showcase how this package works. Now a couple of examples
+can be read on the [documentation]((https://edwinb-ai.github.io/Newtman.jl/dev)).