Deprecate ng2-stompjs

Author: kum-deepak

_faqs/general-i-am-using-angular-which-of-stompjs-rx-stomp-or-ng2-stompjs-should-i-use.md

@@ -1,15 +1,12 @@
 ---
-question: 'I am using Angular, which of stompjs, rx-stomp, or ng2-stompjs should I use?'
+question: 'I am using Angular. Which of stompjs or rx-stomp should I use?'
 group: General
 priority: ACE
 ---
 
-Angular makes heavy use of [RxJS](https://github.com/ReactiveX/RxJS),
-Using `rx-stomp` or `ng2-stompjs` should feel natural with Angular.
+Angular makes heavy use of [RxJS](https://github.com/ReactiveX/RxJS). So using `rx-stomp` should feel natural with Angular.
 
-If you are going to use [Angular Dependency Injection](https://angular.io/guide/dependency-injection),
-`ng2-stompjs` would be the way to go.
-`ng2-stompjs` makes `rx-stomp` classes Injectable and sets up some factories.
+There is a tutorial for using `rx-stomp` with Angular. Please see [guides](/#getting-started).
 
-Having said all of these, you can actually use any of the variants.
+Having said all of these, you can use any of the variants.
 Developers have reported successfully using `stompjs` directly with Angular.

_faqs/general-tree-shaking.md

@@ -6,9 +6,8 @@ priority: ADM
 
 Yes.
 
-The versions - `stomp-js@6`, `rx-stomp@1`, `ng2-stompjs@8` - are targeted to
-`es2015`. This ensures smaller code size.
-The code follows guidelines that should allow proper tree shaking behavior.
+The versions, `stomp-js@6+` and `rx-stomp@1+` are distributed as `es2015` UMD and modules. These lead to small code size and proper tree shaking behavior.
 
-`rx-stomp`, prior to v1, was distributed as `commonjs` modules, which
-may not be tree shaking friendly. Please upgrade if you face issues.
+`rx-stomp`, before v1, was distributed as `commonjs` modules, which may not be tree shaking friendly. Please upgrade if you face issues.
+
+`ng2-stompjs` is likely to cause issues with newer Angular versions. So, please migrate to `rx-stomp`.

_faqs/general-what-documentation-is-available.md

@@ -6,6 +6,5 @@ priority: AAC
 
 - Comprehensive [API documentation](/api-docs/latest/).
 - Several [guides](/).
-- [Samples](https://github.com/stomp-js/samples/) for `@stomp/stompjs`.
-- [Sample](https://github.com/stomp-js/ng2-stompjs-angular7) for `@stompjs/rx-stomp`
-  and `@stomp/ng2-stompjs`.
+- [Samples](https://github.com/stomp-js/samples/) for `@stomp/stompjs` and `@stompjs/rx-stomp`.
+- [Sample](https://github.com/stomp-js/rx-stomp-angular) for using `@stompjs/rx-stomp` with Angular.

_faqs/general-which-one-i-should-use-stompjs-rx-stomp-or-ng2-stompjs.md

@@ -1,15 +1,13 @@
 ---
-question: 'Which one I should use - stompjs, rx-stomp, or ng2-stompjs?'
+question: 'Which one should I use - stompjs or rx-stomp?'
 group: General
 priority: ACA
 ---
 
-`stompjs` is the core underlying library, usable almost everywhere.
+`stompjs` is the underlying core library, usable almost everywhere.
 
-`rx-stomp` exposes functionality as [RxJS](https://github.com/ReactiveX/RxJS) primitives.
-If you are already using RxJS in your project or familiar with it,
-please consider using `rx-stomp`.
+`rx-stomp` exposes functionality as [RxJS] primitives. If you are already using RxJS in your project or are familiar with it, please consider using `rx-stomp`.
 
-`ng2-stompjs` offers same functionally as `rx-stomp`.
-`ng2-stompjs` makes `rx-stomp` classes Injectable and sets up some factories.
-If you are using Angular you should consider this variant.
+Since Angular relies heavily on [RxJS], you should consider `rx-stomp` with Angular.
+
+[RxJS]: https://github.com/ReactiveX/RxJS

index.md

@@ -5,49 +5,42 @@ title: 'StompJs Family'
 author_profile: true
 ---
 
-These libraries provide [STOMP] over
-[Websocket] connectivity for web-browsers or any other Javascript based
-environments.
+These libraries provide [STOMP] over [Websocket] connectivity for web browsers or other Javascript-based environments.
 
-[stompjs] is the core Javascript library.
-[rx-stomp] is a wrapper that exposes functionality as [RxJS] primitives.
-If you are already using RxJS in your project or familiar with it,
-check out [rx-stomp].
-[ng2-stompjs] makes [rx-stomp] classes Injectable and sets up some factories
-suitable to be used by Angular (2+).
+[stompjs] is the core Javascript library. [rx-stomp] is a wrapper that exposes functionality as [RxJS] primitives. If you are already using RxJS in your project or are familiar with it, check out [rx-stomp].
 
 ## Getting started
 
 Please try the following guides:
 
-- [Using StompJS] - a step by step guide.
+- [Using StompJS] - a step-by-step guide.
 - [Using rx-stomp with Angular] - Preferred, originally written for Angular13,
-  should work with Angular 8+.
+  should work with Angular 7+.
 - [Using ng2-stompjs with Angular] - Deprecated, originally written for Angular7,
   last tested with Angular 9.
-  Many concepts apply to [rx-stomp] as well.
 - Guide to [Connection status in ng2-stompjs].
 
 Samples:
 
 - [Samples](https://github.com/stomp-js/samples/) for [stompjs] and [rx-stomp].
-- [Sample](https://github.com/stomp-js/ng2-stompjs-angular7) for [ng2-stompjs] and [rx-stomp].
+- [Sample](https://github.com/stomp-js/rx-stomp-angular) for [rx-stomp] with Angular 7+.
 
 [API documentation](/api-docs/latest/) for NPM released versions.
 
 ## Upgrading
 
+- [Migrate ng2-stompjs to rx-stomp] - migrate Angular projects to use [rx-stomp].
 - [Upgrading to stompjs@6, rx-stomp@1, ng2-stompjs@8] - update from
   stompjs@v5, [email protected], ng2-stompjs@7.
 - [Upgrading StompJS] to update to stompjs@v5 from any of the older versions.
 - [Upgrading to ng2-stompjs@7] for any of the older versions.
 
 ## Other topics
 
-- Read the [FAQs], these cover quite varied topics.
+- Read the [FAQs]. These cover varied topics.
 - List of [Pollyfills] - you may need for some environments.
 - Set of additional notes for using these libraries with [SockJS].
-- One of my favourites, but not widely used, special support for
+- One of my favorites, but not widely used, exceptional support for
   [Remote Procedure Calls].
 - An article devoted to specific issues posed by [React Native].
 
@@ -70,3 +63,4 @@ Samples:
 [FAQs]: {% link _posts/2019-05-20-faqs.html %}
 [React Native]: {% link _posts/2019-06-10-react-native-additional-notes.md %}
 [Upgrading to stompjs@6, rx-stomp@1, ng2-stompjs@8]: {% link _posts/2020-10-21-upgrading-to-stompjs-6-rx-stomp-1.md %}
+[Migrate ng2-stompjs to rx-stomp]: {% link _posts/2022-03-03-ng2-stompjs-to-rx-stomp.md %}