diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..44004e1
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,25 @@
+******************************
+Minimal set of PEAR core files
+******************************
+
+This repository provides a set of files from ``pear-core``
+that are often used in PEAR packages.
+
+It follows the ``pear-core`` repository and gets updated whenever a new
+PEAR version is released.
+
+It's meant to be used as dependency for composer packages.
+
+==============
+Included files
+==============
+- ``OS/Guess.php``
+- ``PEAR.php``
+- ``PEAR/Error.php``
+- ``PEAR/ErrorStack.php``
+- ``PEAR/ErrorStack5.php``
+- ``System.php``
+
+
+``PEAR/Error.php`` is a dummy file that only includes ``PEAR.php``,
+to make autoloaders work without problems.