upgrade notes to upgrade from 2.x directly to 4.x
sido420 opened this issue · comments
Description
Please provide upgrade notes to upgrade from 2.x directly to 4.x
Expected behavior
Upgrade guide from 2.x version to 4.x
Actual behavior
Upgrade notes from 3.x to 4.x are available.
Environment
- Marionette version: 2.4.7
- Backbone version: 1.3
Step 1: https://github.com/marionettejs/backbone.marionette/blob/master/docs/upgrade-v2-v3.md
Step 2: https://github.com/marionettejs/backbone.marionette/blob/master/docs/upgrade-v3-v4.md
On the docs site v2 -> v3 is on the bottom in the left hand column. We probably should make an index or something for the upgrade guide.
I don't know that a guide from v2 straight to v4 would be much different than a combination of both.
Is there an article somewhere explaining why 4.x is better than 2.x ie. performance improvements etc?
I'm not certain about the v2 to v3 perf improvements, but there were some. Around v3.3 we added Marionette to a popular benchmark and it scored one of the lowest scores relative to other frameworks. Which was not great considering v3.3 included perf improvements from v3.0.
With the introduction of additional renderers and an upgraded collectionview we were able to score better than most other popular frameworks And we also included a 2nd benchmark using underscore templates and jquery but with the updated view/collectionview code (so whatever mn comes with out-of-the-box) and that performs significantly faster than < v3.4 and beats modern ember.
Most of this info is detailed here https://medium.com/blog-marionettejs/marionette-js-v4-getting-started-with-the-new-version-4e5d88cea975 but relates to the v3 -> v4 update. v3 was released 2 years ago so we don't reference v2 that often. Also I might be the only core contributor on the project that contributed to v2 code, and even then, just barely. I started pretty much when v3 changes were actively being made. However if any specific questions come up, pop into gitter and ask. There's plenty of knowledgeable people in the community willing to help.