READMEstuffins

README.md

-# RbNaCl::Libsodium
+RbNaCl::Libsodium
+=================
+[![Gem Version](https://badge.fury.io/rb/rbnacl-libsodium.png)](http://badge.fury.io/rb/rbnacl-libsodium)
 
-RbNaCl + libsodium packaged as a gem
+[RbNaCl] is a Ruby wrapper for [libsodium], a portable version of the Networking and
+Cryptography library ([NaCl]) created by Daniel J. Bernstein.
+
+tl;dr: it's one of the best crypto libraries around.
+
+rbnacl-libsodium packages the libsodium library as a Ruby Gem so you don't have
+to worry about installing it through system packages. It builds just like a
+native extension, but since RbNaCl is implemented with FFI, works on JRuby too!
+
+[RbNaCl]: https://github.com/cryptosphere/rbnacl
+[libsodium]: https://github.com/jedisct1/libsodium
+[NaCl]: http://nacl.cr.yp.to/
 
 ## Installation