diff --git a/CHANGELOG.md b/CHANGELOG.md
index 317bd354..b7eecd79 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,8 +13,8 @@ Changes:
 - Added basic webhook support - https://github.com/code-corps/stripity_stripe/pull/244
 
 ## 1.0.0 to 1.4.0
-
-- Sadly the changes have not been properly tracked here. We will compile a list
+- Added support to generate connect button URLs - https://github.com/code-corps/stripity_stripe/pull/231
+- Sadly, other changes have not been properly tracked here. We will compile a list
 as soon as we are able
 
 ## 1.0.0 (2015-12-22)
diff --git a/lib/stripe/connect.ex b/lib/stripe/connect.ex
index 2c5737a9..fa2b4687 100644
--- a/lib/stripe/connect.ex
+++ b/lib/stripe/connect.ex
@@ -16,9 +16,28 @@ defmodule Stripe.Connect do
 
   @doc """
   Generate the URL to start a stripe workflow. You can pass in a
-  crsf token to be sent to stripe, which they send you back at the end of the workflow to further secure the interaction. Make sure you verify this token yourself on reception of the workflow callback.
+  csrf token to be sent to stripe, which they send you back at the
+  end of the workflow to further secure the interaction.
+  Make sure you verify this token yourself on reception of the workflow callback.
+  # Example
+  ```
+  "some-csrf-token"
+  |> Stripe.Connect.generate_button_url()
+  |> IO.inspect
+  https://sandbox.connect.stripe.com/ouath/authorize?response_type=code&scope=read_write&client_id=122qwXyzrandom&state=some-csrf-token
+
+  ```
+
+  You can also pass in a redirect URI as a second parameter if you have multiple possible redirect URIs.
+  # Example
+  ```
+  "some-csrf-token"
+  |> Stripe.Connect.generate_button_url("https://myapp.domain/receive-stripe-connect")
+  |> IO.inspect
+  https://sandbox.connect.stripe.com/ouath/authorize?response_type=code&scope=read_write&client_id=122qwXyzrandom&state=some-csrf-token&redirect_uri=https://myapp.domain/receive-stripe-connect
+
+  ```
 
-  You can also pass redirect_uri as a second parameter if you have multiple possible redirect_uris
   """
   def generate_button_url( csrf_token , redirect_uri \\ "" ) do
     url = base_url() <> "oauth/authorize?response_type=code"