Add Backbone, Ember, and React configuration

Author: dcramer

docs/index.rst

@@ -22,12 +22,11 @@ Installation
 
 Raven.js is distributed in a few different methods, and should get
 included after any other libraries are included, but before your own
-scripts.  For all details see :doc:`install`.  For just getting started,
-you can use our CDN:
+scripts.  For all details see :doc:`install`.
 
 .. sourcecode:: html
 
-    <script src="https://cdn.ravenjs.com/1.1.22/raven.min.js"></script>
+    <script src="https://cdn.ravenjs.com/1.1.22/jquery,native/raven.min.js
 
 Configuring the Project
 -----------------------
@@ -115,9 +114,9 @@ is additional documentation available that covers all the rest:
    :titlesonly:
 
    install
-   plugins
    config
    usage
+   integrations
    sourcemaps
    tips
 

docs/install.rst

@@ -28,7 +28,7 @@ Our CDN distributes builds with and without :doc:`plugins <plugins>`.
 
 .. sourcecode:: html
 
-    <script src="https://cdn.ravenjs.com/1.1.22/raven.min.js"></script>
+    <script src="https://cdn.ravenjs.com/1.1.22/jquery,native/raven.min.js
 
 **We highly recommend trying out a plugin or two since it'll greatly
 improve the chances that we can collect good information.**

docs/integrations/backbone.rst

@@ -0,0 +1,24 @@
+Backbone
+--------
+
+Installation
+============
+
+Start by adding the ``raven.js`` script tag to our page. You'll want to position it
+after you load all other external libraries (like jQuery), but before your code.
+
+.. sourcecode:: html
+
+    <script src="https://cdn.ravenjs.com/1.1.22/backbone,jquery,native/raven.min.js
+
+Configuring the Client
+----------------------
+
+Now need to set up Raven.js to use your Sentry DSN:
+
+.. code-block:: javascript
+
+    Raven.config('___PUBLIC_DSN___').install()
+
+At this point, Raven is ready to capture any uncaught exception via standard hooks
+in addition to Backbone specific hooks.

docs/integrations/ember.rst

@@ -0,0 +1,24 @@
+Ember
+-----
+
+Installation
+============
+
+Start by adding the ``raven.js`` script tag to our page. You'll want to position it
+after you load all other external libraries (like jQuery), but before your code.
+
+.. sourcecode:: html
+
+    <script src="https://cdn.ravenjs.com/1.1.22/ember,jquery,native/raven.min.js
+
+Configuring the Client
+----------------------
+
+Now need to set up Raven.js to use your Sentry DSN:
+
+.. code-block:: javascript
+
+    Raven.config('___PUBLIC_DSN___').install()
+
+At this point, Raven is ready to capture any uncaught exception via standard hooks
+in addition to Ember's ``onError`` handlers.

docs/plugins.rst renamed to docs/integrations/index.rst

@@ -1,8 +1,8 @@
-Plugins
-=======
+Integrations
+============
 
-Plugins extend the functionality of Raven.js to cover common libraries and
-environments automatically.
+Integrations extend the functionality of Raven.js to cover common libraries and
+environments automatically using simple plugins.
 
 What are plugins?
 ~~~~~~~~~~~~~~~~~
@@ -24,8 +24,9 @@ information, so it's important that we inject code and wrap things
 magically so we can extract what we need. See :doc:`usage` for tips
 regarding that.
 
+.. toctree::
+   :maxdepth: 1
 
-All Plugins
-~~~~~~~~~~~
-* https://github.com/getsentry/raven-js/tree/master/plugins
-* `Download <http://ravenjs.com>`_
+   backbone
+   ember
+   react

docs/integrations/react.rst

@@ -0,0 +1,53 @@
+React
+--------
+
+Installation
+============
+
+Start by adding the ``raven.js`` script tag to our page. You'll want to position it
+after you load all other external libraries (like jQuery), but before your code.
+
+.. sourcecode:: html
+
+    <script src="https://cdn.ravenjs.com/1.1.22/jquery,native/raven.min.js
+
+Configuring the Client
+----------------------
+
+Now need to set up Raven.js to use your Sentry DSN:
+
+.. code-block:: javascript
+
+    Raven.config('___PUBLIC_DSN___').install()
+
+At this point, Raven is ready to capture any uncaught exception.
+
+Expanded Usage
+--------------
+
+It's likely you'll end up in situations where you want to gracefully
+handle errors. A good pattern for this would be to setup a logError helper:
+
+.. code-block:: javascript
+
+    function logException(ex, context) {
+      Raven.captureException(ex, {
+        extra: context
+      });
+      /*eslint no-console:0*/
+      window.console && console.error && console.error(ex);
+    }
+
+Now in your components (or anywhere else), you can fail gracefully:
+
+.. code-block:: javascript
+
+    var Component = React.createClass({
+        render() {
+            try {
+                // ..
+            } catch (ex) {
+                logException(ex);
+            }
+        }
+    });

docs/sentry-doc-config.json

@@ -9,6 +9,33 @@
         "index#configuring-the-client",
         "index#reporting-errors"
       ]
+    },
+    "backbone": {
+      "name": "Backbone",
+      "type": "framework",
+      "doc_link": "integrations/backbone/",
+      "wizard": [
+        "integrations/backbone#installation",
+        "integrations/backbone#configuring-the-client"
+      ]
+    },
+    "ember": {
+      "name": "Ember",
+      "type": "framework",
+      "doc_link": "integrations/ember/",
+      "wizard": [
+        "integrations/ember#installation",
+        "integrations/ember#configuring-the-client"
+      ]
+    },
+    "react": {
+      "name": "React",
+      "type": "framework",
+      "doc_link": "integrations/react/",
+      "wizard": [
+        "integrations/react#installation",
+        "integrations/react#configuring-the-client"
+      ]
     }
   }
 }