Release v4.0.0

docs/upgrade-guides/3-8-0-to-3-8-1.md

@@ -3,4 +3,4 @@
 No special instructions are necessary to upgrade to `v3.8.1`.
 
 ## Patch release
-This is a patch release to fix a known issues in version `3.8.0`. If you are using Actions in `3.8.0`, you should upgrade to this version or later to avoid potential issues with user permissions in Actions.
+This is a patch release to fix a known issue in version `3.8.0`. If you are using Actions in `3.8.0`, you should upgrade to this version or later to avoid potential issues with user permissions in Actions.

docs/upgrade-guides/3-8-1-to-4-0-0.md

@@ -0,0 +1,27 @@
+# 3.8.1 to PlanDev v4.0.0
+
+## Aerie renamed to PlanDev/SeqDev
+
+This product was formerly known as Aerie and is now named **PlanDev & SeqDev.** While we've updated most documentation and external references, some legacy mentions of the old product name may remain as we complete the transition.
+
+What to know:
+
+* The planning product, including modeling, simulation, scheduling and constraint-checking, is now named **PlanDev**.
+* The sequencing product, including the sequence editor, workspaces, and actions, is now named **SeqDev**.
+* All features and functionality remain the same.
+* As of v4.0.0, repository names, package names and other internal code references will retain their existing names, and deployment/migration procedures have not changed.
+* In a future release, repository and/or package names may change. If so, this will be communicated to users via release notes and normal communication channels. Latest updates can be found on [the "Rename" page](/overview/aerie-renamed-to-plandev/) in the docs.
+
+You are already on our new docs page, which is https://nasa-ammos.github.io/plandev-docs/. Links to pages in the old Aerie docs will be redirected to their new PlanDev equivalent, but it is a good idea to update any links in your documents when possible.
+
+## v4.0 Release
+
+PlanDev v4.0.0 is a "major release" in name only, and does n**ot require any migrations or special upgrade instructions**.
+
+## Sort Order Changes
+
+This release contains a few changes to the default **sorting order** of items in lists. These are not usually breaking changes, but may be unexpected if your process relies on the existing ordering.
+
+* On the Models page, models are now listed in reverse ID order, ie. most recent first. ([#1364](https://github.com/NASA-AMMOS/aerie-ui/issues/1364))
+* For [procedural scheduling goals and constraints](https://nasa-ammos.github.io/plandev-docs/scheduling-and-constraints/procedural/introduction/), their parameters now appear in the order they are written in the procedural code. ([#1738](https://github.com/NASA-AMMOS/aerie/pull/1738))
+* Command expansion rules in the "New Expansion Set" table are now sorted by rule ID. ([#1823](https://github.com/NASA-AMMOS/aerie-ui/issues/1823))

sidebars.js

@@ -517,6 +517,7 @@ const sidebars = {
     },
   ],
   upgradeGuides: [
+    'upgrade-guides/3-8-1-to-4-0-0',
     'upgrade-guides/3-8-0-to-3-8-1',
     'upgrade-guides/3-7-1-to-3-8-0',
     'upgrade-guides/3-7-0-to-3-7-1',