From 62c72682e8f4f1d5c539a7e785c0eb383a59f3e0 Mon Sep 17 00:00:00 2001
From: Mathieu Boespflug <m@tweag.io>
Date: Sat, 18 Apr 2020 12:12:11 +0200
Subject: [PATCH] Add links in README and expand intro

---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5ff44b839..0904f5a7f 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,18 @@
-# rules_nixpkgs
+# Nixpkgs rules for Bazel
 
 [![Build status](https://badge.buildkite.com/79bd0a8aa1e47a92e0254ca3afe5f439776e6d389cfbde9d8c.svg?branch=master)](https://buildkite.com/tweag-1/rules-nixpkgs)
 
-Rules for importing Nixpkgs packages into Bazel.
+Use Nixpkgs to import external dependencies (like system packages)
+into Bazel hermetically. If the version of any dependency changes,
+Bazel will correctly rebuild targets, and only those targets that use
+the external dependencies that changed.
+
+Links:
+* [Nix + Bazel = fully reproducible, incremental builds][blog-bazel-nix]
+* [Nix + Bazel lightning talk][youtube-bazel-nix]
+
+[blog-bazel-nix]: https://www.tweag.io/posts/2018-03-15-bazel-nix.html
+[youtube-bazel-nix]: https://www.youtube.com/watch?v=hDdDUrty1Gw
 
 ## Rules