README.md in shopify-ruby-definitions-0.0.1 vs README.md in shopify-ruby-definitions-1.0.0

@@ -1,22 +1,45 @@
\ No newline at end of file
+# shopify-ruby-definitions
+
+This repository contains [ruby-build](https://github.com/rbenv/ruby-build/) definitions of Rubies we use at Shopify. These builds are generally API complient with release Rubies, but with additional backports for bugfixes and performance.
+
+## Quick start
+
+1. Install ruby-build by [following the instructions](https://github.com/rbenv/ruby-build/#installation).
+1. Install the gem:
+    ```
+    $ gem install shopify-ruby-definitions
+    ```
+1. Acquire the specific Ruby version of the Ruby version you want to install. Ruby 3.2 is used as an example here:
+    ```
+    $ export RUBY_VERSION=`ruby -rshopify_ruby_definitions -e 'puts ShopifyRubyDefinitions.resolve_version("3.2")'`
+    ```
+1. Set the definitions path for ruby-build:
+    ```
+    $ export RUBY_BUILD_DEFINITIONS=`ruby -rshopify_ruby_definitions -e 'puts ShopifyRubyDefinitions::RubyVersions::VERSIONS_DIRECTORY'`
+    ```
+1. Install the Ruby version using ruby-build:
+    ```
+    ruby-build $RUBY_VERSION
+    ```