Start using TOC extension to create TOC for README

.gitignore

@@ -5,7 +5,9 @@ node_modules
 .coveralls.yml
 *.log
 .env
-.vscode
+.vscode/*
+!.vscode/settings.json
+!.vscode/extensions.json
 jsdocs/
 jsdoc/
 

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "yzhang.markdown-all-in-one"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "markdown.extension.toc.levels": "2..6"
+}

README.md

@@ -4,12 +4,45 @@ Node.js API Client for the [Okta Platform API].
 
 Requires Node.js version 4.8.3 or higher.
 
-## :warning: :construction: Alpha Preview :construction: :warning:
+# :warning: :construction: Alpha Preview :construction: :warning:
 
 This library is under development and is currently a 0.x version series.  Breaking changes will be introduced as minor version bumps in the 0.x range.  Some of the API is not yet expressed in this library, please refer to the JsDoc for a complete list of classes and methods: [Okta NodeJS Management SDK JSDoc Site].
 
 Need help? Contact [[email protected]](mailto:[email protected]) or use the [Okta Developer Forum].
 
+# Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Examples](#examples)
+  - [Users](#users)
+    - [Create a User](#create-a-user)
+    - [Get a User](#get-a-user)
+    - [Update a User](#update-a-user)
+    - [Delete a User](#delete-a-user)
+    - [List All Org Users](#list-all-org-users)
+    - [Search for Users](#search-for-users)
+  - [Groups](#groups)
+    - [Create a Group](#create-a-group)
+    - [Assign a User to a Group](#assign-a-user-to-a-group)
+  - [Applications](#applications)
+    - [Create An Application](#create-an-application)
+    - [Assign a User to an Application](#assign-a-user-to-an-application)
+    - [Assign a Group to an Application](#assign-a-group-to-an-application)
+  - [Sessions](#sessions)
+    - [Create a Session](#create-a-session)
+    - [Get a Session](#get-a-session)
+    - [Refresh a Session](#refresh-a-session)
+    - [End a Session](#end-a-session)
+    - [End all Sessions for a User](#end-all-sessions-for-a-user)
+- [Collections](#collections)
+  - [`each()`](#each)
+    - [Serial or Parallel Synchronous Work](#serial-or-parallel-synchronous-work)
+    - [Serial Asynchronous Work](#serial-asynchronous-work)
+    - [Ending Iteration](#ending-iteration)
+- [Configuration](#configuration)
+- [Contributing](#contributing)
+
 ## Installation
 
 ```sh
@@ -39,24 +72,6 @@ https://developer.okta.com/okta-sdk-nodejs/jsdocs/Client.html
 
 This library is a wrapper for the [Okta Platform API], which should be referred to as the source-of-truth for what is and isn't possible with the API.  In the following sections we show you how to use your client to perform some common operations with the [Okta Platform API].
 
-* [Users](#users)
-  * [Create a User](#create-a-user)
-  * [Get a User](#get-a-user)
-  * [Update a User](#update-a-user)
-  * [Delete a User](#delete-a-user)
-  * [List All Org Users](#list-all-org-users)
-  * [Search for Users](#search-for-users)
-* [Groups](#groups)
-  * [Create a Group](#create-a-group)
-  * [Assign a User to a Group](#assign-a-user-to-a-group)
-* [Applications](#applications)
-  * [Create an Application](#create-an-application)
-  * [Assign a User to an Application](#assign-a-user-to-an-application)
-  * [Assign a Group to an Application](#assign-a-group-to-an-application)
-* [Collections](#collections)
-  * [each](#each)
-* [Configuration](#configuration)
-
 ### Users
 
 #### Create a User
@@ -160,7 +175,7 @@ client.listUsers({
 });
 ```
 
-## Groups
+### Groups
 
 #### Create a Group
 
@@ -246,7 +261,7 @@ This is a rarely used method. See [Sessions: Create Session with Session Token]
 
 ```javascript
 client.createSession({
-  sessionToken: 'your session token' 
+  sessionToken: 'your session token'
 })
 .then(session => {
   console.log('Session details:' session);
@@ -397,7 +412,7 @@ OKTA_CLIENT_ORGURL=https://dev-1234.oktapreview.com/
 OKTA_CLIENT_TOKEN=xYzabc
 ```
 
-### Contributing
+## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) if you would like to propose changes to this library.
 
@@ -419,4 +434,4 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) if you would like to propose changes to t
 [Users: Lifecycle Operations]: https://developer.okta.com/docs/api/resources/users.html#lifecycle-operations
 [Users: List Users]: https://developer.okta.com/docs/api/resources/users.html#list-users
 [Users: Update User]: https://developer.okta.com/docs/api/resources/users.html#update-user
-[Okta NodeJS Management SDK JSDoc Site]: https://developer.okta.com/okta-sdk-nodejs/jsdocs/
+[Okta NodeJS Management SDK JSDoc Site]: https://developer.okta.com/okta-sdk-nodejs/jsdocs/