diff --git a/subpackages/assertions/README.md b/subpackages/assertions/README.md
new file mode 100644
index 0000000..277af1a
--- /dev/null
+++ b/subpackages/assertions/README.md
@@ -0,0 +1,32 @@
+This module contains the following assertions:
+
+- shouldBeTrue
+- shouldBeFalse
+- shouldEqual
+- shouldNotEqual
+- shouldBeNull
+- shouldNotBeNull
+- shouldBeIn
+- shouldNotBeIn
+- shouldThrow
+- shouldThrowExactly
+- shouldNotThrow
+- shouldThrowWithMessage
+- shouldApproxEqual
+- shouldBeEmpty
+- shouldNotBeEmpty
+- shouldBeGreaterThan
+- shouldBeSmallerThan
+- shouldBeSameSetAs
+- shouldNotBeSameSetAs
+- shouldBeSameJsonAs
+- shouldBeBetween
+- shouldApprox
+
+It also contains the `should` -testing DSL. I.e.:
+```
+1.should == 1;
+1.should.not == 2;
+1.should in [1, 2, 3];
+4.should.not in [1, 2, 3];
+```