From 06d0da9286ec05a060653742e525757a2a30f7fe Mon Sep 17 00:00:00 2001
From: Kim Gardner <kgardnr@gmail.com>
Date: Fri, 13 Oct 2017 15:50:13 +0100
Subject: [PATCH] Reorganize file order and reinstate h2s

---
 docs/_docs/02-01-required-configuration.md    | 12 +--
 docs/_docs/02-02-advanced-configuration.md    | 82 +++++++++----------
 ... => 03-01-product-guide-how-talk-works.md} |  0
 .../03-02-product-guide-commenter-features.md |  4 +
 .../03-03-product-guide-moderator-features.md |  4 +
 ...-trust.md => 03-04-product-guide-trust.md} |  0
 ... => 03-05-product-guide-toxic-comments.md} |  0
 ...-overview.md => 04-01-plugins-overview.md} |  0
 ...lt-plugins.md => 04-02-default-plugins.md} | 36 ++++----
 ...plugins.md => 04-03-additional-plugins.md} | 20 ++---
 ...gin-recipes.md => 04-04-plugin-recipes.md} |  8 +-
 docs/_sass/talk.scss                          |  3 -
 12 files changed, 85 insertions(+), 84 deletions(-)
 rename docs/_docs/{04-01-product-guide-how-talk-works.md => 03-01-product-guide-how-talk-works.md} (100%)
 create mode 100644 docs/_docs/03-02-product-guide-commenter-features.md
 create mode 100644 docs/_docs/03-03-product-guide-moderator-features.md
 rename docs/_docs/{04-02-product-guide-trust.md => 03-04-product-guide-trust.md} (100%)
 rename docs/_docs/{04-03-product-guide-toxic-comments.md => 03-05-product-guide-toxic-comments.md} (100%)
 rename docs/_docs/{03-01-plugins-overview.md => 04-01-plugins-overview.md} (100%)
 rename docs/_docs/{03-02-default-plugins.md => 04-02-default-plugins.md} (92%)
 rename docs/_docs/{03-03-additional-plugins.md => 04-03-additional-plugins.md} (93%)
 rename docs/_docs/{03-04-plugin-recipes.md => 04-04-plugin-recipes.md} (95%)

diff --git a/docs/_docs/02-01-required-configuration.md b/docs/_docs/02-01-required-configuration.md
index 84a7236db..dc09a1707 100644
--- a/docs/_docs/02-01-required-configuration.md
+++ b/docs/_docs/02-01-required-configuration.md
@@ -19,7 +19,7 @@ If you've already configured your application with the required configuration,
 you can further customize it's behavior by applying
 [Advanced Configuration]({{ "/advanced-configuration/" | relative_url }}).
 
-### TALK_MONGO_URL
+## TALK_MONGO_URL
 
 The database connection string for the MongoDB database. This usually takes the
 form of:
@@ -31,7 +31,7 @@ TALK_MONGO_URL=mongodb://<DATABASE USER>:<DATABASE PASSWORD>@<DATABASE HOST>:<DA
 Refer to [connection string uri format](https://docs.mongodb.com/manual/reference/connection-string/){:target="_blank"}
 for the detailed url scheme of the MongoDB url.
 
-### TALK_REDIS_URL
+## TALK_REDIS_URL
 
 The database connection string for the Redis database. This usually takes the
 form of:
@@ -50,7 +50,7 @@ TALK_REDIS_URL=redis://127.0.0.1:6379/2
 Refer to [uri scheme](http://www.iana.org/assignments/uri-schemes/prov/redis){:target="_blank"}
 for the detailed url scheme of the Redis url.
 
-### TALK_ROOT_URL
+## TALK_ROOT_URL
 
 The root url of the installed application externally available in the format:
 
@@ -70,7 +70,7 @@ TALK_ROOT_URL=https://talk.coralproject.net/
 _Note that we omitted the `PORT`, as it was implied by setting the `SCHEME` to
 `https`._
 
-### TALK_JWT_SECRET
+## TALK_JWT_SECRET
 
 Used to specify the application signing secret. You can specify this using a
 simple string, we recommend using a password generator and pasting it's output.
@@ -85,7 +85,7 @@ Be default, we sign our tokens with HMAC using a SHA-256 hash algorithm. If you
 want to change the signing algorithm, or use multiple signing/verifying keys,
 refer to our [Advanced Configuration]({{ "/advanced-configuration/" | relative_url }}) documentation.
 
-### TALK_FACEBOOK_APP_ID
+## TALK_FACEBOOK_APP_ID
 
 The Facebook App ID for your Facebook Login enabled app. You can learn more
 about getting a Facebook App ID at the
@@ -95,7 +95,7 @@ or by visiting the
 guide. This is only required while the `talk-plugin-facebook-auth` plugin is
 enabled.
 
-### TALK_FACEBOOK_APP_SECRET
+## TALK_FACEBOOK_APP_SECRET
 
 The Facebook App Secret for your Facebook Login enabled app. You can learn more
 about getting a Facebook App Secret at the
diff --git a/docs/_docs/02-02-advanced-configuration.md b/docs/_docs/02-02-advanced-configuration.md
index de2ab0e68..7db27fb1c 100644
--- a/docs/_docs/02-02-advanced-configuration.md
+++ b/docs/_docs/02-02-advanced-configuration.md
@@ -19,37 +19,37 @@ If this is your first time configuring Talk, ensure you've also added the
 [Required Configuration]({{ "/configuration/" | relative_url }}) as well,
 otherwise the application will fail to start.
 
-### TALK_CACHE_EXPIRY_COMMENT_COUNT
+## TALK_CACHE_EXPIRY_COMMENT_COUNT
 
 Configure the duration for which comment counts are cached for, parsed by
 [ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `1hr`)
 
-### TALK_DEFAULT_LANG
+## TALK_DEFAULT_LANG
 
 Specify the default translation language. (Default `en`)
 
-### TALK_DEFAULT_STREAM_TAB
+## TALK_DEFAULT_STREAM_TAB
 
 Specify the default stream tab in the admin. (Default `all`)
 
-### TALK_DISABLE_AUTOFLAG_SUSPECT_WORDS
+## TALK_DISABLE_AUTOFLAG_SUSPECT_WORDS
 
 When `TRUE`, disables flagging of comments that match the suspect word filter. (Default `FALSE`)
 
-### TALK_DISABLE_EMBED_POLYFILL
+## TALK_DISABLE_EMBED_POLYFILL
 
 When set to `TRUE`, the build process will not include the
 [babel-polyfill](https://babeljs.io/docs/usage/polyfill/){:target="_blank"}
 in the embed.js target that is loaded on the page that loads the embed. (Default
 `FALSE`)
 
-### TALK_DISABLE_STATIC_SERVER
+## TALK_DISABLE_STATIC_SERVER
 
 When `TRUE`, it will not mount the static asset serving routes on the router.
 This is used primarily in conjunction with [TALK_STATIC_URI](#talk_static_uri){: .param}
 when the static assets are being hosted on an external domain. (Default `FALSE`)
 
-### TALK_HELMET_CONFIGURATION
+## TALK_HELMET_CONFIGURATION
 
 A JSON string representing the configuration passed to the
 [helmet](https://github.com/helmetjs/helmet){:target="_blank"} middleware. It
@@ -68,20 +68,20 @@ TALK_HELMET_CONFIGURATION={"hsts": false}
 
 To disable these headers from being sent.
 
-### TALK_INSTALL_LOCK
+## TALK_INSTALL_LOCK
 
 When `TRUE`, disables the dynamic setup endpoint `/admin/install` from even
 loading. This prevents hits to the database with enabled. This should always be
 set to `TRUE` after you've deployed Talk. (Default `FALSE`)
 
-### TALK_JWT_ALG
+## TALK_JWT_ALG
 
 The algorithm used to sign/verify JWT’s used for session management. Read up
 about alternative algorithms on the
 [jsonwebtoken](https://www.npmjs.com/package/jsonwebtoken#algorithms-supported){:target="_blank"}
 package. (Default `HS256`)
 
-#### Shared Secret
+### Shared Secret
 {:.no_toc}
 
 You would use a shared secret when you have no need to share the tokens with
@@ -102,7 +102,7 @@ These must be provided in the form:
 ```
 {: .no-copy}
 
-#### Asymmetric Secret
+### Asymmetric Secret
 {:.no_toc}
 
 You would use a asymmetric secret when you want to share the token in your
@@ -138,23 +138,23 @@ certificates that match our required format: [coralcert](https://github.com/cora
 This tool can generate RSA and ECDSA certificates, check it's [README](https://github.com/coralproject/coralcert){:target="_blank"}
 for more details.
 
-### TALK_JWT_AUDIENCE
+## TALK_JWT_AUDIENCE
 
 The audience [aud](https://tools.ietf.org/html/rfc7519#section-4.1.3){:target="_blank"}
 claim for login JWT tokens. (Default `talk`)
 
-### TALK_JWT_CLEAR_COOKIE_LOGOUT
+## TALK_JWT_CLEAR_COOKIE_LOGOUT
 
 When `FALSE`, Talk will not clear the cookie with name
 [TALK_JWT_SIGNING_COOKIE_NAME](#talk_jwt_signing_cookie_name){: .param} when logging out
 but will still blacklist the token. (Default `TRUE`)
 
-### TALK_JWT_COOKIE_NAME
+## TALK_JWT_COOKIE_NAME
 
 The default cookie name to check for a valid JWT token to use for verifying a
 user. (Default `authorization`)
 
-### TALK_JWT_COOKIE_NAMES
+## TALK_JWT_COOKIE_NAMES
 
 The different cookie names to check for a JWT token in, separated by a `,`. By
 default, we always use the value of [TALK_JWT_COOKIE_NAME](#talk_jwt_cookie_name){: .param}
@@ -176,19 +176,19 @@ Would mean we would check the following cookies (in order) for a valid token:
 2. `coralproject.talk`
 3. `coralproject.auth`
 
-### TALK_JWT_DISABLE_AUDIENCE
+## TALK_JWT_DISABLE_AUDIENCE
 
 When `TRUE`, Talk will not verify or sign JWT’s with an audience
 [aud](https://tools.ietf.org/html/rfc7519#section-4.1.3){:target="_blank"}
 claim, even if [TALK_JWT_AUDIENCE](#talk_jwt_audience){: .param} is set. (Default `FALSE`)
 
-### TALK_JWT_DISABLE_ISSUER
+## TALK_JWT_DISABLE_ISSUER
 
 When `TRUE`, Talk will not verify or sign JWT’s with an issuer
 [iss](https://tools.ietf.org/html/rfc7519#section-4.1.1){:target="_blank"}
 claim, even if [TALK_JWT_ISSUER](#talk_jwt_issuer){: .param} is set. (Default `FALSE`)
 
-### TALK_JWT_EXPIRY
+## TALK_JWT_EXPIRY
 
 The expiry duration [exp](https://tools.ietf.org/html/rfc7519#section-4.1.4){:target="_blank"}
 for the tokens issued for logged in sessions, parsed by
@@ -199,12 +199,12 @@ If the user logs out, then an entry is created in the token blacklist of it's
 set to be automatically removed at it's expiry time. It is important for this
 reason to create reasonable expiry lengths as to minimize the storage overhead.
 
-### TALK_JWT_ISSUER
+## TALK_JWT_ISSUER
 
 The issuer [iss](https://tools.ietf.org/html/rfc7519#section-4.1.1){:target="_blank"}
 claim for login JWT tokens. (Defaults to value of [TALK_ROOT_URL]({{ "/configuration/#talk_root_url" | relative_url }}){: .param})
 
-### TALK_JWT_SECRET
+## TALK_JWT_SECRET
 
 Used to specify the application signing secret. You can specify this using a
 simple string, we recommend using a password generator and pasting it's output.
@@ -225,7 +225,7 @@ Refer to the documentation for [TALK_JWT_ALG](#talk_jwt_alg){: .param} for other
 methods and other forms of the `TALK_JWT_SECRET`. If you are interested in using
 multiple keys, then refer to [TALK_JWT_SECRETS](#talk_jwt_secrets){: .param}.
 
-### TALK_JWT_SECRETS
+## TALK_JWT_SECRETS
 
 Used when specifying multiple secrets used for key rotations. This is a JSON
 encoded array, where each element matches the JWT Secret pattern. When this is
@@ -261,12 +261,12 @@ Refer to the documentation on the [TALK_JWT_ALG](#talk_jwt_alg){: .param} for mo
 information on what to store in these parameters.
 {: .code-aside}
 
-### TALK_JWT_SIGNING_COOKIE_NAME
+## TALK_JWT_SIGNING_COOKIE_NAME
 
 The default cookie name that is use to set a cookie containing a JWT that was
 issued by Talk. (Defaults to value of [TALK_JWT_COOKIE_NAME](#talk_jwt_cookie_name){: .param})
 
-### TALK_JWT_USER_ID_CLAIM
+## TALK_JWT_USER_ID_CLAIM
 
 Specify the claim using dot notation for where the user id should be stored/read
 to/from. (Default `sub`)
@@ -287,13 +287,13 @@ Then we would set `TALK_JWT_USER_ID_CLAIM` to:
 TALK_JWT_USER_ID_CLAIM=user.id
 ```
 
-### TALK_KEEP_ALIVE
+## TALK_KEEP_ALIVE
 
 The keepalive timeout that should be used to send keep alive messages through
 the websocket to keep the socket alive, parsed by
 [ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `30s`)
 
-### TALK_RECAPTCHA_PUBLIC
+## TALK_RECAPTCHA_PUBLIC
 
 Client secret used for enabling reCAPTCHA powered logins. If
 [TALK_RECAPTCHA_SECRET](#talk_recaptcha_secret){: .param} and
@@ -302,7 +302,7 @@ default to providing only a time based lockout. Refer to
 [reCAPTCHA](https://www.google.com/recaptcha/intro/index.html) for information
 on getting an account setup.
 
-### TALK_RECAPTCHA_SECRET
+## TALK_RECAPTCHA_SECRET
 
 Server secret used for enabling reCAPTCHA powered logins. If
 [TALK_RECAPTCHA_SECRET](#talk_recaptcha_secret){: .param} and
@@ -311,7 +311,7 @@ default to providing only a time based lockout. Refer to
 [reCAPTCHA](https://www.google.com/recaptcha/intro/index.html) for information
 on getting an account setup.
 
-### TALK_REDIS_CLIENT_CONFIG
+## TALK_REDIS_CLIENT_CONFIG
 
 Configuration overrides for the redis client configuration in a JSON encoded
 string. Configuration is overridden as the second parameter to the redis client
@@ -319,30 +319,30 @@ constructor, and is merged with default configuration. Refer to the
 [ioredis](https://github.com/luin/ioredis){:target="_blank"} docs on the
 available options. (Default `{}`)
 
-### TALK_REDIS_CLUSTER_CONFIGURATION
+## TALK_REDIS_CLUSTER_CONFIGURATION
 
 The JSON encoded form of the cluster nodes. Only required when
 [TALK_REDIS_CLUSTER_MODE](#talk_redis_cluster_mode){: .param} is `CLUSTER`. See
 [https://github.com/luin/ioredis#cluster](https://github.com/luin/ioredis#cluster){:target="_blank"}
 for configuration details. (Default `[]`)
 
-### TALK_REDIS_CLUSTER_MODE
+## TALK_REDIS_CLUSTER_MODE
 
 The cluster mode of the redis client. Can be either `NONE` or `CLUSTER`.
 (Default `NONE`)
 
-### TALK_REDIS_RECONNECTION_BACKOFF_FACTOR
+## TALK_REDIS_RECONNECTION_BACKOFF_FACTOR
 
 The time factor that will be multiplied against the current attempt count
 between attempts to connect to redis, parsed by
 [ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `500 ms`)
 
-### TALK_REDIS_RECONNECTION_BACKOFF_MINIMUM_TIME
+## TALK_REDIS_RECONNECTION_BACKOFF_MINIMUM_TIME
 
 The minimum time used to delay before attempting to reconnect to redis, parsed
 by [ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `1 sec`)
 
-### TALK_ROOT_URL_MOUNT_PATH
+## TALK_ROOT_URL_MOUNT_PATH
 
 When set to `TRUE`, the routes will be mounted onto the `<PATHNAME>` component
 of the [TALK_ROOT_URL]({{ "/configuration/#talk_root_url" | relative_url }}){: .param}.
@@ -361,7 +361,7 @@ Then all the routes for the API will be expecting to be hit on `/talk/`, such as
 can perform the path stripping when serving an upstream proxy, but some CDN's
 cannot. You would use this option in the latter situation.
 
-### TALK_SMTP_EMAIL
+## TALK_SMTP_EMAIL
 
 The email address to send emails from using the SMTP provider in the format:
 
@@ -371,23 +371,23 @@ TALK_SMTP_EMAIL="The Coral Project" <support@coralproject.net>
 
 Including the name and email address.
 
-### TALK_SMTP_HOST
+## TALK_SMTP_HOST
 
 The domain for the SMTP provider that you are using.
 
-### TALK_SMTP_PASSWORD
+## TALK_SMTP_PASSWORD
 
 The password for the SMTP provider you are using.
 
-### TALK_SMTP_PORT
+## TALK_SMTP_PORT
 
 The port for the SMTP provider that you are using.
 
-### TALK_SMTP_USERNAME
+## TALK_SMTP_USERNAME
 
 The username of the SMTP provider you are using.
 
-### TALK_STATIC_URI
+## TALK_STATIC_URI
 
 Used to set the uri where the static assets should be served from. This is used
 when you want to upload the static assets through your build process to a
@@ -395,14 +395,14 @@ service like Google Cloud Storage or Amazon S3 and you would then specify the
 CDN/Storage url. (Defaults to value of
 [TALK_ROOT_URL]({{ "/configuration/#talk_root_url" | relative_url }}){: .param})
 
-### TALK_THREADING_LEVEL
+## TALK_THREADING_LEVEL
 
 Specify the maximum depth of the comment thread. (Default `3`)
 
 **Note that a high value for `TALK_THREADING_LEVEL` will result in large
 performance impacts.**
 
-### TALK_WEBSOCKET_LIVE_URI
+## TALK_WEBSOCKET_LIVE_URI
 
 Used to override the location to connect to the websocket endpoint to
 potentially another host. This should be used when you need to route websocket
@@ -419,7 +419,7 @@ is `FALSE`, or the path component of
 **Warning: if used without managing the auth state manually, auth
 cannot be persisted due to browser restrictions.**
 
-### TRUST_THRESHOLDS
+## TRUST_THRESHOLDS
 
 Configure the reliability thresholds for flagging and commenting. (Default
 `comment:2,-1;flag:2,-1`)
diff --git a/docs/_docs/04-01-product-guide-how-talk-works.md b/docs/_docs/03-01-product-guide-how-talk-works.md
similarity index 100%
rename from docs/_docs/04-01-product-guide-how-talk-works.md
rename to docs/_docs/03-01-product-guide-how-talk-works.md
diff --git a/docs/_docs/03-02-product-guide-commenter-features.md b/docs/_docs/03-02-product-guide-commenter-features.md
new file mode 100644
index 000000000..8fde0f0ac
--- /dev/null
+++ b/docs/_docs/03-02-product-guide-commenter-features.md
@@ -0,0 +1,4 @@
+---
+title: Commenter Features
+permalink: /commenter-features/
+---
diff --git a/docs/_docs/03-03-product-guide-moderator-features.md b/docs/_docs/03-03-product-guide-moderator-features.md
new file mode 100644
index 000000000..355c40a1c
--- /dev/null
+++ b/docs/_docs/03-03-product-guide-moderator-features.md
@@ -0,0 +1,4 @@
+---
+title: Moderator Features
+permalink: /moderator-features/
+---
diff --git a/docs/_docs/04-02-product-guide-trust.md b/docs/_docs/03-04-product-guide-trust.md
similarity index 100%
rename from docs/_docs/04-02-product-guide-trust.md
rename to docs/_docs/03-04-product-guide-trust.md
diff --git a/docs/_docs/04-03-product-guide-toxic-comments.md b/docs/_docs/03-05-product-guide-toxic-comments.md
similarity index 100%
rename from docs/_docs/04-03-product-guide-toxic-comments.md
rename to docs/_docs/03-05-product-guide-toxic-comments.md
diff --git a/docs/_docs/03-01-plugins-overview.md b/docs/_docs/04-01-plugins-overview.md
similarity index 100%
rename from docs/_docs/03-01-plugins-overview.md
rename to docs/_docs/04-01-plugins-overview.md
diff --git a/docs/_docs/03-02-default-plugins.md b/docs/_docs/04-02-default-plugins.md
similarity index 92%
rename from docs/_docs/03-02-default-plugins.md
rename to docs/_docs/04-02-default-plugins.md
index ab843f21b..aff17ebcc 100644
--- a/docs/_docs/03-02-default-plugins.md
+++ b/docs/_docs/04-02-default-plugins.md
@@ -16,7 +16,7 @@ Talk that are not enabled by default. You can enable these or disable these
 default plugins by consulting the [Plugins Overview]({{ "/plugins/" | relative_url }})
 page.
 
-### talk-plugin-auth
+## talk-plugin-auth
 
 Source: [plugins/talk-plugin-auth](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-auth){:target="_blank"}
 
@@ -24,7 +24,7 @@ Enables generic registration via an email address, a username, a password, and a
 password confirmation. To sync Talk auth with your own auth systems, you can use
 this plugin as a template.
 
-### talk-plugin-facebook-auth
+## talk-plugin-facebook-auth
 
 Source: [plugins/talk-plugin-auth](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-auth){:target="_blank"}
 
@@ -34,12 +34,10 @@ Enables sign-in via Facebook via the server side passport middleware.
 
 Configuration:
 
-{:.no_toc}
-
 - [TALK_FACEBOOK_APP_ID]({{ "/configuration/#talk_facebook_app_id" | relative_url }}){:.param} (**required**) - See the existing documentation for the [TALK_FACEBOOK_APP_ID]({{ "/configuration/#talk_facebook_app_id" | relative_url }}){:.param}.
 - [TALK_FACEBOOK_APP_SECRET]({{ "/configuration/#talk_facebook_app_secret" | relative_url }}){:.param} (**required**) - See the existing documentation for the [TALK_FACEBOOK_APP_SECRET]({{ "/configuration/#talk_facebook_app_secret" | relative_url }}){:.param}.
 
-### talk-plugin-featured-comments
+## talk-plugin-featured-comments
 
 Source: [plugins/talk-plugin-featured-comments](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-featured-comments){:target="_blank"}
 
@@ -47,14 +45,14 @@ Enables the ability for Moderators to feature and un-feature comments via the
 Stream and the Admin. Featured comments show in a first-place tab on the Stream
 if there are any featured comments on that story.
 
-### talk-plugin-respect
+## talk-plugin-respect
 
 Source: [plugins/talk-plugin-respect](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-respect){:target="_blank"}
 
 Enables a `respect` reaction button. Why a "respect" button, you ask?
 [Read more here](https://mediaengagement.org/research/engagement-buttons/).
 
-### talk-plugin-comment-content
+## talk-plugin-comment-content
 
 Source: [plugins/talk-plugin-comment-content](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-comment-content){:target="_blank"}
 
@@ -62,7 +60,7 @@ Pluginizes the text of a comment to support custom treatment of this text. This
 plugin currently parses the given text to see if it contains a link, and makes
 them clickable.
 
-### talk-plugin-ignore-user
+## talk-plugin-ignore-user
 
 Source: [plugins/talk-plugin-ignore-user](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-ignore-user){:target="_blank"}
 
@@ -70,20 +68,20 @@ Enables ability for users to ignore (or "mute") other users. If a user is
 ignored, you will not see any of their comments. You can un-ignore a user via
 the My Profile tab.
 
-### talk-plugin-permalink
+## talk-plugin-permalink
 
 Source: [plugins/talk-plugin-permalink](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-permalink){:target="_blank"}
 
 Enables a `Link` button that will provide a permalink to the comment that can be
 shared with others.
 
-### talk-plugin-viewing-options
+## talk-plugin-viewing-options
 
 Source: [plugins/talk-plugin-viewing-options](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-viewing-options){:target="_blank"}
 
 Pluginizes the sorting/viewing options for a comment stream.
 
-### talk-plugin-sort-newest
+## talk-plugin-sort-newest
 
 Source: [plugins/talk-plugin-sort-newest](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-newest){:target="_blank"}
 
@@ -92,7 +90,7 @@ Requires: [talk-plugin-viewing-options](#talk-plugin-viewing-options){:.param}
 Provides a sort for the newest comments first. This isn't necessarily required
 as the default sort without options/plugins is newest first.
 
-### talk-plugin-sort-oldest
+## talk-plugin-sort-oldest
 
 Source: [plugins/talk-plugin-sort-oldest](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-oldest){:target="_blank"}
 
@@ -100,7 +98,7 @@ Requires: [talk-plugin-viewing-options](#talk-plugin-viewing-options){:.param}
 
 Provides a sort for the newest comments first.
 
-### talk-plugin-most-respected
+## talk-plugin-most-respected
 
 Source: [plugins/talk-plugin-most-respected](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-most-respected){:target="_blank"}
 
@@ -108,7 +106,7 @@ Requires: [talk-plugin-viewing-options](#talk-plugin-viewing-options){:.param},
 
 Provides a sort for the comments with the most `respect` reactions first.
 
-### talk-plugin-most-replied
+## talk-plugin-most-replied
 
 Source: [plugins/talk-plugin-most-replied](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-most-replied){:target="_blank"}
 
@@ -116,20 +114,20 @@ Requires: [talk-plugin-viewing-options](#talk-plugin-viewing-options){:.param}
 
 Provides a sort for the comments with the most replies first.
 
-### talk-plugin-offtopic
+## talk-plugin-offtopic
 
 Source: [plugins/talk-plugin-offtopic](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-offtopic){:target="_blank"}
 
 Allows the comment authors to tag their comment as `Off-Topic` which will add a
 visible badge on the frontend to other users that their comment is off-topic.
 
-### talk-plugin-author-menu
+## talk-plugin-author-menu
 
 Source: [plugins/talk-plugin-author-menu](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-author-menu){:target="_blank"}
 
 Pluginizes the author's name on hover.
 
-### talk-plugin-member-since
+## talk-plugin-member-since
 
 Source: [plugins/talk-plugin-member-since](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-member-since){:target="_blank"}
 
@@ -137,14 +135,14 @@ Requires: [talk-plugin-author-menu](#talk-plugin-author-menu){:.param}
 
 Displays the date that the user was created as a `Member Since ${created_at}`.
 
-### talk-plugin-moderation-actions
+## talk-plugin-moderation-actions
 
 Source: [plugins/talk-plugin-moderation-actions](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-moderation-actions){:target="_blank"}
 
 Enables in-stream moderation so that Moderators can reject, approve comments,
 as well as ban users, directly from the comment stream. When [talk-plugin-featured-comments](#talk-plugin-featured-comments){:.param} is enabled
 
-### talk-plugin-flag-details
+## talk-plugin-flag-details
 
 Source: [plugins/talk-plugin-flag-details](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-flag-details){:target="_blank"}
 
diff --git a/docs/_docs/03-03-additional-plugins.md b/docs/_docs/04-03-additional-plugins.md
similarity index 93%
rename from docs/_docs/03-03-additional-plugins.md
rename to docs/_docs/04-03-additional-plugins.md
index 9be7f1cd2..55ab1749b 100644
--- a/docs/_docs/03-03-additional-plugins.md
+++ b/docs/_docs/04-03-additional-plugins.md
@@ -11,13 +11,13 @@ Talk ships with several plugins that aren't enabled by default:
 These plugins can be enabled by consulting the
 [Plugins Overview]({{ "/plugins/" | relative_url }}) page.
 
-### talk-plugin-like
+## talk-plugin-like
 
 Source: [plugins/talk-plugin-like](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-like){:target="_blank"}
 
 Enables a `like` reaction button.
 
-### talk-plugin-sort-most-liked
+## talk-plugin-sort-most-liked
 
 Source: [plugins/talk-plugin-sort-most-liked](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-most-liked){:target="_blank"}
 
@@ -25,13 +25,13 @@ Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewin
 
 Provides a sort for the comments with the most `like` reactions first.
 
-### talk-plugin-love
+## talk-plugin-love
 
 Source: [plugins/talk-plugin-love](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-love){:target="_blank"}
 
 Enables a `love` reaction button.
 
-### talk-plugin-sort-most-loved
+## talk-plugin-sort-most-loved
 
 Source: [plugins/talk-plugin-sort-most-loved](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-sort-most-loved){:target="_blank"}
 
@@ -39,7 +39,7 @@ Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewin
 
 Provides a sort for the comments with the most `love` reactions first.
 
-### talk-plugin-remember-sort
+## talk-plugin-remember-sort
 
 Source: [plugins/talk-plugin-remember-sort](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-remember-sort){:target="_blank"}
 
@@ -47,7 +47,7 @@ Requires: [talk-plugin-viewing-options]({{ "/default-plugins/#talk-plugin-viewin
 
 Enables saving a user’s last sort selection as they browse other articles.
 
-### talk-plugin-deep-reply-count
+## talk-plugin-deep-reply-count
 
 Source: [plugins/talk-plugin-deep-reply-count](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-deep-reply-count){:target="_blank"}
 
@@ -55,7 +55,7 @@ Enables counting of comments to include replies via a new graph edge. Not
 recommended for large installations as it will unreasonably reduce the query
 efficiency to compute this number.
 
-### talk-plugin-slack-notifications
+## talk-plugin-slack-notifications
 
 Source: [plugins/talk-plugin-slack-notifications](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-slack-notifications){:target="_blank"}
 
@@ -70,12 +70,11 @@ Slack, if this isn't what you want, be sure to use the provided plugin as a
 recipe to further customize the behavior*.
 
 Configuration:
-{:.no_toc}
 
 - `SLACK_WEBHOOK_URL` (**required**) - The webhook url that will be
   used to post new comments to.
 
-### talk-plugin-toxic-comments
+## talk-plugin-toxic-comments
 
 Source: [plugins/talk-plugin-toxic-comments](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-toxic-comments){:target="_blank"}
 
@@ -85,7 +84,6 @@ threshold. For more information on what Toxic Comments are, check out the
 [Toxic Comments]({{ "/toxic-comments/" | relative_url }}) documentation.
 
 Configuration:
-{:.no_toc}
 
 - `TALK_PERSPECTIVE_API_KEY` (**required**) - The API Key for Perspective. You
   can register and get your own key at [http://perspectiveapi.com/](http://perspectiveapi.com/){:target="_blank"}.
@@ -97,7 +95,7 @@ Configuration:
   be processed before it will skip the toxicity analysis, parsed by
   [ms](https://www.npmjs.com/package/ms){:target="_blank"}. (Default `300ms`)
 
-### talk-plugin-subscriber
+## talk-plugin-subscriber
 
 Source: [plugins/talk-plugin-subscriber](https://github.com/coralproject/talk/tree/master/plugins/talk-plugin-subscriber){:target="_blank"}
 
diff --git a/docs/_docs/03-04-plugin-recipes.md b/docs/_docs/04-04-plugin-recipes.md
similarity index 95%
rename from docs/_docs/03-04-plugin-recipes.md
rename to docs/_docs/04-04-plugin-recipes.md
index 6b76a54ca..019ff21e4 100644
--- a/docs/_docs/03-04-plugin-recipes.md
+++ b/docs/_docs/04-04-plugin-recipes.md
@@ -16,7 +16,7 @@ The following are the available recipes for use:
 
 {% include toc.html %}
 
-### recipe-avatar
+## recipe-avatar
 
 Source: [talk-recipes/tree/master/plugins/avatar](https://github.com/coralproject/talk-recipes/tree/master/plugins/avatar){:target="_blank"}
 
@@ -24,7 +24,7 @@ Provides support for avatars hosted via third party, extends the User Model and
 provides UI on the client-side too.
 
 
-### recipe-translations
+## recipe-translations
 
 Source: [talk-recipes/tree/master/plugins/translations](https://github.com/coralproject/talk-recipes/tree/master/plugins/translations){:target="_blank"}
 
@@ -32,7 +32,7 @@ Provides an example for overriding application text through the translation
 system.
 
 
-### recipe-subscriber
+## recipe-subscriber
 
 Source: [talk-recipes/tree/master/plugins/subscriber](https://github.com/coralproject/talk-recipes/tree/master/plugins/subscriber){:target="_blank"}
 
@@ -41,7 +41,7 @@ Provides an example for adding `SUBSCRIBER` badges for users with the
 the auth system.
 
 
-### recipe-author-name
+## recipe-author-name
 
 Source: [talk-recipes/tree/master/plugins/author-name](https://github.com/coralproject/talk-recipes/tree/master/plugins/author-name){:target="_blank"}
 
diff --git a/docs/_sass/talk.scss b/docs/_sass/talk.scss
index 85e5f1c93..69e039951 100644
--- a/docs/_sass/talk.scss
+++ b/docs/_sass/talk.scss
@@ -41,9 +41,6 @@ h2, h3, h4 {
 }
 
 article.configuration {
-  h2 {
-    font-weight: bolder;
-  }
 
   h2, .toc {
     @extend .param;