Steven! Ragnarök committed b24281c

Populate README with real info.

Comments (0)

Files changed (1)

 # Bonk
-TODO: Write a gem description
+*Why is it called bonk?* __Because it's a really hard tap.__
+Bonk is a gem which adds the super cool bonk method to Ruby's `Object` class.
+It can be thought of as `#map` for individual objects or a really hard `#tap`.
+The semantics of Bonk are identical to `[object].map{|o| ... }.first` but
+without all that tedious mucking about in hyperspace.
+Why would you bother using bonk?
+- I dunno, I just like to avoid unnecessary temporary variables.
+- Bonk came about because I wanted to take an ActiveRecord model and send
+them through a reporting script I wrote that took hashes of information. I tried
+to do the transformation inline.
 ## Installation
 ## Usage
-TODO: Write usage instructions here
+Project.find(42).owner.bonk do |o|
+  { :id =>, :name => o.realname,
+    :problem => "Never updated credit card information." }
+## Disclaimer
+Don't trust this gem with nuclear submarine controls. I seriously conceived it
+and wrote it after two train rides and a late night conversation with my very
+annoyed girlfriend.
 ## Contributing
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Added some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+1. File an issue explaining the semantics of your proposed extension.
+1. Get it approved or make your own simple gem.
+1. Fork it on [GitHub] or [BitBucket].
+2. Create your feature branch.
+3. Commit your changes.
+4. Push to the branch.
+5. Create a new Pull Request.