diff --git a/CHANGELOG.md b/CHANGELOG.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..ba731a419b1c7e67445e1e3427649123c0b3edf7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,11 @@
+<a name="0.1.0"></a>
+### 0.1.0 (2017-01-15)
+
+
+#### Features
+
+* use latest rbsso with checks for expiry and service_id	 ([ae91d93](/../../commit/ae91d93))
+* initial Omniauth Strategy	 ([925f544](/../../commit/925f544))
+
+
+
diff --git a/README.md b/README.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..b5c9d779cb07c7dd8f7f277cb1bdb1085d50cc31 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,5 @@
+Omniauth Strategy to use autistici / inventati sso.
+
+Used like other omniauth strategies. Requires a key to validate signatures and a service_id to identify the service itself.
+
+The constructor takes the service_id and the verification key as parameters. In comparison with other services they replace the id and the secret provided by the IDP.