Update/architecture legacy node (#969)

* condensed all integrations into one page. Updated links * fixed broken link * update snapshot * updated redirects

Author: MimiDumpling

__tests__/__snapshots__/documentation.js.snap

@@ -193,12 +193,7 @@ Array [
   "clients/node/coffeescript/index.html",
   "clients/node/config/index.html",
   "clients/node/index.html",
-  "clients/node/integrations/connect/index.html",
-  "clients/node/integrations/express/index.html",
   "clients/node/integrations/index.html",
-  "clients/node/integrations/koa/index.html",
-  "clients/node/integrations/loopback/index.html",
-  "clients/node/integrations/sails/index.html",
   "clients/node/sourcemaps/index.html",
   "clients/node/typescript/index.html",
   "clients/node/usage/index.html",

nginx.conf

@@ -250,6 +250,26 @@ server {
   location = /clients/ruby/integrations/rails/ {
     return 302 /clients/ruby/integrations/;
   }
+  
+  location = /clients/node/integrations/connect/ {
+    return 302 /clients/node/integrations/;
+  }
+  
+  location = /clients/node/integrations/express/ {
+    return 302 /clients/node/integrations/;
+  }
+  
+  location = /clients/node/integrations/koa/ {
+    return 302 /clients/node/integrations/;
+  }
+  
+  location = /clients/node/integrations/loopback/ {
+    return 302 /clients/node/integrations/;
+  }
+  
+  location = /clients/node/integrations/sails/ {
+    return 302 /clients/node/integrations/;
+  }
 
   location / {
     try_files $uri $uri.html $uri/ $uri/index.html =404;

src/collections/_documentation/clients/node/index.md

@@ -114,20 +114,20 @@ Raven and Sentry support [Source Maps](http://www.html5rocks.com/en/tutorials/de
 
 ## Middleware and Integrations
 
-If you’re using Node.js with a web server framework/library like Connect, Express, or Koa, it is recommended to configure one of Raven’s server middleware integrations. See [_Integrations_]({%- link _documentation/clients/node/integrations/index.md -%}).
+If you’re using Node.js with a web server framework/library like Connect, Express, or Koa, it is recommended to configure one of Raven’s server middleware integrations. See [_Integrations_]({%- link _documentation/clients/node/integrations.md -%}).
 
 ## Deep Dive
 
 For more detailed information about how to get most out of Raven there is additional documentation available that covers all the rest:
 
 -   [Configuration]({%- link _documentation/clients/node/config.md -%})
 -   [Usage]({%- link _documentation/clients/node/usage.md -%})
--   [Integrations]({%- link _documentation/clients/node/integrations/index.md -%})
-    -   [Connect]({%- link _documentation/clients/node/integrations/connect.md -%})
-    -   [Express]({%- link _documentation/clients/node/integrations/express.md -%})
-    -   [Koa]({%- link _documentation/clients/node/integrations/koa.md -%})
-    -   [Loopback]({%- link _documentation/clients/node/integrations/loopback.md -%})
-    -   [Sails]({%- link _documentation/clients/node/integrations/sails.md -%})
+-   [Integrations]({%- link _documentation/clients/node/integrations.md -%})
+    -   [Connect]({%- link _documentation/clients/node/integrations.md -%}#connect)
+    -   [Express]({%- link _documentation/clients/node/integrations.md -%}#express)
+    -   [Koa]({%- link _documentation/clients/node/integrations.md -%}#koa)
+    -   [Loopback]({%- link _documentation/clients/node/integrations.md -%}#loopback)
+    -   [Sails]({%- link _documentation/clients/node/integrations.md -%}#sails)
 -   [Source Maps]({%- link _documentation/clients/node/sourcemaps.md -%})
 -   [Source Maps]({%- link _documentation/clients/node/typescript.md -%})
 -   [CoffeeScript]({%- link _documentation/clients/node/coffeescript.md -%})

src/collections/_documentation/clients/node/integrations.md

@@ -0,0 +1,148 @@
+---
+title: Integrations
+---
+
+## Connect
+
+<!-- WIZARD -->
+```javascript
+var connect = require('connect');
+var Raven = require('raven');
+
+// Must configure Raven before doing anything else with it
+Raven.config('___PUBLIC_DSN___').install();
+
+function mainHandler(req, res) {
+    throw new Error('Broke!');
+}
+
+function onError(err, req, res, next) {
+    // The error id is attached to `res.sentry` to be returned
+    // and optionally displayed to the user for support.
+    res.statusCode = 500;
+    res.end(res.sentry + '\n');
+}
+
+connect(
+    // The request handler be the first item
+    Raven.requestHandler(),
+
+    connect.bodyParser(),
+    connect.cookieParser(),
+    mainHandler,
+
+    // The error handler must be before any other error middleware
+    Raven.errorHandler(),
+
+    // Optional fallthrough error handler
+    onError,
+).listen(3000);
+```
+<!-- ENDWIZARD -->
+
+## Express
+
+<!-- WIZARD -->
+```javascript
+var app = require('express')();
+var Raven = require('raven');
+
+// Must configure Raven before doing anything else with it
+Raven.config('__DSN__').install();
+
+// The request handler must be the first middleware on the app
+app.use(Raven.requestHandler());
+
+app.get('/', function mainHandler(req, res) {
+    throw new Error('Broke!');
+});
+
+// The error handler must be before any other error middleware
+app.use(Raven.errorHandler());
+
+// Optional fallthrough error handler
+app.use(function onError(err, req, res, next) {
+    // The error id is attached to `res.sentry` to be returned
+    // and optionally displayed to the user for support.
+    res.statusCode = 500;
+    res.end(res.sentry + '\n');
+});
+
+app.listen(3000);
+```
+<!-- ENDWIZARD -->
+
+## Koa
+
+<!-- WIZARD -->
+```javascript
+var koa = require('koa');
+var Raven = require('raven');
+
+var app = koa();
+Raven.config('___PUBLIC_DSN___').install();
+
+app.on('error', function (err) {
+    Raven.captureException(err, function (err, eventId) {
+        console.log('Reported error ' + eventId);
+    });
+});
+
+app.listen(3000);
+```
+<!-- ENDWIZARD -->
+
+## Loopback
+
+If you’re using Loopback 2.x LTS, make sure you’ve migrated to [strong-error-handler](https://loopback.io/doc/en/lb2/Using-strong-error-handler.html), otherwise no errors will get to `raven-node`.
+
+Configure `raven-node` as early as possible:
+
+```javascript
+// server/server.js
+
+const Raven = require('raven');
+Raven.config('__DSN__').install();
+```
+
+Add `Raven.errorHandler` as a Loopback middleware:
+
+```json
+// server/middleware.json
+
+"final:after": {
+  "raven#errorHandler": {},
+  "strong-error-handler": {
+    "debug": false,
+    "log": false
+  }
+}
+```
+
+## Sails
+
+```javascript
+// config/http.js
+
+var Raven = require('raven');
+Raven.config('__DSN__').install();
+
+module.exports.http = {
+  middleware: {
+    // Raven's handlers has to be added as a keys to http.middleware config object
+    requestHandler: Raven.requestHandler(),
+    errorHandler: Raven.errorHandler(),
+
+    // And they have to be added in a correct order to middlewares list
+    order: [
+      // The request handler must be the very first one
+      'requestHandler',
+      // ...more middlewares
+      'router',
+      // The error handler must be after router, but before any other error middleware
+      'errorHandler',
+      /// ...remaining middlewares
+    ]
+  }
+}
+```