@dotcms/angular 26.8.7-1 → 26.8.10-1-next.2504

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +26 -4
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -37,11 +37,33 @@ The `@dotcms/angular` SDK is the official dotCMS Angular library. It empowers An
37
37
 
38
38
  ### Get a dotCMS Environment
39
39
 
40
- #### Version Compatibility
40
+ #### Which SDK Version Should I Use?
41
41
 
42
- - **Recommended**: dotCMS Evergreen
43
- - **Minimum**: dotCMS v25.05
44
- - **Best Experience**: Latest Evergreen release
42
+ dotCMS SDKs are published in lockstep with dotCMS itself: every `@dotcms/*` package ships
43
+ at the **exact same version number** as the dotCMS release it was built for (e.g. dotCMS
44
+ `26.7.14-1` `@dotcms/client@26.7.14-1`, `@dotcms/react@26.7.14-1`, and so on).
45
+
46
+ **Simple rule of thumb: use the SDK version that matches your dotCMS instance's version.**
47
+
48
+ You don't have to upgrade the SDK every time dotCMS releases a new version (or vice versa).
49
+ Most releases don't change anything the SDKs rely on, so an older SDK usually keeps working
50
+ fine against a newer dotCMS instance. Occasionally, though, a release does include a real
51
+ breaking change — and if your SDK is older than that point, it will stop working correctly.
52
+
53
+ You don't need to track this yourself: your dotCMS instance always knows the oldest SDK
54
+ version it still supports, and the SDK checks itself against it automatically. If you're
55
+ using an SDK that's too old, you'll see a clear warning in your console telling you to
56
+ upgrade.
57
+
58
+ **Recommendation:** pin your SDKs to the same version as your dotCMS instance, and only bump
59
+ them when you upgrade dotCMS — or when the console tells you to.
60
+
61
+ > **On an LTS release?** LTS releases don't currently get their own matching SDK version.
62
+ > Until that's addressed, use the SDK version published for the closest regular release at
63
+ > or before your LTS version.
64
+ >
65
+ > Want more background on how dotCMS releases and support windows work? See
66
+ > [Release & Support Lifecycle](https://dev.dotcms.com/docs/release-support-lifecycle).
45
67
 
46
68
  #### Environment Setup
47
69
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dotcms/angular",
3
- "version": "26.08.07-01",
3
+ "version": "26.8.10-1-next.2504",
4
4
  "peerDependencies": {
5
5
  "rxjs": ">=7.0.0",
6
6
  "@angular/common": ">=17.0.0",
@@ -9,8 +9,8 @@
9
9
  },
10
10
  "dependencies": {
11
11
  "@tinymce/tinymce-angular": "9.0.0",
12
- "@dotcms/client": "26.08.07-01",
13
- "@dotcms/uve": "26.08.07-01",
12
+ "@dotcms/client": "26.8.10-1-next.2504",
13
+ "@dotcms/uve": "26.8.10-1-next.2504",
14
14
  "tslib": "^2.3.0"
15
15
  },
16
16
  "description": "Official Angular Components library to render a dotCMS page.",