README.md in posix-mqueue-0.0.1 vs README.md in posix-mqueue-0.0.2

@@ -1,5 +1,31 @@
-# Posix::Mqueue
+# posix-mqueue
 
-Minimal wrapper around the [POSIX message queue](pmq).
+Minimal wrapper around the [POSIX message queue](pmq). The POSIX message queue
+offers:
+
+* Persistence. Push messages while nothing is listening.
+* Simplicity. Nothing to set up. Built into Linux.
+* IPC. Blazingly fast communication between processes on the same machine.
+* Blocking and non-blocking. Listeners block until a message arrives on the
+  queue. No polling. Sending messages doesn't block.
+
+Add `gem 'posix-mqueue'` to your favorite Gemfile.
+
+Still WIP. Not stable. Not everything works as promised.
+
+## Usage
+
+```ruby
+m = POSIX::Mqueue.new("/whatever")
+m.send "hello"
+puts m.receive
+# => "hello"
+
+fork { POSIX::Mqueue.new("/whatever").send("world") }
+
+# Blocks until the forked process pushes to the queue
+m.receive
+# => "world"
+```
 
 [pmq]: http://man7.org/linux/man-pages/man7/mq_overview.7.html