update README

1 files changed, 32 insertions, 7 deletions

diff --git a/README.md b/README.md
index 454410d..d378703 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
 # zip-crystal
 
-TODO: Write a description here
+Read and write zip archives natively from
+[Crystal](http://crystal-lang.org/).
 
 ## Installation
 
@@ -10,7 +11,7 @@ Add this to your application's `shard.yml`:
 ```yaml
 dependencies:
   zip-crystal:
-    github: [your-github-name]/zip-crystal
+    github: pablotron/zip-crystal
 ```
 
 
@@ -18,11 +19,35 @@ dependencies:
 
 
 ```crystal
-require "zip-crystal"
+require "zip-crystal/zip"
+
+# write to "foo.zip"
+Zip.write("foo.zip") do |zip|
+  # add "bar.txt" with contents "hello!"
+  zip.add("bar.txt", "hello!")
+
+  # add local file "/path/to/image.png" as "image.png"
+  zip.add_file("image.png", "/path/to/image.png")
+end
+
+# create memory io
+mem_io = MemoryIO.new
+
+# open "/some/other/path/image.png" for writing
+File.open("/some/other/path/image.png", "wb") do |file_io|
+  # read from "foo.zip"
+  Zip.read("foo.zip") do |zip|
+    # extract "bar.txt" to mem_io
+    zip["bar.txt"].read(mem_io)
+
+    # extract "image.png" to file_io
+    zip["image.png"].read(file_io)
+  end
+end
 ```
 
-
-TODO: Write usage instructions here
+See the [API documentation](https://pablotron.github.com/zip-crystal/)
+for additional information.
 
 ## Development
 
@@ -30,7 +55,7 @@ TODO: Write development instructions here
 
 ## Contributing
 
-1. Fork it ( https://github.com/[your-github-name]/zip-crystal/fork )
+1. Fork it ( https://github.com/pablotron/zip-crystal/fork )
 2. Create your feature branch (git checkout -b my-new-feature)
 3. Commit your changes (git commit -am 'Add some feature')
 4. Push to the branch (git push origin my-new-feature)
@@ -38,4 +63,4 @@ TODO: Write development instructions here
 
 ## Contributors
 
-- [[your-github-name]](https://github.com/[your-github-name]) Paul Duncan - creator, maintainer
+- [pablotron](https://github.com/pablotron) Paul Duncan - creator, maintainer