diff --git a/README.md b/README.md
index 1447bc4..e1dbe61 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-# `elixir-auth-microsoft`
+
elixir-auth-microsoft
The _easy_ way to add **Microsoft `OAuth` authentication**
to your **`Elixir` / `Phoenix`** app.
@@ -19,6 +19,29 @@ Just plug-and-play in **5 mins**.
+- [_Why_? 🤷](#why-)
+- [_What_? 💭](#what-)
+- [_Who_? 👥](#who-)
+- [_How_? ✅](#how-)
+ - [1. Add the hex package to `deps` 📦](#1-add-the-hex-package-to-deps-)
+ - [2. Create an App Registration in Azure Active Directory 🆕](#2-create-an-app-registration-in-azure-active-directory-)
+ - [3. Export Environment / Application Variables](#3-export-environment--application-variables)
+ - [A note on tenants](#a-note-on-tenants)
+ - [4. Add a "Sign in with Microsoft" Button to your App](#4-add-a-sign-in-with-microsoft-button-to-your-app)
+ - [5. Use the Built-in Functions to Authenticate People :shipit:](#5-use-the-built-in-functions-to-authenticate-people-shipit)
+ - [6. Add the `/auth/microsoft/callback` to `router.ex`](#6-add-the-authmicrosoftcallback-to-routerex)
+ - [6.1 Give it a try!](#61-give-it-a-try)
+ - [7. Logging the person out](#7-logging-the-person-out)
+ - [7.1 Setting up the post-logout redirect URI](#71-setting-up-the-post-logout-redirect-uri)
+ - [7.2 Add button for person to log out](#72-add-button-for-person-to-log-out)
+ - [_Done_!](#done)
+ - [Testing](#testing)
+ - [Complete Working Demo / Example `Phoenix` App 🚀](#complete-working-demo--example-phoenix-app-)
+ - [Optimised SVG + CSS Button](#optimised-svg--css-button)
+ - [Notes 📝](#notes-)
+ - [Branding Guidelines](#branding-guidelines)
+
+
# _Why_? 🤷
Following
@@ -403,6 +426,30 @@ Thank you! 🙏
+
+## Testing
+
+If you want pre-defined responses without making real requests
+when testing,
+you can add the following property `httpoison_mock`
+in your `test.exs` configuration file.
+
+```elixir
+config :elixir_auth_microsoft,
+ httpoison_mock: true
+```
+
+With this setting turned on,
+calls will return successful requests
+with mock data.
+
+Of course, you could always a mocking library like
+[`mox`](https://github.com/dashbitco/mox)
+for this.
+But if you want a quick way to test your app with this package,
+this option may be for you!
+
+
## Complete Working Demo / Example `Phoenix` App 🚀
If you get stuck
diff --git a/lib/httpoison_mock.ex b/lib/httpoison_mock.ex
index a508ac5..5ebc451 100644
--- a/lib/httpoison_mock.ex
+++ b/lib/httpoison_mock.ex
@@ -38,7 +38,7 @@ defmodule ElixirAuthMicrosoft.HTTPoisonMock do
@doc """
Mocks the `post/3` function from HTTPoison.
- It yields a predictable, with always the same access token.
+ It yields a predictable result, with always the same access token.
"""
@spec post(any, any, any) :: {:ok, %{body: binary}}
def post(_url, _body, _headers) do