diff --git a/README.md b/README.md
index 64bd59f472bcb2813a137eec85f55f64f0f7bcb2..3377edc20a35bc61180a860ebe9a7f1dd9b907cf 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,14 @@
-# php-device-cookies
+# PHP device cookies
 Implementation of Device Cookies in PHP
+
+Heavily based on [Device cookie example](https://github.com/Rundiz/device-cookies-example), which is an implementation of [Device cookies](https://owasp.org/www-community/Slow_Down_Online_Guessing_Attacks_with_Device_Cookies) described by OWASP.
+
+## Installation
+
+```
+composer install php-device-cookies
+```
+
+## Usage
+
+Use the provided `DeviceCookies` class.