Cleanup and Grammar

Author: kum-deepak

_config.yml

@@ -87,9 +87,6 @@ footer:
     - label: 'rx-stomp'
       icon: 'fab fa-fw fa-github'
       url: 'https://github.com/stomp-js/rx-stomp'
-    - label: 'ng2-stompjs'
-      icon: 'fab fa-fw fa-github'
-      url: 'https://github.com/stomp-js/ng2-stompjs'
 
 # Reading Files
 encoding: 'utf-8'

_posts/2018-06-28-pollyfils-for-stompjs-v5.md

@@ -0,0 +1,76 @@
+---
+layout: single
+title: 'StompJs v5+, RxStomp: Polyfills'
+date: 2018-06-29 07:59:22 +0530
+categories: guide stompjs rx-stomp
+toc: true
+redirect_from:
+- /guide/stompjs/rx-stomp/ng2-stompjs/2018/06/28/pollyfils-for-stompjs-v5.html
+- /guide/stompjs/rx-stomp/ng2-stompjs/2018/06/29/pollyfils-for-stompjs-v5.html
+- /guide/stompjs/rx-stomp/ng2-stompjs/2018/06/30/pollyfils-for-stompjs-v5.html
+- /guide/stompjs/rx-stomp/ng2-stompjs/pollyfils-for-stompjs-v5.html
+---
+
+This guide covers critical dependencies and polyfills for version 5+ of `@stomp/stompjs`;
+which is internally used by `@stomp/rx-stomp` as well.
+
+## In NodeJS
+
+### WebSocket
+
+There are two alternate libraries `websocket` and `ws` which have been reported to work.
+
+#### websocket
+
+- Add `websocket` npm module:
+
+  ```bash
+  $ npm install websocket
+  ```
+
+- Using `import` syntax
+
+  ```javascript
+  import websocket from 'websocket';
+  
+  Object.assign(global, { WebSocket: websocket.w3cwebsocket });
+  ```
+
+#### ws
+
+- Instead of `websocket` lib `ws` has also been reported to work.
+  See: [stompjs/issues/28](https://github.com/stomp-js/stompjs/issues/28).
+- Add `ws` npm module:
+
+  ```bash
+  $ npm install ws
+  ```
+
+- Require the module and expose it through `global`
+
+  ```javascript
+  import { WebSocket } from 'ws';
+  
+  Object.assign(global, { WebSocket });
+  ```
+
+## In React Native
+
+### TextEncoder/TextDecoder
+
+- React Native makes it deceptive.
+  When an application is executed in debug mode, it works, as it is executed on an actual browser
+  where TextEncoder/TextDecoder is available.
+  However, when executed in production mode, it fails as TextEncoder/TextDecoder is not available.
+- Please install `text-encoding`
+  ```bash
+  $ npm install text-encoding
+  ```
+- Add the following to your `index.js` or `App.js`:
+
+  ```javascript
+  import * as encoding from 'text-encoding';
+  ```
+
+- There are additional issues with React Native in some device/version combinations. Please see:
+  [React Native - Additional Notes](/workaround/stompjs/rx-stomp/ng2-stompjs/react-native-additional-notes.html)

_posts/2018-06-28-polyfills-for-stompjs.md

@@ -22,7 +22,7 @@ This npm distribution has a UMD package and ES6 modules. The web browsers will u
 
 ### Polyfills
 
-_Important: before using, please check [Polyfills & Critical Dependencies]._
+_Important: For NodeJS and React Native, please check [Polyfills]._
 
 ### In Web Browser
 
@@ -391,5 +391,5 @@ The above also allows adjusting [Client#reconnectDelay](/api-docs/latest/classes
 
 Even [Client#brokerURL](/api-docs/latest/classes/Client.html#brokerURL) or [Client#connectHeaders](/api-docs/latest/classes/Client.html#connectHeaders) can be altered which would get used in a subsequent reconnect.
 
-[Polyfills & Critical Dependencies]: {% link _posts/2018-06-28-pollyfils-for-stompjs-v5.md %}
+[Polyfills]: {% link _posts/2018-06-28-polyfills-for-stompjs.md %}
 [Uint8Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array

_posts/2018-06-29-using-stompjs-v5.md

@@ -12,7 +12,7 @@ redirect_from:
 
 ## Upgrading from version 3/4
 
-_Important: before upgrading please check [Polyfills & Critical Dependencies]._
+_Important: For NodeJS and React Native, please check [Polyfills]._
 
 ### Basic changes
 
@@ -197,4 +197,4 @@ Additional notes:
 - If you are using `SockJS` please also see [SockJS support]
 
 [SockJS support]: {% link _posts/2018-09-10-using-stomp-with-sockjs.md %}
-[Polyfills & Critical Dependencies]: {% link _posts/2018-06-28-pollyfils-for-stompjs-v5.md %}
+[Polyfills]: {% link _posts/2018-06-28-polyfills-for-stompjs.md %}

_posts/2018-09-08-upgrading-stompjs.md

@@ -2,14 +2,20 @@
 layout: single
 title: 'Using STOMP with SockJS'
 date: 2018-09-10 12:06:34 +0530
-categories: guide stompjs rx-stomp ng2-stompjs
+categories: guide stompjs rx-stomp
 toc: true
 redirect_from:
   - /guide/stompjs/rx-stomp/ng2-stompjs/2018/09/09/using-stomp-with-sockjs.html
   - /guide/stompjs/rx-stomp/ng2-stompjs/2018/09/10/using-stomp-with-sockjs.html
   - /guide/stompjs/rx-stomp/ng2-stompjs/2018/09/11/using-stomp-with-sockjs.html
+  - /guide/stompjs/rx-stomp/ng2-stompjs/using-stomp-with-sockjs.html
 ---
 
+**There are a large number of obsolete (and copied from one another)
+examples for these libraries that use SockJS.
+In reality, there is very little chance that you need SockJS.
+Unless you know, for sure, you do not need SockJS.**
+
 This guide covers how to use [SockJS client] instead of WebSockets as underlying transport.
 
 **For Spring STOMP users:**
@@ -18,19 +24,18 @@ That is incorrect, you only need SockJS if you need to support old browsers._
 
 ## Do you need SockJS?
 
-As of 2018, WebSocket support in browsers is nearly ubiquitous.
+As of 2018, WebSocket support in browsers is ubiquitous.
 Please check [https://caniuse.com/#feat=websockets](https://caniuse.com/#feat=websockets).
-Depending on your user base you can skip this page.
+Depending on your user base, you can skip this page.
 
-You can use [SockJS client]
-to support browsers that do not natively support WebSockets.
+You can use [SockJS client] to support browsers that do not support WebSockets natively.
 
 You would need to consider the following:
 
 - URL protocol conventions are different for WebSockets (`ws:`/`wss:`) and SockJS (`http:` or `https:`).
-- Internal handshake sequences are different - so, some brokers will use different end points for
+- Internal handshake sequences are different — so, some brokers will use different end points for
   both protocols.
-- Neither of these allow custom headers to be set during the HTTP handshake.
+- Neither of these allows custom headers to be set during the HTTP handshake.
 - SockJS internally supports different transport mechanisms. You might face specific limitations
   depending on actual transport in use.
 - Auto reconnect is not quite reliable with SockJS.
@@ -44,7 +49,7 @@ It is advised to use WebSockets by default and then fall back to SockJS if the b
 
 ### In Node.js environments
 
-Please install latest [SockJS client]:
+Please install the latest[SockJS client]:
 
 ```bash
 $ npm install sockjs-client --save
@@ -145,7 +150,7 @@ See: [ng2-stompjs/issues/70].
 When you are using SockJS in an Angular6 project you might get **"global is not defined"**.
 
 The underlying issue can only be fixed by SockJS or Angular teams.
-Try any of the following as a possible work around (from [ng2-stompjs/issues/70]):
+Try any of the following workarounds (from [ng2-stompjs/issues/70]):
 
 - In your index.html file, in the header add the following: