diff --git a/README.md b/README.md
index deaf196..389d4b1 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,38 @@
-# trianglepacker
-Packs triangles of a 3D mesh into a rectangle/texture
+# Triangle Packer
+trianglepacker.h is a C/C++ single-file library that packs triangles from a 3D mesh into a 2D map with the specified size, border and spacing between the triangles.
+It uses a fast greedy algorithm.
+The output is not optimal!
+
+I implemented this to see how it performs in a light mapping context.
+Unfortunately, there are often visible seams between adjacent triangles.
+Neighbours in the mesh are located in completely different places in the map and thus are not interpolated correctly.
+Even slight differences of their edge intensities are very noticeable.
+Another disadvantage is, that all mesh vertices will be unique and can not be reused.
+I can imagine other use cases for this code. Please tell me yours ;).
+
+To paste the implementation into your project, insert the following lines:
+```
+#define TRIANGLEPACKER_IMPLEMENTATION
+#include "trianglepacker.h"
+```
+
+![Triangle Packer Example Output](https://github.com/ands/trianglepacker/raw/master/example_images/city_packed_border_0_spacing_2.png)
+
+# Example usage
+This example fits triangles into a specified map resolution
+```
+float scale3Dto2D;
+if (!tpPackIntoRect(
+	// mesh (consecutive triangle positions):
+	(const float*)mesh->positions, mesh->vertexCount,
+	// map (pixel-space parameters):
+	map->width, map->height, map->border, map->triangleSpacing,
+	// output (a [0..1]x[0..1] uv coordinate for each input vertex):
+	mesh->uvs,
+	// output (3D units to 2D pixel space scaling factor):
+	&scale3Dto2D))
+{
+	fprintf(stderr, "Could not find a scaling factor to fit all triangles into the map!\n");
+	return;
+}
+```
diff --git a/example_images/city_packed_border_0_spacing_2.png b/example_images/city_packed_border_0_spacing_2.png
new file mode 100644
index 0000000..bd7d370
Binary files /dev/null and b/example_images/city_packed_border_0_spacing_2.png differ