diff --git a/README.md b/README.md
index 8aff0b8..1c5fe6d 100644
--- a/README.md
+++ b/README.md
@@ -1,15 +1,23 @@
 # Uphold Validator.js
 
-Extensive validations built on top of validator.js.
+Extensive validations built on top of
+[validator.js](https://github.com/guillaumepotier/validator.js).
 
-Improvements over validator.js:
- - extended set of asserts
- - logging with debugnyan
- - throwing specific errors on validation failures
+Improvements over `validator.js`:
+
+- [extended set of asserts](https://github.com/uphold/validator.js-asserts)
+- logging with [debugnyan](https://github.com/uphold/debugnyan)
+- throwing specific errors on validation failures
 
 ## Install
 
-Add to your package.json dependencies:
+Install the package via `yarn`:
+
+```sh
+yarn add @uphold/validator.js
+```
+
+or via `npm`:
 
 ```sh
 npm install @uphold/validator.js
diff --git a/package.json b/package.json
index db0ffbb..eb49285 100644
--- a/package.json
+++ b/package.json
@@ -5,6 +5,7 @@
   "main": "index.js",
   "author": "Uphold",
   "license": "MIT",
+  "repository": "uphold/uphold-validator.js",
   "scripts": {
     "changelog": "uphold-scripts changelog $npm_package_version",
     "lint": "uphold-scripts lint",