From 2c3589cdaca77f2b91463b2b52972ea4f8cb4fbb Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Fri, 4 Jan 2019 16:49:16 -0800
Subject: [PATCH 01/12] added cert to auth section

---
 docs/source/integrating/authentication.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/source/integrating/authentication.md b/docs/source/integrating/authentication.md
index f834f3e53..981ceb156 100644
--- a/docs/source/integrating/authentication.md
+++ b/docs/source/integrating/authentication.md
@@ -61,6 +61,9 @@ The generated JWT must contain the following claims:
 - [`iss`](https://tools.ietf.org/html/rfc7519#section-4.1.1): the issuer for the token must match the value of `TALK_JWT_ISSUER`
 - [`aud`](https://tools.ietf.org/html/rfc7519#section-4.1.3): the audience for the token must match the value of `TALK_JWT_AUDIENCE`
 
+### Generate a key to sign the JWT
+Optionally you can use https://github.com/coralproject/coralcert to generate a key with which to sign the JWTs and specify the secret as an environment variable. 
+
 ### Push token into embed
 
 We're assuming that your CMS is capable of authenticating a user account, or 

From 886222260db0347dd22e4020b64a9458927cef6d Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Fri, 4 Jan 2019 16:55:56 -0800
Subject: [PATCH 02/12] fb requires ssl

---
 plugins/talk-plugin-facebook-auth/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/plugins/talk-plugin-facebook-auth/README.md b/plugins/talk-plugin-facebook-auth/README.md
index 08780adda..839265b04 100644
--- a/plugins/talk-plugin-facebook-auth/README.md
+++ b/plugins/talk-plugin-facebook-auth/README.md
@@ -29,6 +29,8 @@ Configuration:
   guide. This is only required while the `talk-plugin-facebook-auth` plugin is
   enabled.
 
+_NOTE: FabceBook auth requires your site to use `https` (SSL) not `http`. If your site is not `https` you can not use this plugin!_
+
 ## GDPR Compliance
 
 In order to facilitate compliance with the

From 8f633fbe780e6c563c21f9dc8e3a824b38fafdc0 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Fri, 4 Jan 2019 17:20:49 -0800
Subject: [PATCH 03/12] added comment count to checklist

---
 docs/source/01-05-pre-launch-checklist.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/source/01-05-pre-launch-checklist.md b/docs/source/01-05-pre-launch-checklist.md
index 01e42b9bd..f07953eb6 100644
--- a/docs/source/01-05-pre-launch-checklist.md
+++ b/docs/source/01-05-pre-launch-checklist.md
@@ -58,9 +58,10 @@ permalink: /pre-launch-checklist/
   - Install [talk-plugin-rich-text](/talk/plugin/talk-plugin-rich-text)
 
 
-- [ ] Do you want to display comment counts?
-  - Use the GraphQL [CommentCountQuery](https://docs.coralproject.net/talk/api/graphql/#CommentCountQuery)
-  - Install [talk-plugin-deep-reply-count](/talk/plugin/talk-plugin-deep-reply-count) if necessary.
+- [ ] Do you want to display comment counts on your embed stream or on a homepage with dozens of articles?
+  - Install [talk-plugin-comment-count](https://github.com/coralproject/talk-plugin-comment-count) for summary counts on multiple articles
+  - Install [talk-plugin-deep-reply-count](/talk/plugin/talk-plugin-deep-reply-count) to add counts to the embed stream
+  - Or use the GraphQL [CommentCountQuery](https://docs.coralproject.net/talk/api/graphql/#CommentCountQuery)
 
 
 - [ ] Do you want to translate Talk to a different language?

From ba31dbbdf917950fb0f909e81d3237252a85af3d Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 09:53:46 -0800
Subject: [PATCH 04/12] added logout wait time

---
 docs/source/07-02-troubleshooting-tips.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/source/07-02-troubleshooting-tips.md b/docs/source/07-02-troubleshooting-tips.md
index 6d7304a83..0b4a7a682 100644
--- a/docs/source/07-02-troubleshooting-tips.md
+++ b/docs/source/07-02-troubleshooting-tips.md
@@ -38,3 +38,6 @@ If you're using `talk-plugin-auth`:
 * See if you can isolate if it's a particular group of users that are experiencing this issue, e.g. mods, admins, subscribers? Confirm they have the appropriate permissions to comment.
 * Note if this is a new issue that happened after an upgrade - did you read the [migration docs](/talk/migration/3/) and the [release notes](https://github.com/coralproject/talk/releases)? This might help you resolve the issue.
 * If you're still experiencing issues, log a [support ticket](mailto:support@coralproject.net) so we can help diagnose the issue
+
+If a user has been locked out due to too many failed login attempts:
+* How long does the user have to wait before they will be allowed to login? 10 mins
\ No newline at end of file

From db5bf9a676e0f7240b47db8e79fa6eaadf50ae20 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 10:04:39 -0800
Subject: [PATCH 05/12] added twitter faq

---
 docs/source/integrating/authentication.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/source/integrating/authentication.md b/docs/source/integrating/authentication.md
index 981ceb156..05f88449e 100644
--- a/docs/source/integrating/authentication.md
+++ b/docs/source/integrating/authentication.md
@@ -26,6 +26,9 @@ Plugins are available for the following 3rd party authentication providers:
 * [Facebook](/talk/plugin/talk-plugin-facebook-auth/)
 * [Google](/talk/plugin/talk-plugin-google-auth/) 
 
+_FAQ: Can I create a Twitter auth plugin?_ 
+This is currently not possible because Talk uses passport.js which does not support Twitter's oAuth2 requirements.
+
 ## Custom Token Integration 
 
 You can integrate Talk with any authentication service to enable single sign-on

From 83819df922f4fb6690a39d778cdf1002e2a2ae96 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 13:27:08 -0800
Subject: [PATCH 06/12] added talk-plugin-comment-count to plugins directory

---
 docs/source/_data/plugins.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/source/_data/plugins.yml b/docs/source/_data/plugins.yml
index 0e09de210..3c08715fe 100644
--- a/docs/source/_data/plugins.yml
+++ b/docs/source/_data/plugins.yml
@@ -146,3 +146,8 @@
   tags:
     - default
     - sorting
+- name: talk-plugin-comment-count
+  description: This plugin enables adding comment counts to Talk’s embed or in other locations on your site. 
+  link: https://github.com/coralproject/talk-plugin-comment-count
+  tags:
+    - counts

From c98d227411b16c14767d9530176538e14b6c14c9 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 15:12:44 -0800
Subject: [PATCH 07/12] updated notifications page

---
 docs/source/integrating/notifications.md | 86 ++++++++++++++++++------
 1 file changed, 65 insertions(+), 21 deletions(-)

diff --git a/docs/source/integrating/notifications.md b/docs/source/integrating/notifications.md
index a5f625083..7ee9d0834 100644
--- a/docs/source/integrating/notifications.md
+++ b/docs/source/integrating/notifications.md
@@ -3,22 +3,13 @@ title: Notifications
 permalink: /integrating/notifications/
 ---
 
-Talk currently supports 3 types of email notifications.
+There are several plugins included with Talk that once enabled will control how and when Talk sends emails to users based on user activity. Only basic user profile notifications are enabled by default. 
 
-
-1. When someone replies to my comment
-2. When a staff member replies to my comment
-3. When my comment gets featured
-
-Talk support 3 options for notification frequency: immediately, hourly or daily. Commenters can also opt-out of email notifications. Notifications are set to OFF by default.
-
-Commenters cannot enable notifications until they have verified their email.
-
-Note: Notifications are not currently supported for users that sign-up via Facebook or Google auth, or don't have an email attached to their account for any other reason.
+_NOTE: Notifications are only supported for users that have an email address in Talk! If you are using authenticate via Facebook, Google, or SSO and you want to persist the user’s email, you will also need to enable `talk-plugin-local-auth` ([See Authentication](/talk/integrating/authentication/))_
 
 ### Configuring SMTP
 
-You must setup SMTP to use notifications. The following ENV variables must be set:
+You must setup SMTP to send email notifications. The following ENV variables must be set:
 
 ```
 TALK_SMTP_FROM_ADDRESS=email@email.com
@@ -28,28 +19,72 @@ TALK_SMTP_HOST=smtp.domain.net
 TALK_SMTP_PORT=2525
 ```
 
-### Enabling Notifications
+See our documentation on [setting env variables](/talk/advanced-configuration/#talk-smtp-from-address) for reference. 
 
-Enabling the `talk-plugin-notifications` creates a NotificationManager that creates and manages events send from the event emitter that is linked to the Graph API PubSub system.
+When running Talk in production we recommend using a 3rd party mail service provider like SendGrid or MailGun. 
 
-Adding the `talk-plugin-notifications` plugin will also enable the `notifications` plugin hook. Any plugin that registers before the `talk-plugin-notifications` plugin will get picked up by.
+If you are having difficulty with your SMTP settings you can add `DEBUG=talk:jobs:mailer` to your .env to see additional logs from the mailer service.
 
-See https://github.com/coralproject/talk/blob/8b669a31c551a042f0f079d8cfc16825673eb8f0/plugins/talk-plugin-notifications-reply/index.js for an example.
+All notifications require SMTP settings to be correctly configured first, then enable the corresponding plugin, and configure any settings in the Talk Admin. If SMTP is not enabled, it will log to the server console that some variables were not provided.
 
-### Notification Categories
+### Notification Types & Plugins
 
-Talk currently supports the following Notifications options out of the box:
+In addition to the core notifications included with Talk, some plugins add features that are supported by and will add additional types of email notifications. Commenters can opt-out of most email notifications, and comment activity notifications are set to OFF by default. Commenters cannot enable notifications until they have verified their email.
 
-`talk-plugin-notifications-category-reply`
-`talk-plugin-notifications-category-staff-reply`
-`talk-plugin-notifications-category-featured`
+You can see a list of all the plugins related to notifications by visiting:
+https://docs.coralproject.net/talk/plugins-directory/?q=notifications
+
+#### Type: User Profile Notifications (Included by Talk core)
+
+* When user registers, sends email confirmation and verification 
+* When user requests password reset 
+* When user changes username, sends confirmation
+* When a user is banned or suspended
+
+#### Type: GDPR Notifications (optional)
+`talk-plugin-profile-data:`
+* When my comment history is ready for download (only one link can be generated every 7 days, and the link is valid for 24 hours)
+
+`talk-plugin-local-auth:`
+* When user changes their email address
+* When a user adds a new email address 
+
+#### Type: Comment Activity Notifications (optional)
+Talk support 3 options for notification frequency for this type of notification: 
+* immediately
+* hourly 
+* daily
+
+`talk-plugin-notifications:`
+* Enables notifications configuration (required for all comment activity notifications below)
+
+`talk-plugin-notifications-category-reply:`
+* When someone replies to my comment
+
+`talk-plugin-notifications-category-staff-reply:`
+* When a staff member replies to my comment
+
+`talk-plugin-notifications-category-featured:`
+* When my comment gets featured
 
 ### Notification Digests
 
+Notification digests are enabled by enabling the corresponding plugin, otherwise comment activity notifications are sent immediately.
+* `talk-plugin-notifications-digest-daily`
+* `talk-plugin-notifications-digest-hourly`
+
 Talk supports hourly and daily digests out the box, if you would like to create your own, refer to the below:
 
 https://github.com/coralproject/talk/blob/9cc9969320dca47bb0f8f81e8d944ae4d19e548b/plugins/talk-plugin-notifications/server/connect.js#L69-L102
         
+
+### Customizing Notifications
+
+Enabling the `talk-plugin-notifications` creates a NotificationManager that creates and manages events send from the event emitter that is linked to the Graph API PubSub system. This allows the instance that received the mutation to also fire off a notification job that can be handled. It also enabels the `notifications` plugin hook. Any plugin that registers after the `talk-plugin-notifications` can export the notifications plugin to reference it.
+
+See https://github.com/coralproject/talk/blob/8b669a31c551a042f0f079d8cfc16825673eb8f0/plugins/talk-plugin-notifications-reply/index.js for an example.
+
+
 ### Connect API
 
 This exposes the `graph/connectors.js` via the `connect` hook.
@@ -67,3 +102,12 @@ See https://github.com/coralproject/talk/blob/90290cfa2de88e62f687e1ed0235ba6dfe
 ### Email Templates
 
 Email templates are text based and support translations. If you would like to create a new email template, you can register it via the Connect API, see https://github.com/coralproject/talk/blob/8b669a31c551a042f0f079d8cfc16825673eb8f0/plugins/talk-plugin-notifications/server/connect.js#L12-L28### 
+
+Any email template registered with the same name as another template will replace the existing template for that type of email.  _NOTE: that also means that the template data sent to each email template will __not__ change, so bear that in mind when designing templates that you may not have rich access to data._
+
+An example of this is with the `talk-plugin-notifications-category-featured` plugin:
+
+Notification translation is located: https://github.com/coralproject/talk/blob/dd0601a80132d2849c53ef7eaf12ff382f3920b9/plugins/talk-plugin-notifications-category-featured/translations.yml#L13
+
+Where the template content is provided: https://github.com/coralproject/talk/blob/dd0601a80132d2849c53ef7eaf12ff382f3920b9/plugins/talk-plugin-notifications-category-featured/index.js#L79
+

From b0b5807c8b98637cdf277ffa21deec4af930dda8 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 16:39:06 -0800
Subject: [PATCH 08/12] added scaling talk

---
 docs/source/01-04-planning-architecture.md |  35 +++++++++++++++++++++
 docs/source/images/ServerArch.png          | Bin 0 -> 27124 bytes
 2 files changed, 35 insertions(+)
 create mode 100644 docs/source/images/ServerArch.png

diff --git a/docs/source/01-04-planning-architecture.md b/docs/source/01-04-planning-architecture.md
index d11ca4ac2..de1cfe803 100644
--- a/docs/source/01-04-planning-architecture.md
+++ b/docs/source/01-04-planning-architecture.md
@@ -19,3 +19,38 @@ Application servers: c4.xlarge (16 VM nginx + Talk VM machine pairs)
 Mongo nodes: 3x c3.medium (large db cluster, 1 master, 2 read replicas)
 
 If you need help with Talk performance or want custom scaling help or recommendations, let us know by logging a ticket and one of our engineers will get in touch with you: https://support.coralproject.net
+
+## How to Scale Talk Components
+### Scaling the Talk Application
+
+In addition to scaling by adding additional app servers, Talk as a server component can flex to various roles. Depending on the desired configuration the roles can be split up to ensure high availability, and best matching to underlying host resources. 
+
+There are three components to the Talk application that can be served independently or in combination on a single thread: API Server, WebSockets, and Jobs
+
+![ServerArchitectureDiagram](/talk/images/ServerArch.png)
+
+In the diagram we see the difference between a Typical configuration (which just adds additional Talk application instances) vs the Split configuration where different Talk components could be spread across different machine resources to optimize infrastructure utilization. 
+See [Serving the Application](/talk/configuration-cli-tools/#serving-the-application)
+
+### Scaling Redis
+
+Redis serves as a general cache and pub/sub broker. We treat all the data stored in Redis as ephemeral, so using as a cache serves us well for Talk to synchronize expensive query caches. It also serves as our pub/sub broker for use with live updates as propagated through the GraphQL subscription system. For this reason it is not recommended to implement multiple instances of Redis. 
+
+### Scaling MongoDB
+
+MongoDB is treated as our general store for persisted data. Talk supports the most common strategies for scaling MongoDB instances including replicas and/or sharding. Depending on your specific data use cases, refer to MongoDBs documentation for more information about scaling https://www.mongodb.com/mongodb-scale.
+
+### Load Balancer 
+While this subject lives outside the Talk ecosystem, it is critical for application delivery. For websockets to work correctly, a load balancer must be selected that can support long lived connections that are required for websockets to work.
+
+## Running Talk in Production
+
+When you are ready to launch your production instance of Talk update your NODE_ENV environment variable from `development` to `production` mode.
+
+Then launch talk with `yarn start` or with the command `NODE_ENV=production ./bin/cli-serve -j -w`
+
+
+
+
+
+
diff --git a/docs/source/images/ServerArch.png b/docs/source/images/ServerArch.png
new file mode 100644
index 0000000000000000000000000000000000000000..aed5ffccaba6082506f1ba65ff68ff075485d0b0
GIT binary patch
literal 27124
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

literal 0
HcmV?d00001


From 83379b58a7102abd7815707ba492160342ef488b Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Tue, 8 Jan 2019 16:46:49 -0800
Subject: [PATCH 09/12] em that can not be opted out of

---
 docs/source/integrating/notifications.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/source/integrating/notifications.md b/docs/source/integrating/notifications.md
index 7ee9d0834..04fe8f59f 100644
--- a/docs/source/integrating/notifications.md
+++ b/docs/source/integrating/notifications.md
@@ -41,6 +41,8 @@ https://docs.coralproject.net/talk/plugins-directory/?q=notifications
 * When user changes username, sends confirmation
 * When a user is banned or suspended
 
+_NOTE: Users can not opt-out of User Profile Notifications_
+
 #### Type: GDPR Notifications (optional)
 `talk-plugin-profile-data:`
 * When my comment history is ready for download (only one link can be generated every 7 days, and the link is valid for 24 hours)

From 8f54c1d3c3c043b9b8732dc2647e7d6a4126ffd5 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Wed, 9 Jan 2019 12:38:33 -0800
Subject: [PATCH 10/12] fixed md typo

---
 docs/source/plugins/overview.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/source/plugins/overview.md b/docs/source/plugins/overview.md
index 1f734edeb..b4e1f41d5 100644
--- a/docs/source/plugins/overview.md
+++ b/docs/source/plugins/overview.md
@@ -67,9 +67,9 @@ External plugins can be resolved by running:
 This achieves two things:
 
 1. It will traverse into local plugin folders and install their dependencies.
-  _Note that if the plugin is already installed and available in the
+  __Note that if the plugin is already installed and available in the
   node_modules folder, it will not be fetched again unless there is a version
-  mismatch._ This will result in the project `package.json` and `yarn.lock`
+  mismatch.__ This will result in the project `package.json` and `yarn.lock`
   files to be modified, this is normal as this ensures that repeated deployments
   (with the same config) will have the same config, these changes should not be
   committed to source control.

From 76ef0f7d521069aa3b5deab55229a06ce51cd5cd Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Thu, 10 Jan 2019 10:55:20 -0800
Subject: [PATCH 11/12] pulled community link from readme

---
 README.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/README.md b/README.md
index dd04b096f..72207c1f3 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,6 @@ The current recommended release version is v4.5.0. ^4.5 (and all future even-num
 
 - [Talk Product Roadmap](https://www.pivotaltracker.com/n/projects/1863625)
 - [Our Blog](https://blog.coralproject.net/)
-- [Community Forums](https://community.coralproject.net/)
 - [Community Guides for Journalism](https://guides.coralproject.net/)
 - [More About Us](https://coralproject.net/)
 

From f69a9c826d1a1bf04441e6f881b226a34e3fce84 Mon Sep 17 00:00:00 2001
From: immber <jessiekrushing@gmail.com>
Date: Thu, 10 Jan 2019 17:04:22 -0800
Subject: [PATCH 12/12] removed link to community from faq

---
 docs/source/07-01-faq.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/docs/source/07-01-faq.md b/docs/source/07-01-faq.md
index 8f34adbf1..f3bf92396 100644
--- a/docs/source/07-01-faq.md
+++ b/docs/source/07-01-faq.md
@@ -11,8 +11,6 @@ To log a bug or request a feature, submit a Support ticket ([support@coralprojec
 
 You can also request help on Github by [submitting an issue](https://github.com/coralproject/talk/issues). This also increases your chances of having someone from the community respond to help.
 
-And you can also search our [Coral Community](https://community.coralproject.net) to see if your issue has been solved, or to get tips from the community. 
-
 ## How can our dev team contribute to Talk?
 
 We are lucky to work with newsroom dev teams and individual contributors who span the world, and come from newsrooms of all sizes. You can read our [Contribution Guide](https://github.com/coralproject/talk/blob/master/CONTRIBUTING.md) to get started, but feel free to reach out to us via Github too.