Skip to content

Commit b0739f7

Browse files
committed
expand lts with upgrade decision guidelines
1 parent 3a71901 commit b0739f7

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

src/lts/index.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,22 @@ Vue 3 contains breaking changes that make it incompatible with Vue 2, so migrati
1616

1717
Despite the breaking changes, the majority of Vue APIs are shared between the two major versions, so most of your team's Vue 2 knowledge will continue to work in Vue 3. In the long run, we also intend to avoid major breaking upgrades like the one between Vue 2 and Vue 3. Compatibility and ecosystem stability will be our topmost priority for future releases, and new features will be introduced in a way that does not require major migrations.
1818

19+
20+
### Upgrade or not to Upgrade
21+
22+
Whether you should upgrade to Vue 3 highly depends on specific project details. Some general guidelines:
23+
24+
1. Understand what you will gain from upgrading.
25+
26+
Due to 2.7, the DX gap between the two major versions are no longer that prominent - the main benefit of upgrading will be more refined TypeScript support, better performance, and access to the Vue 3 ecosystem and future new features.
27+
28+
Ask your team these questions: is the app stable and working well? Does the app expect continued new feature development into the future? Is there a pain-point / bottleneck that can only be solved by upgrading? If the app is stable and isn't experiencing major pain-point caused by Vue 2, then upgrading may not be worthwhile.
29+
30+
2. Understand the cost of upgrading.
31+
32+
Does the app rely on 3rd party dependencies that are hard to be made Vue 3 compatible? Does the app rely heavily on changed behavior between Vue 2 and Vue 3? Can the team allocate dedicated time for upgrading? Spend some initial research time to gauge these aspects and come up with an estimation, then compare that to the expected gain from (1). We will not be able to provide a precise formula, but hopefully this can help with the decision process.
33+
34+
1935
### Stay on Vue 2
2036

2137
Some teams may not be able to upgrade to Vue 3 by this timeline due to limited bandwidth, budget, risk tolerance, or reliance on Vue-3-incompatible dependencies. We totally understand this, and want to ensure that staying on Vue 2 beyond EOL is a viable option.
@@ -34,7 +50,7 @@ For some teams, the main concern lies in security, compliance, and browser compa
3450

3551
- You won't receive security fixes from EOL software. For the record, Vue 2 hasn't really had any real vulnerabilities in the past, but you may need a supported version to fullfil regulations or company policies.
3652

37-
- If you are shipping your application to customers with SLAs. You *will* want to avoid including EOL software in your stack.
53+
- If you are shipping your application to customers with SLAs. You _will_ want to avoid including EOL software in your stack.
3854

3955
- Browsers sometimes ship changes that break legacy libraries. This is extremely rare, but could happen in theory.
4056

0 commit comments

Comments
 (0)