README.markdown in punchblock-0.12.0 vs README.markdown in punchblock-1.0.0

@@ -1,31 +1,34 @@
-PUNCHBLOCK
-==========
+# Punchblock
+Punchblock is a middleware library for telephony applications. Like Rack is to Rails and Sinatra, Punchblock provides a consistent API on top of several underlying third-party call control protocols.
 
-Punchblock is a middleware library for telephony applications.  Like Rack is to
-Rails and Sinatra, Punchblock provides a consistent API on top of several
-underlying third-party call control protocols.
+In the same spirit that inspired Rack, the Punchblock library is envisioned to be the single library for call control wiring. Frameworks and applications may take advantage of Punchblock's single API to write powerful code for managing calls. Punchblock is not and will not be an application framework; rather it only surfaces the various protocols and presents a consistent interface to its consumers.
 
-Design
-------
+## Installation
+    gem install punchblock
 
-In the same spirit that inspired Rack, the Punchblock library is envisioned to
-be the single library for call control wiring. Frameworks and applications may
-take advantage of Punchblock's single API to write powerful code for managing
-calls. Punchblock is not and will not be an application framework; rather it
-only surfaces the various protocols and presents a consistent interface to its
-consumers.
+## Usage
 
-Supported Protocols
--------------------
+The best available usage documentation available for Punchblock is by example, in Adhearsion.
 
-Punchblock is still in very early stages so this list
-is what we plan to support:
+## Supported Protocols
 
-* Rayo (Tropo, Voxeo Prism)
-* AGI/AMI (Asterisk)
-* EventSocket (FreeSWITCH, maybe)
+* Rayo
+* Asterisk (AMI & AsyncAGI)
 
-Installation
-------------
+## Links:
+* [Source](https://github.com/adhearsion/punchblock)
+* [Documentation](http://rdoc.info/github/adhearsion/punchblock/master/frames)
+* [Bug Tracker](https://github.com/adhearsion/punchblock/issues)
 
-	gem install punchblock
+## Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  * If you want to have your own version, that is fine but bump version in a commit by itself so I can ignore when I pull
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2012 Adhearsion Foundation Inc. MIT licence (see LICENSE for details).