diff --git a/README.md b/README.md
index 707a90a..5907442 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,14 @@
 stb
 ===
 
-stb single-file libraries
+single-file public domain libraries for C/C++
 
-public domain
+library | description
+--------- | ---------
+**stb_image.c**       | image loading/decoding from disk/memory: JPG, PNG, TGA, BMP, PSD,GIF,HDR,PIC
+**stb_vorbis.c**      | decode 
+**stb_image_write.h** | image writing to disk
+**stb.h**             | helper functions for C, mostly redundant in C++
+**stb_c_lexer.h**     | simplify writing parsers for C-like languages
+**stb_perlin.h**      | revised Perlin noise (3D input, 1D output)
+**stb_textedit.h**    | guts of a text editor for games etc implementing them from scratch