diff --git a/README.md b/README.md
index ba1aef1..8df9f46 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,7 @@
# tszip
-Compression utilities for tree sequences
+[](https://circleci.com/gh/tskit-dev/tszip) [](https://ci.appveyor.com/project/tskit-dev/tszip) [](https://codecov.io/gh/tskit-dev/tszip) [](https://tszip.readthedocs.io/en/latest/?badge=latest)
+
+Gzip-like compression for [tskit](https://tskit.readthedocs.io/) tree sequences.
+
+Please see the [documentation](https://tszip.readthedocs.io/) for more details
+and [installation instructions](https://tszip.readthedocs.io/en/latest/installation.html).
diff --git a/README.rst b/README.rst
index 1d0c03f..beadbfd 100644
--- a/README.rst
+++ b/README.rst
@@ -1,12 +1,9 @@
-Compression utilities for tree sequences.
+Gzip-like compression for tskit tree sequences.
Tszip is a command line utility and Python library for converting the
``.trees`` files used by `tskit `_
into a highly compressed format. Please see the
-`documentation `_
-for more details.
-
-Please see the
-`installation instructions `_
-to get started quickly.
+`documentation `_
+for more details and
+`installation instructions `_.