diff --git a/docs/dev-guide/changes.md b/docs/dev-guide/changes.md
index 2fba50a94..57057d1cc 100644
--- a/docs/dev-guide/changes.md
+++ b/docs/dev-guide/changes.md
@@ -1,4 +1,4 @@
-# Significant and Breaking Changes
+# Change Log
 
 This document describes significant changes to ActivitySim.  This includes
 major new features that may require modifications to existing model configurations
@@ -209,3 +209,23 @@ the model is run, and can be used to ensure that the input data is correctly
 formatted and complete.
 
 See [PR #753](https://github.com/ActivitySim/activitysim/pull/753) for code updates.
+
+### Removal of orca dependency
+
+This new version of ActivitySim does not use `orca` as a dependency, and thus does
+not rely on orca’s global state to manage data. Instead, a new [`State`](activitysim.core.workflow.State)
+class is introduced, which encapsulates the current state of a simulation including
+all data tables. This is a significant change “under the hood”, which may be
+particularly consequential for model that use “extensions” to the ActivitySim framework.
+See [PR #654](https://github.com/ActivitySim/activitysim/pull/654) for code updates.
+
+## v1.2
+
+The [v1.2](https://github.com/ActivitySim/activitysim/releases/tag/v1.2.0) release
+includes all updates and enhancements complete in the ActivitySim Consortium's Phase 7
+development cycle, including:
+
+- Sharrow performance enhancement
+- Explicit school escorting
+- Disaggregate accessibility
+- Simulation-based shadow pricing
diff --git a/docs/dev-guide/index.rst b/docs/dev-guide/index.rst
index 1f6400abc..da6c64973 100644
--- a/docs/dev-guide/index.rst
+++ b/docs/dev-guide/index.rst
@@ -35,3 +35,4 @@ Contents
    ../core
    ../benchmarking
    build-docs
+   changes